| 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 模式下必须获得用户明确批准后才声称计划完成