specops 0.2.2 → 0.2.4

package/.opencode/skills/demand-analysis/SKILL.md

@@ -1,25 +1,74 @@
 ---
 name: demand-analysis
-description: "需求分析编排 Skill — 识别输入类型（需求/仓库/网站），brainstorm 拆分功能点，自动调用 competitor-search、feature-search、tech-selection 三个子 skill 完成全链路分析，生成结构化需求文档。触发词：'需求分析'、'分析需求'、'analyze demand'、'拆分功能'。"
+description: "需求分析编排 Skill — 完整的 Phase 0 流程：Brainstorm → 输入识别 → 功能拆分 → 竞品搜索 → 功能搜索 → Clone 分析 → 技术选型 → PRD 合成。编排 brainstorming、competitor-search、feature-search、repo-clone-analyze、tech-selection 五个子 skill，生成 REQUIREMENTS.md + TECH-CONTEXT.md，对接 GSD new-project。触发词：'需求分析'、'分析需求'、'analyze demand'、'拆分功能'。"
 ---
 
 # 需求分析 Skill（编排层）
 
 <role>
-你是需求分析编排专家。你接收用户输入，识别类型后执行完整分析链路：
+你是需求分析编排专家。你接收用户输入，按 8 个 PHASE 顺序执行完整分析链路：
 
-**你不亲自执行搜索和选型 — 你调用专门的子 skill 来完成。**
+**你不亲自执行搜索、分析和选型 — 你调用专门的子 skill 来完成。**
 
 你的职责是：
-1. 识别输入类型 → 产品定位 → 功能拆分
-2. 调用 `competitor-search` skill 搜索竞品
-3. 调用 `feature-search` skill 搜索开源实现
-4. 调用 `tech-selection` skill 进行技术选型
-5. 合成所有子 skill 的输出，生成最终需求文档
+0. 调用 `brainstorming` skill 澄清需求、呈现设计、获得批准
+1. 识别输入类型 → 产品定位
+2. 功能拆分（三级：MVP / 增强 / 可选）
+3. 调用 `competitor-search` skill 搜索竞品
+4. 调用 `feature-search` skill 搜索开源实现
+5. 调用 `repo-clone-analyze` skill Clone 并分析参考项目
+6. 调用 `tech-selection` skill 进行技术选型
+7. 合成所有产出，生成 REQUIREMENTS.md + TECH-CONTEXT.md
 </role>
 
 ---
 
+## 硬约束
+
+| 约束 | 说明 |
+|------|------|
+| **Brainstorm 门禁** | PHASE 0 设计批准前，**禁止**进入任何后续 PHASE |
+| **子 skill 调用** | 搜索/分析/选型必须通过 `skill()` 调用，不得自行执行 |
+| **顺序执行** | PHASE 必须按 0→1→2→3→4→5→6→7 顺序执行，不得跳过 |
+| **状态更新** | 每个 PHASE 转换时必须调用 specops CLI 更新状态 |
+| **全中文输出** | 所有文档、报告、状态描述均使用中文 |
+
+---
+
+## PHASE 0: Brainstorm（需求澄清与设计批准）
+
+<brainstorm>
+
+**调用子 skill：**
+
+```
+skill(name="brainstorming")
+```
+
+按照 brainstorming skill 的指令执行：
+- **一次一问**：每轮只问一个澄清问题，等用户回答后再问下一个
+- 探索用户意图、需求边界、目标用户、核心场景
+- 逐步收敛，形成设计方案
+- 呈现设计方案给用户审阅
+
+**输出：**
+- 设计文档：`docs/plans/YYYY-MM-DD-<主题>-design.md`
+- 用户明确批准（"可以"、"通过"、"approved" 等肯定回复）
+
+**门禁条件：**
+- ✅ 设计文档已生成
+- ✅ 用户已明确批准设计
+- ❌ 未批准 → 继续迭代设计，不得进入 PHASE 1
+
+**状态更新：**
+```bash
+npx specops update-operation --agent-id <id> --operation "正在 Brainstorm 澄清需求..." --skill "brainstorming"
+```
+
+</brainstorm>
+
+---
+
 ## PHASE 1: 输入识别与产品定位
 
 <input_detection>
@@ -73,9 +122,15 @@ description: "需求分析编排 Skill — 识别输入类型（需求/仓库/
   5. 核心关键词：提炼 3-5 个搜索关键词（中英文各一组）
 ```
 
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在识别输入类型和产品定位..." --skill "demand-analysis"
+```
+
 ---
 
