| name | issue-plan |
| description | 基于 GitHub Issue 生成实现计划。读取 .issue-flow 上下文，调用 writing-plans 生成可执行计划文件，保存到 .issue-flow/plan-path。支持 manual 和 auto 模式。 |
| argument-hint | |
| disable-model-invocation | false |
| allowed-tools | ["Read","Write","Glob","Grep","AskUserQuestion","Bash(cat *)","Bash(echo *)","Bash(mkdir *)","Bash(date *)","Bash(gh issue view *)","Skill(superpowers:writing-plans)"] |
Issue Plan
基于 .issue-flow/issue.json 和 .issue-flow/research-notes.md 生成实现计划。
执行步骤
1. 前置检查
- 检查当前目录是否存在
.issue-flow/issue.json
- 若不存在，向父目录逐级查找（最多到 git 仓库根目录）
- 若仍未找到，停止并提示："未找到 .issue-flow/issue.json，请先通过
/issue-flow #<编号> 或 issue-pick 初始化上下文"
- 检查
.issue-flow/research-notes.md 是否存在；若不存在，停止并提示："未找到 research notes，请先通过 /issue-flow 执行 research 阶段"
2. 读取 Issue 上下文
读取 .issue-flow/issue.json，提取：
读取 .issue-flow/research-notes.md，提取：
运行 gh issue view <N> --comments，提取：
3. 检测运行模式
检查 .issue-flow/mode：
- 如果存在且内容为
auto → auto 模式
- 否则 → manual 模式（默认）
4. 生成实现计划
调用 superpowers:writing-plans，传入 Issue 内容、research notes 和代码库上下文。
writing-plans 会自动将计划保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md。
5. 记录 plan 路径
获取生成的 plan 文件路径后，使用 Write 写入 .issue-flow/plan-path，文件内容仅包含一行：
<plan-file-path>
6. 模式处理
Manual 模式
- 读取生成的 plan 文件内容
- 向用户展示计划摘要（目标、任务列表、关键文件）
- 使用 AskUserQuestion 询问用户是否批准计划
- 用户批准后，输出 "计划已批准，可通过
/issue-flow 进入实现阶段"
- 若用户要求修改，根据反馈调整 plan 文件，然后重新展示
Auto 模式
- 验证 plan 文件格式正确（包含 checkbox 任务列表）
- 直接输出 "计划已生成并保存到 "
- 不做额外确认，继续执行
7. 输出
- Plan 文件路径
- 任务数量
- 下一步建议（manual 模式下）
规则
- 计划必须基于 Issue 的验收标准，不能偏离目标
- 计划必须显式吸收 research 结论，不能忽略已发现的风险和文件边界
- 若 Issue 信息不足，基于代码库和 Issue 描述合理补充，不猜测
- 文件路径必须精确，不能含糊
.issue-flow/plan-path 使用相对路径或绝对路径均可，但必须指向实际存在的文件- manual 模式下必须获得用户明确批准后才声称计划完成
