Claudebot Gotchas — Development skill for Claude Code
ClaudeBot 開發已知地雷和解法.
How to install Claudebot Gotchas
Installs to ~/.claude/skills/jeffrey0117-claudebot-claudebot-gotchas/SKILL.md
mkdir -p ~/.claude/skills/jeffrey0117-claudebot-claudebot-gotchas && curl -fsSL https://raw.githubusercontent.com/Jeffrey0117/ClaudeBot/HEAD/.claude/skills/claudebot-gotchas.md -o ~/.claude/skills/jeffrey0117-claudebot-claudebot-gotchas/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Claudebot Gotchas does
name: claudebot-gotchas description: ClaudeBot 開發已知地雷和解法。遇到 bug 時先查這裡。
Known Gotchas
1. shell: false (CRITICAL)
**Problem:** `spawn('claude', args, { shell: true })` causes user messages to be truncated or interpreted as shell commands.
**Fix:** Always use `shell: false`. On Windows, resolve the actual `cli.js` path instead.
**Symptom:** Telegram 使用者的訊息被截斷,尤其是包含引號、括號、`&`、`|` 等符號時。
2. Claude CLI stderr is NOT fatal
**Problem:** Claude CLI outputs progress info and warnings
Alternatives in Development
- /report — Generate a submission-ready bug bounty report 1.8k ★
- Src Hunter Skill — 实战 SRC / 众测 / Bug bounty 漏洞挖掘 Claude Code skill — 19 个攻击类 playbook、305 个结构化 payload、263 个 WAF/EDR 绕过、2887 份 Ha 602 ★
- Hawk Debugger — Use the @hawk-debugger agent to investigate and fix the following bug or build error: $ARGUMENTS 523 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Claudebot Add Command
如何新增一個 Telegram bot 指令。固定三步驟:建立 command file → bot.ts 註冊 → help.ts 更新。
Claudebot Add Handler
如何新增 Telegram 訊息處理器(photo、document、sticker 等非 command 類型)。
Fork Pov
Fork pov.md for installer taste, or append a one-liner to gotchas.md after a real agent failure.
Codex Consult
Consult OpenAI Codex (codex exec) for a second opinion on a prompt. Handles the argv-hang, stdin-mode, reasoni
Kuma:Studio
📊 Kuma Studio — Web dashboard for gotchas, flows, workspace matrix, and metrics
Claude Skill Tilda
Claude Code skill for Tilda website builder — internal admin API (Feeds, Posts, Pages, T123, CDN). Python + JS
Related Agents
Memory Keeper
Updates .claude/memory.md with important learnings, fixes, patterns, and gotchas from the current session that
Research Dossier Writer
Creates a PRP-style research dossier for a feature brief, focused on concrete codebase anchors, patterns, gotc
Onboarding Agent
Use this agent to generate a comprehensive new-joiner guide for a repository — covering what the service does,