-## PHASE 2: 功能拆分（Brainstorm）
+## PHASE 2: 功能拆分
 
 对产品的每个功能模块进行三级拆分：
 
@@ -98,6 +153,12 @@ description: "需求分析编排 Skill — 识别输入类型（需求/仓库/
 
 完成功能拆分后，你手上有：**产品定位 + 关键词 + SC 列表**。
 
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在拆分功能模块..." --skill "demand-analysis"
+```
+
 ---
 
 ## PHASE 3: 调用竞品搜索 Skill
@@ -116,6 +177,12 @@ skill(name="competitor-search")
 
 **等待竞品搜索完成，获得竞品搜索报告后再进入下一步。**
 
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在搜索竞品..." --skill "competitor-search"
+```
+
 </skill_invocation>
 
 ---
@@ -143,11 +210,50 @@ skill(name="feature-search")
 
 **等待所有功能搜索完成，获得功能搜索报告后再进入下一步。**
 
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在搜索开源实现..." --skill "feature-search"
+```
+
+</skill_invocation>
+
+---
+
+## PHASE 5: 调用 Clone + 分析 Skill
+
+<skill_invocation>
+
+**现在调用仓库 Clone 分析 skill:**
+
+```
+skill(name="repo-clone-analyze")
+```
+
+调用后，按照 repo-clone-analyze skill 的指令执行：
+- 从 PHASE 3（竞品搜索）和 PHASE 4（功能搜索）的结果中筛选需要 clone 的项目
+- 排除基础框架和通用库（react、express、yargs、commander、zod 等）
+- Clone 功能参考项目（竞品、开源实现），深度分析源码
+- 生成 overview.md + index.json + ref.json
+
+**传入参数：**
+- PHASE 3 的竞品搜索报告（竞品列表 + GitHub URL）
+- PHASE 4 的功能搜索报告（开源项目列表 + GitHub URL）
+- 项目根目录路径（用于确定 `.specops/ref/` 输出目录）
+
+**等待 Clone 分析完成，获得 ref.json 后再进入下一步。**
+
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在 Clone 并分析参考项目..." --skill "repo-clone-analyze"
+```
+
 </skill_invocation>
 
 ---
 
-## PHASE 5: 调用技术选型 Skill
+## PHASE 6: 调用技术选型 Skill
 
 <skill_invocation>
 
@@ -157,20 +263,34 @@ skill(name="feature-search")
 skill(name="tech-selection")
 ```
 
-调用后，按照 tech-selection skill 的指令，基于前面三个阶段的产出进行技术选型：
+调用后，按照 tech-selection skill 的指令，基于前面所有阶段的产出进行技术选型：
 - 输入 1: PHASE 1 的产品定位
 - 输入 2: PHASE 3 的竞品搜索报告（竞品技术栈数据）
 - 输入 3: PHASE 4 的功能搜索报告（推荐的开源库/框架）
+- 输入 4: PHASE 5 的 ref.json（参考项目的功能-代码索引，技术栈详情）
+
+**ref.json 为技术选型提供的额外信息：**
+- 参考项目实际使用的技术栈和依赖
+- 各功能模块的实现方式和架构模式
+- 可直接借鉴的代码路径和关键文件
 
 **等待技术选型完成，获得技术选型文档后进入合成阶段。**
 
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在进行技术选型..." --skill "tech-selection"
+```
+
 </skill_invocation>
 
 ---
 
-## PHASE 6: 合成最终需求文档
+## PHASE 7: 合成 PRD
 
-将 PHASE 1-5 的所有产出合成为 `REQUIREMENTS.md`:
+将 PHASE 0-6 的所有产出合成为两个文档：
+
+### 输出 1: `.specops/REQUIREMENTS.md`
 
 ```markdown
 # 需求分析报告
@@ -179,6 +299,7 @@ skill(name="tech-selection")
 - 输入类型: [REQUIREMENT/REPO/REPOS/WEBSITE]
 - 分析时间: [时间戳]
 - 原始输入摘要: [一句话概括用户输入]
+- 设计文档: [docs/plans/YYYY-MM-DD-<主题>-design.md]
 
 ## 一、产品定位
 - 产品名称: ...
@@ -221,7 +342,19 @@ skill(name="tech-selection")
 ### 未找到开源实现的功能点
 - SC-xxx: 建议自行实现，参考[技术方案]
 
-## 五、技术选型
+## 五、参考项目深度分析
+> 来源: repo-clone-analyze skill
+
+### Clone 分析的项目
+| 项目 | 分析原因 | overview | index |
+|------|---------|----------|-------|
+| project-a | 竞品，核心功能参考 | .specops/ref/project-a/overview.md | .specops/ref/project-a/index.json |
+
+### 功能级索引
+- ref.json 路径: `.specops/ref/ref.json`
+- 包含功能: [功能名列表]
+
+## 六、技术选型
 > 来源: tech-selection skill
 
 | 维度 | 选型 | 版本 | 理由 |
@@ -233,7 +366,7 @@ skill(name="tech-selection")
 | 包名 | 版本 | 用途 |
 |------|------|------|
 
-## 六、建议实施路线
+## 七、建议实施路线
 ### Phase 1: MVP（预计 X 周）
 - 实现 SC-001 ~ SC-xxx
 - 核心技术: [列表]
@@ -245,25 +378,72 @@ skill(name="tech-selection")
 - ...
 ```
 
