引擎定位

pinable 是 Go 实现的统一入口，负责把任务转发到后端 CLI（codex / claude / gemini / opencode），并统一处理参数、会话 ID 与输出。

当前命令面

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

核心 flags

参数	说明
--backend	选择后端：codex / claude / gemini / opencode
--model	覆盖模型
--reasoning-effort	设置推理强度（按后端支持情况生效）
--agent	使用 ~/.pinable/models.json 中的 agent
--prompt-file	指定提示词文件
--skills	逗号分隔技能列表
--skip-permissions	跳过权限提示
--dangerously-skip-permissions	--skip-permissions 别名
--worktree	在新 Git worktree 中执行
--parallel	从 stdin 读取并行任务配置
--full-output	并行模式输出完整内容（兼容模式）
--config	指定配置文件
--version / -v	打印版本
--cleanup	执行日志清理

会话续跑

pinable "实现战斗 buff 叠层规则"
pinable resume sess_xxx "继续处理异常路径"

并行执行

并行模式使用任务块格式（---TASK--- + ---CONTENT---）从 stdin 输入：

pinable --parallel < tasks.txt

Worktree 隔离

pinable --worktree "重构商城结算链路"

执行时会创建独立 worktree 和分支，降低主目录污染风险。

说明

本文仅覆盖当前命令面与已落地行为。