访谈式计划
通过苏格拉底式访谈将模糊需求转化为清晰的工程规格,然后调用 Plan 模式生成可执行的实施计划。
头脑风暴集成
读取 resources/BRAINSTORMING_INTEGRATION.md 了解头脑风暴协议。若用户说"跳过头脑风暴"或"skip brainstorming",则跳过步骤 3、7、8 中标记为 [可选] 的分支。
步骤
准备阶段
- 确认输入源:若
$ARGUMENTS为空,提示用户提供需求文档路径(默认查找plan.md)。若文件不存在,报错退出。 - 分析需求文档:读取目标文件,分析核心业务目标、方案完整度、模糊/矛盾/缺失点及潜在风险。
- [可选] 范围分解检查:若检测到 3+ 独立子系统或需求文档超 500 行,按头脑风暴协议提议拆分。
访谈阶段
- 加载访谈原则:读取
resources/INTERVIEW_PRINCIPLES.md,按其提问原则进行苏格拉底式访谈。 - 按维度框架提问:读取
resources/INTERVIEW_DIMENSIONS.md,按 A-G 维度框架逐项向用户提问:
- 必须覆盖 A(工程原则审查),其余按项目类型选择性覆盖。 - 必须使用 AskUserQuestion 工具呈现每轮问题,将 2-3 个收敛性选项映射为可点击的交互式选项卡(options),禁止以纯文本 A/B/C 形式输出。 - 每个 AskUserQuestion 调用包含 1-4 个问题(questions),每个问题 2-4 个选项(options),用户可通过 UI 直接点选。 - 相互独立的问题应合并到同一次 AskUserQuestion 调用中,减少交互轮次。
- [可选·UI 项目] 可视化伴侣提议:若项目涉及 UI/前端开发,按
resources/VISUAL_COMPANION.md提议启用浏览器可视化伴侣。
- 仅在用户明确接受后才启动服务器。 - 默认绑定 127.0.0.1 / localhost;没有明确远程访问需求时,不要放宽监听范围。
收敛阶段
- [可选] 方案提议:维度提问完成后,按头脑风暴协议提出 2-3 种实现方案附权衡分析,通过
AskUserQuestion让用户选择。 - 风险评估:若涉及高风险操作,读取
resources/RISK_PROTECTION.md并发出告警,等待用户明确授权。 - 整理访谈结论:在内部整理访谈结论摘要(业务目标、架构决策、选定方案及被拒方案理由、技术约束、风险评估等)。
输出阶段
- 计划生成(双轨模式): a. 检查系统上下文中的可用技能列表,判断
planning-with-files是否存在。 b. 若 planning-with-files 可用(优先路径):
- 输出提示:📋 检测到 planning-with-files,使用文件计划模式 - 先将访谈结论以 notes.md 模板格式写入工作目录的 notes.md - 调用 Skill(skill="planning-with-files:plan", args="基于访谈结论创建实施计划,访谈结论已写入 notes.md") - task_plan.md 按以下模板结构生成: # Implementation Plan ## Goal <从访谈提取的核心业务目标> ## Phases - [] Phase 1: <阶段名> — <关键交付物> - [] Phase 2:... ## Key Questions Resolved | 问题 | 决策 | 理由 | |------|------|------| |... |... |... | ## Decisions Made - **选定方案**: <方案名> — <一句话理由> - **被拒方案**: <方案名> — <为什么不选> ## Risks - [] <风险描述> → 缓解措施: <措施> ## Status - 当前阶段: Phase 1 - 创建时间: YYYY-MM-DD - 完成后告知用户计划文件位置,流程结束 c. 若 planning-with-files 不可用(降级路径): - 输出提示:📋 planning-with-files 不可用,使用平台原生 Plan 模式 - 调用 EnterPlanMode 进入原生 Plan 模式 - 在计划文件中写入访谈结论与实施计划(任务分解、依赖关系、验收标准、风险缓解)
- [仅降级路径] 审批执行:用户审批计划后,调用
ExitPlanMode进入执行阶段。
技术约束
- 路径使用双引号包裹,正斜杠
/分隔 - 优先使用
rg替代grep - 禁止自动执行
commit、push等 Git 写操作 - 遵循 Read-before-Write 原则
- 不生成独立的 spec.md 文件,规格内容融入
task_plan.md(文件模式)或原生 Plan(降级模式) - planning-with-files 模式下,
task_plan.md和notes.md创建在工作目录根路径,不创建子目录