用途:/plan 用于为当前任务写出计划文件,属于 /task 流程的第 3 步,前置条件是已运行 /orient,且存在 worktree 并由 /orient 识别出任务,否则停止并告知用户。若头脑风暴显示任务只有一句话范围,则说明并跳过。
主要能力:先调用 /brainstorming 围绕任务描述做一轮头脑风暴(仅一轮,只捕获方向,不迭代);然后从仓库根读取 ai-workspace/plans/TEMPLATE.md,按模板全部字段创建 ai-workspace/plans/<branch-slug>.md,包括 Branch、Target、Created、Status、Threat model、Scope ceiling、Task、Steps、Confidence Scaffold、Outcomes & Learnings 等。Steps 为带复选框的具体实施步骤,需显式包含测试步骤;当测试需独立作者时,与实现分列为不同任务,便于 /build 分别派发 test-writer 与 implementer。Scope ceiling 保持模板默认值(400/6 软、800/10 硬),不可更改。Outcomes & Learnings 留空,由 /archive 填充。
使用方式:完成后必须提交计划文件再交给 /review,因为 /review 针对已提交状态工作;否则会话崩溃或在 /review 前 /clear 会丢失头脑风暴成果。命令为:git -C "$WORKTREE" add ai-workspace/plans/<name>.md 与 git -C "$WORKTREE" commit -m "plan: <name>"。
Target 检测:默认 Target 是当前分支的来源分支,从 reflog 读取,读取不到则回退 main;用户未明确指定 Target 时应使用该方法。威胁模型选择:内部工具、重构、文档、测试、配置用 advisory;认证、密钥、输入校验、CI、钩子、权限用 adversarial;不确定用 adversarial。Confidence Scaffold 对 adversarial 必填,复杂 advisory 推荐。
限制:本技能不审查计划(属 /review,第 4 步),不开始实施,不跳过任何模板字段,未提交计划文件不得进入 /review。输出报告包含计划文件路径、威胁模型、步骤数以及下一步 /review。