bahayonghang/interview-plan

访谈式计划

通过苏格拉底式访谈将模糊需求转化为清晰的工程规格，然后调用 Plan 模式生成可执行的实施计划。

头脑风暴集成

读取 resources/BRAINSTORMING_INTEGRATION.md 了解头脑风暴协议。若用户说"跳过头脑风暴"或"skip brainstorming"，则跳过步骤 3、7、8 中标记为 [可选] 的分支。

步骤

准备阶段

1. 确认输入源：若 $ARGUMENTS 为空，提示用户提供需求文档路径（默认查找 plan.md）。若文件不存在，报错退出。
2. 分析需求文档：读取目标文件，分析核心业务目标、方案完整度、模糊/矛盾/缺失点及潜在风险。
3. [可选] 范围分解检查：若检测到 3+ 独立子系统或需求文档超 500 行，按头脑风暴协议提议拆分。

访谈阶段

4. 加载访谈原则：读取 resources/INTERVIEW_PRINCIPLES.md，按其提问原则进行苏格拉底式访谈。
5. 按维度框架提问：读取 resources/INTERVIEW_DIMENSIONS.md，按 A-G 维度框架逐项向用户提问：
   • 必须覆盖 A（工程原则审查），其余按项目类型选择性覆盖。
   • 必须使用 AskUserQuestion 工具呈现每轮问题，将 2-3 个收敛性选项映射为可点击的交互式选项卡（options），禁止以纯文本 A/B/C 形式输出。
   • 每个 AskUserQuestion 调用包含 1-4 个问题（questions），每个问题 2-4 个选项（options），用户可通过 UI 直接点选。
   • 相互独立的问题应合并到同一次 AskUserQuestion 调用中，减少交互轮次。
6. [可选·UI 项目] 可视化伴侣提议：若项目涉及 UI/前端开发，按 resources/VISUAL_COMPANION.md 提议启用浏览器可视化伴侣。
   • 仅在用户明确接受后才启动服务器。
   • 默认绑定 127.0.0.1 / localhost；没有明确远程访问需求时，不要放宽监听范围。

收敛阶段

7. [可选] 方案提议：维度提问完成后，按头脑风暴协议提出 2-3 种实现方案附权衡分析，通过 AskUserQuestion 让用户选择。
8. 风险评估：若涉及高风险操作，读取 resources/RISK_PROTECTION.md 并发出告警，等待用户明确授权。
9. 整理访谈结论：在内部整理访谈结论摘要（业务目标、架构决策、选定方案及被拒方案理由、技术约束、风险评估等）。

输出阶段

10. 计划生成（双轨模式）： 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 模式

    • 在计划文件中写入访谈结论与实施计划（任务分解、依赖关系、验收标准、风险缓解）

11. [仅降级路径] 审批执行：用户审批计划后，调用 ExitPlanMode 进入执行阶段。

技术约束

• 路径使用双引号包裹，正斜杠 / 分隔
• 优先使用 rg 替代 grep
• 禁止自动执行 commit、push 等 Git 写操作
• 遵循 Read-before-Write 原则
• 不生成独立的 spec.md 文件，规格内容融入 task_plan.md（文件模式）或原生 Plan（降级模式）
• planning-with-files 模式下，task_plan.md 和 notes.md 创建在工作目录根路径，不创建子目录