-**合成规则**:
-1. 竞品分析和功能搜索的数据**直接引用**子 skill 报告，不要重新编造
-2. 实施路线要基于功能复杂度 + 开源可用性排序（有现成开源的优先）
-3. 每个 Phase 估算时间要参考竞品规模和技术复杂度
-4. 最终输出文件写入项目的 `.specops/REQUIREMENTS.md`
+### 输出 2: `.specops/TECH-CONTEXT.md`
+
+从技术选型结果中提取，格式对齐 GSD 的 TECH-CONTEXT 模板：
+
+```markdown
+# 技术上下文
+
+## 锁定依赖
+| 包名 | 版本 | 用途 |
+|------|------|------|
+
+## 禁止模式
+| 模式 | 原因 |
+|------|------|
+
+## 编码约定
+- ...
+
+## 项目结构
+```
+
+### 下一步提示
+
+合成完成后，输出提示：
+
+```
+✅ 需求分析完成！
+
+产出文件：
+  - .specops/REQUIREMENTS.md（需求文档）
+  - .specops/TECH-CONTEXT.md（技术上下文）
+  - .specops/ref/ref.json（参考项目索引）
+  - docs/plans/YYYY-MM-DD-<主题>-design.md（设计文档）
+
+下一步：
+  /gsd-new-project --auto
+  （GSD 将读取 REQUIREMENTS.md 自动创建项目）
+```
+
+**状态更新：**
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "正在合成 PRD..." --skill "demand-analysis"
+```
 
 ---
 
-## 状态更新
+## 状态更新汇总
 
-每执行一个 PHASE，更新 `.specops/state.json` 中的当前操作：
+每执行一个 PHASE，调用 specops CLI 更新状态：
 
 ```
-PHASE 1: operation="正在识别输入类型和产品定位..."  skill="demand-analysis"
-PHASE 2: operation="正在拆分功能模块..."            skill="demand-analysis"
-PHASE 3: operation="正在搜索竞品..."                skill="competitor-search"
-PHASE 4: operation="正在搜索开源实现..."            skill="feature-search"
-PHASE 5: operation="正在进行技术选型..."            skill="tech-selection"
-PHASE 6: operation="正在合成需求文档..."            skill="demand-analysis"
+PHASE 0: operation="正在 Brainstorm 澄清需求..."       skill="brainstorming"
+PHASE 1: operation="正在识别输入类型和产品定位..."       skill="demand-analysis"
+PHASE 2: operation="正在拆分功能模块..."                skill="demand-analysis"
+PHASE 3: operation="正在搜索竞品..."                    skill="competitor-search"
+PHASE 4: operation="正在搜索开源实现..."                skill="feature-search"
+PHASE 5: operation="正在 Clone 并分析参考项目..."       skill="repo-clone-analyze"
+PHASE 6: operation="正在进行技术选型..."                skill="tech-selection"
+PHASE 7: operation="正在合成 PRD..."                    skill="demand-analysis"
+```
+
+每个 PHASE 转换时调用：
+```bash
+npx specops advance --agent-id <id>
+npx specops update-operation --agent-id <id> --operation "当前操作" --skill "当前skill"
 ```
 
 ---
@@ -273,35 +453,69 @@ PHASE 6: operation="正在合成需求文档..."            skill="demand-analys
 ```
 用户输入
   │
