1. pinable: command not found

确认可执行文件已安装并在 PATH 中：

which pinable
pinable version

2. unsupported backend

当前支持的后端为：codex、claude、gemini、opencode。

pinable --backend claude "分析战斗系统瓶颈"

3. resume mode requires non-empty session_id

resume 模式必须传有效会话 ID：

pinable resume sess_xxx "继续实现"

4. failed to create worktree / not a git repository

--worktree 需要在 Git 仓库内执行：

git rev-parse --is-inside-work-tree
pinable --worktree "重构活动奖励发放逻辑"

5. --parallel 输入格式错误

--parallel 从 stdin 读取任务块，必须包含 ---TASK--- 和 ---CONTENT--- 分隔符。

pinable --parallel < tasks.txt

6. --skills 未生效

• 确认技能名合法（字母/数字/-/_）
• 确认文件存在：~/.claude/skills/<skill>/SKILL.md
• 超预算（默认 16000 字符）时会截断或跳过

7. 如何看日志

运行失败时，pinable 会在终端输出 Log file: ...。
按该路径直接查看日志即可。

tail -f /path/to/pinable-xxxx.log

8. 当前可用命令面

pinable [flags] <task>
pinable resume <session_id> <task> [workdir]
pinable --parallel < tasks.txt
pinable version
pinable cleanup