quick-plan-execute

快速计划 & 执行 (Quick Plan & Execute)

工作流概述

收到用户需求后，先写计划 → 要求审批 → 审批后按步骤执行，每完成一步在计划文件中打勾，全部完成前不停止。

触发条件

• 用户给出一个需要多步骤实现的任务（功能开发、重构、排查问题等）
• 用户明确要求"先写计划"、"规划一下"、"列个步骤"
• 任务涉及多个文件修改或需要分阶段执行

工作流程

Step 1: 编写计划

1. 在 __dev__/ 目录下创建一个 markdown 计划文件，文件名反映任务内容，例如 __dev__/refactor-auth-plan.md
2. 计划内容应简洁，长度控制在用户需求原文长度的 3 倍以内
3. 计划格式：

# 计划: [任务标题]

## 步骤

- [ ] Step 1: [简要描述]
- [ ] Step 2: [简要描述]
- [ ] Step 3: [简要描述]
...

4. 步骤应足够具体，让执行时无需反复决策；但不必过于细致，每个步骤对应一次可验证的改动

Step 2: 请求审批

1. 使用 vscode_askQuestions 工具向用户展示计划
2. 问题格式：

{
  "questions": [{
    "header": "approve-plan",
    "question": "以上计划是否批准执行?",
    "options": [
      { "label": "批准，开始执行" },
      { "label": "需要修改计划" }
    ]
  }]
}

3. 在 question 字段或 message 字段中附上计划文件的路径和步骤概览
4. 如果用户选择"需要修改计划"，根据反馈更新计划文件，然后再次请求审批

Step 3: 按步骤执行

1. 审批通过后，开始执行第一个未打勾的步骤
2. 每完成一个步骤，立即编辑计划文件，将该步骤的 [ ] 改为 [x]
3. 不要同时执行多个步骤，一步一步来
4. 如果执行中遇到问题需要调整方案，更新计划文件中的步骤描述，然后继续

Step 4: 完成

1. 所有步骤都打勾后，向用户总结完成情况
2. 总结应包括：完成了什么、关键变更、以及任何需要注意的事项

约束条件

• 计划文件必须写在 __dev__/ 目录下
• 计划长度 ≤ 用户需求长度的 3 倍
• 每个步骤完成后立即更新文件中的勾选框
• 在所有步骤打勾之前，不得停止工作或宣告完成
• 如需修改计划，更新文件后必须再次请求审批