-  ├─ REPOS? ──→ 并行分析各仓库 ──┐
-  ├─ REPO?  ──→ 分析单仓库 ──────┤
-  ├─ WEBSITE? → 抓取网站信息 ────┤
-  └─ TEXT ─────────────────────────┤
-                                   ↓
-                        PHASE 1: 产品定位
-                               ↓
-                        PHASE 2: 功能拆分（Brainstorm）
-                               ↓
-                        PHASE 3: skill(name="competitor-search")
-                               ↓
-                        PHASE 4: skill(name="feature-search")
-                               ↓
-                        PHASE 5: skill(name="tech-selection")
-                               ↓
-                        PHASE 6: 合成 → REQUIREMENTS.md
+  ▼
+PHASE 0: skill(name="brainstorming")
+  │       一次一问 → 设计文档 → 用户批准
+  │       输出: docs/plans/YYYY-MM-DD-<主题>-design.md
+  │
+  ├─ 未批准 → 继续迭代（不得进入后续 PHASE）
+  │
+  ▼ （批准后）
+PHASE 1: 输入识别 + 产品定位
+  │  ├─ REPOS? ──→ 并行分析各仓库 ──┐
+  │  ├─ REPO?  ──→ 分析单仓库 ──────┤
+  │  ├─ WEBSITE? → 抓取网站信息 ────┤
+  │  └─ TEXT ─────────────────────────┤
+  │                                   ▼
+  │                        产品定位表
+  ▼
+PHASE 2: 功能拆分（SC 编号 + 复杂度）
+  │
+  ▼
+PHASE 3: skill(name="competitor-search")
+  │       竞品搜索报告
+  ▼
+PHASE 4: skill(name="feature-search")
+  │       功能搜索报告
+  ▼
+PHASE 5: skill(name="repo-clone-analyze")
+  │       筛选 → Clone → 分析 → ref.json
+  ▼
+PHASE 6: skill(name="tech-selection")
+  │       技术选型（含 ref.json 输入）
+  ▼
+PHASE 7: 合成 PRD
+  │       → .specops/REQUIREMENTS.md
+  │       → .specops/TECH-CONTEXT.md
+  │       → 提示: /gsd-new-project --auto
+  ▼
+传递给 GSD
 ```
 
 ---
 
+## 合成规则
+
+1. 竞品分析和功能搜索的数据**直接引用**子 skill 报告，不要重新编造
+2. 参考项目分析的数据**直接引用** ref.json 和 overview.md，不要重新编造
+3. 实施路线要基于功能复杂度 + 开源可用性排序（有现成开源的优先）
+4. 每个 Phase 估算时间要参考竞品规模和技术复杂度
+5. TECH-CONTEXT.md 的格式必须对齐 GSD 的技术上下文模板
+6. 最终输出文件写入项目的 `.specops/` 目录
+
+---
+
 ## 反模式
 
 | 违规行为 | 严重性 |
 |---------|--------|
-| 不调用子 skill 自己做搜索/选型 | **严重** — 必须通过 skill() 调用 |
-| 跳过 PHASE 3/4/5 中任何一个子 skill | **严重** |
+| Brainstorm 未批准就进入后续 PHASE | **致命** — 必须获得用户批准 |
+| 不调用子 skill 自己做搜索/选型/分析 | **严重** — 必须通过 skill() 调用 |
+| 跳过 PHASE 0-7 中任何一个 | **严重** |
 | 没有识别输入类型就开始分析 | 高 |
 | 跳过功能拆分直接出文档 | 高 |
 | 子 skill 报告还没返回就开始写合成文档 | 高 — 必须等待子 skill 完成 |
 | 功能描述太笼统没有具体 SC 编号 | 中 |
-| 不更新 state.json 状态 | 中 |
+| 不调用 specops CLI 更新状态 | 中 |
+| 不生成 TECH-CONTEXT.md | 中 |
 | 输出不是中文 | 中 |

package/.opencode/skills/dispatching-parallel-agents/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: dispatching-parallel-agents
+description: 面对 2 个以上独立任务时使用，这些任务之间没有共享状态或顺序依赖
+---
+
+# 并行 Agent 调度
+
+## 概述
+
+当你有多个不相关的故障（不同的测试文件、不同的子系统、不同的 bug），逐个排查是浪费时间。每个排查都是独立的，可以并行进行。
+
+**核心原则：** 每个独立问题域派发一个 agent。让它们并发工作。
+
+## 何时使用
+
+```dot
+digraph when_to_use {
+    "多个故障？" [shape=diamond];
+    "它们独立吗？" [shape=diamond];
+    "单个 agent 排查全部" [shape=box];
+    "每个问题域一个 agent" [shape=box];
+    "能并行工作吗？" [shape=diamond];
+    "顺序 agent" [shape=box];
+    "并行调度" [shape=box];
+
+    "多个故障？" -> "它们独立吗？" [label="是"];
+    "它们独立吗？" -> "单个 agent 排查全部" [label="否 - 相关"];
+    "它们独立吗？" -> "能并行工作吗？" [label="是"];
+    "能并行工作吗？" -> "并行调度" [label="是"];
+    "能并行工作吗？" -> "顺序 agent" [label="否 - 共享状态"];
+}
+```
+
+**适用场景：**
+- 3 个以上测试文件因不同根因失败
+- 多个子系统独立出问题
+- 每个问题无需其他问题的上下文即可理解
+- 排查之间没有共享状态
+
+**不适用场景：**
+- 故障相关（修一个可能修好其他的）
+- 需要理解完整系统状态
+- agent 之间会互相干扰
+
+## 模式
+
+### 1. 识别独立域
+
+按故障分组：
+- 文件 A 测试：工具审批流程
+- 文件 B 测试：批量完成行为
+- 文件 C 测试：中止功能
+
+每个域都是独立的，修复工具审批不会影响中止测试。
+
+### 2. 创建聚焦的 Agent 任务
+
+每个 agent 获得：
+- **明确范围：** 一个测试文件或子系统
+- **清晰目标：** 让这些测试通过
+- **约束条件：** 不要修改其他代码
+- **预期输出：** 发现和修复的摘要
+
+### 3. 并行调度
+
+```typescript
+// 在 opencode 环境中
+task(run_in_background=true, prompt="修复 agent-tool-abort.test.ts 的失败")
+task(run_in_background=true, prompt="修复 batch-completion-behavior.test.ts 的失败")
+task(run_in_background=true, prompt="修复 tool-approval-race-conditions.test.ts 的失败")
+// 三个并发运行
+```
+
+### 4. 审查与集成
+
+agent 返回后：
+- 阅读每个摘要
+- 验证修复不冲突
+- 运行完整测试套件
+- 集成所有变更
+
+## Agent 提示词结构
+
+好的 agent 提示词应该：
+1. **聚焦** - 一个清晰的问题域
+2. **自包含** - 理解问题所需的所有上下文
+3. **明确输出** - agent 应该返回什么？
+
+```markdown
+修复 src/agents/agent-tool-abort.test.ts 中的 3 个失败测试：
+
+1. "should abort tool with partial output capture" - 期望消息中包含 'interrupted at'
+2. "should handle mixed completed and aborted tools" - 快速工具被中止而非完成
+3. "should properly track pendingToolCount" - 期望 3 个结果但得到 0
+
+这些是时序/竞态条件问题。你的任务：
+
+1. 阅读测试文件，理解每个测试验证什么
+2. 找到根因 - 是时序问题还是实际 bug？
+3. 修复方式：
+   - 用基于事件的等待替换任意超时
+   - 如果发现中止实现的 bug 则修复
+   - 如果测试的是已变更的行为则调整测试期望
+
+不要只是增加超时 - 找到真正的问题。
+
+返回：你发现了什么以及修复了什么的摘要。
+```
+
+## 常见错误
+
+**❌ 范围太广：** "修复所有测试" - agent 会迷失
+**✅ 具体：** "修复 agent-tool-abort.test.ts" - 聚焦的范围
+
+**❌ 没有上下文：** "修复竞态条件" - agent 不知道在哪
+**✅ 有上下文：** 粘贴错误信息和测试名称
+
+**❌ 没有约束：** agent 可能重构所有东西
+**✅ 有约束：** "不要修改生产代码" 或 "只修复测试"
+
+**❌ 输出模糊：** "修好它" - 你不知道改了什么
+**✅ 输出明确：** "返回根因和变更的摘要"
+
+## 何时不使用
+
+**相关故障：** 修一个可能修好其他的，先一起排查
+**需要完整上下文：** 理解问题需要看整个系统
+**探索性调试：** 你还不知道什么坏了
+**共享状态：** agent 会互相干扰（编辑同一文件、使用同一资源）
+
+## 真实案例
+
+**场景：** 大规模重构后 3 个文件中有 6 个测试失败
+
+**失败情况：**
+- agent-tool-abort.test.ts：3 个失败（时序问题）
+- batch-completion-behavior.test.ts：2 个失败（工具未执行）
+- tool-approval-race-conditions.test.ts：1 个失败（执行次数 = 0）
+
+**决策：** 独立域 - 中止逻辑与批量完成与竞态条件各自独立
+
+**调度：**
+```
+Agent 1 → 修复 agent-tool-abort.test.ts
+Agent 2 → 修复 batch-completion-behavior.test.ts
+Agent 3 → 修复 tool-approval-race-conditions.test.ts
+```
+
+**结果：**
+- Agent 1：用基于事件的等待替换了超时
+- Agent 2：修复了事件结构 bug（threadId 位置错误）
+- Agent 3：添加了异步工具执行完成的等待
+
+**集成：** 所有修复独立，无冲突，完整套件全绿
+
+**节省时间：** 3 个问题并行解决 vs 顺序解决
+
+## 核心收益
+
+1. **并行化** - 多个排查同时进行
+2. **聚焦** - 每个 agent 范围窄，需要跟踪的上下文少
+3. **独立性** - agent 互不干扰
+4. **速度** - 3 个问题在 1 个问题的时间内解决
+
+## 验证
+
+agent 返回后：
+1. **审查每个摘要** - 理解改了什么
+2. **检查冲突** - agent 是否编辑了同一段代码？
+3. **运行完整套件** - 验证所有修复协同工作
+4. **抽查** - agent 可能犯系统性错误
+
+## 实际影响
+
+来自调试会话（2025-10-03）：
+- 3 个文件中 6 个失败
+- 3 个 agent 并行调度
+- 所有排查并发完成
+- 所有修复成功集成
+- agent 变更之间零冲突

package/.opencode/skills/executing-plans/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: executing-plans
+description: "有写好的实现计划需要在单独会话中执行时使用，带审查检查点"
+triggers:
+  - "执行计划"
+  - "实现计划"
+  - "按计划开发"
+  - "分批执行"
+---
+
+# 执行计划
+
+## 概述
+
+加载计划，批判性审查，分批执行任务，批次之间报告等待审查。
+
+**核心原则：** 分批执行，带检查点供架构师审查。
+
+**开始时宣布：** "我正在使用 executing-plans skill 来实现这个计划。"
+
+## 流程
+
+### 步骤 1：加载并审查计划
+1. 读取计划文件
+2. 批判性审查，找出任何问题或疑虑
+3. 如果有疑虑：在开始之前向你的人类搭档提出
+4. 如果没有疑虑：创建 TodoWrite 并继续
+
+### 步骤 2：执行批次
+**默认：前 3 个任务**
+
+对每个任务：
+1. 标记为 in_progress
+2. 严格按照每一步执行（计划已经拆成了小步骤）
+3. 按要求运行验证
+4. 标记为 completed
+
+### 步骤 3：报告
+批次完成时：
+- 展示实现了什么
+- 展示验证输出
+- 说："等待反馈。"
+
+### 步骤 4：继续
+根据反馈：
+- 如果需要就应用修改
+- 执行下一批次
+- 重复直到完成
+
+### 步骤 5：完成开发
+
+所有任务完成并验证后：
+- 先运行 specops acceptance runner 进行验收测试
+- 宣布："我正在使用 finishing-a-development-branch skill 来完成这项工作。"
+- **必须使用的子 SKILL：** 使用 specops:finishing-a-development-branch
+- 按照那个 skill 来验证测试、展示选项、执行选择
+
+## 什么时候停下来求助
+
+**遇到以下情况立即停止执行：**
+- 批次中途遇到阻塞（缺少依赖、测试失败、指令不清楚）
+- 计划有关键缺口导致无法开始
+- 你不理解某条指令
+- 验证反复失败
+
+**宁可问清楚，也不要猜。**
+
+## 什么时候回到前面的步骤
+
+**回到审查（步骤 1）的情况：**
+- 搭档根据你的反馈更新了计划
+- 根本方案需要重新思考
+
+**不要硬闯阻塞** - 停下来问。
+
+## 注意事项
+- 先批判性审查计划
+- 严格按照计划步骤执行
+- 不要跳过验证
+- 计划提到的 skill 要引用
+- 批次之间：只报告，然后等待
+- 遇到阻塞就停下来，不要猜
+- 未经用户明确同意，永远不要在 main/master 分支上开始实现
+
+## 集成
+
+**必需的工作流 skill：**
+- **specops:using-git-worktrees** - 必需：开始之前搭建隔离的工作空间
+- **specops:writing-plans** - 创建本 skill 要执行的计划
+- **specops:finishing-a-development-branch** - 所有任务完成后收尾开发