---

name: conductor-implement description: "按照 TDD 工作流执行 track 实现计划中的任务" risk: critical source: community date_added: "2026-02-27"

实现 Track

按照 conductor/workflow.md 中定义的工作流规则，执行 track 实现计划中的任务。

在以下情况使用本技能

• 处理实现 track 任务或工作流时
• 需要实现 track 的指导、最佳实践或检查清单时

不要在以下情况使用本技能

• 任务与实现 track 无关时
• 需要此范围之外的不同领域或工具时

说明

• 明确目标、约束和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可操作的步骤和验证。
• 如需详细示例，打开 resources/implementation-playbook.md。

预检

1. 验证 Conductor 已初始化：

   • 检查 conductor/product.md 是否存在
   • 检查 conductor/workflow.md 是否存在
   • 检查 conductor/tracks.md 是否存在
   • 如缺失：显示错误并建议先运行 /conductor:setup

2. 加载工作流配置：

   • 读取 conductor/workflow.md
   • 解析 TDD 严格级别
   • 解析提交策略
   • 解析验证检查点规则

Track 选择

如果提供了参数：

• 验证 track 存在：conductor/tracks/{argument}/plan.md
• 如未找到：搜索部分匹配，建议更正

如果没有参数：

1. 读取 conductor/tracks.md

2. 解析未完成的 track（状态 [ ] 或 [~]）

3. 显示选择菜单：

   Select a track to implement:
   
   In Progress:
   1. [~] auth_20250115 - User Authentication (Phase 2, Task 3)
   
   Pending:
   2. [ ] nav-fix_20250114 - Navigation Bug Fix
   3. [ ] dashboard_20250113 - Dashboard Feature
   
   Enter number or track ID:
   

上下文加载

加载实现所需的所有相关上下文：

1. Track 文档：

   • conductor/tracks/{trackId}/spec.md - 需求
   • conductor/tracks/{trackId}/plan.md - 任务列表
   • conductor/tracks/{trackId}/metadata.json - 进度状态

2. 项目上下文：

   • conductor/product.md - 产品理解
   • conductor/tech-stack.md - 技术约束
   • conductor/workflow.md - 流程规则

3. 代码风格（如存在）：

   • conductor/code_styleguides/{language}.md

Track 状态更新

将 track 更新为进行中：

1. 在 conductor/tracks.md 中：

   • 将此 track 的 [ ] 改为 [~]

2. 在 conductor/tracks/{trackId}/metadata.json 中：

   • 设置 status: "in_progress"
   • 更新 updated 时间戳

任务执行循环

对于 plan.md 中每个未完成的任务（标记为 [ ]）：

1. 任务识别

解析 plan.md 找到下一个未完成任务：

• 查找匹配 - [ ] Task X.Y: {description} 的行
• 从结构中跟踪当前阶段

2. 任务开始

将任务标记为进行中：

• 更新 plan.md：将当前任务的 [ ] 改为 [~]
• 宣布："Starting Task X.Y: {description}"

3. TDD 工作流（如果 workflow.md 中启用了 TDD）

红色阶段 - 编写失败测试：

Following TDD workflow for Task X.Y...

Step 1: Writing failing test

• 如需要则创建测试文件
• 为任务功能编写测试
• 运行测试确认失败
• 如果测试意外通过：停止，调查

绿色阶段 - 实现：

Step 2: Implementing minimal code to pass test

• 编写最少代码使测试通过
• 运行测试确认通过
• 如果测试失败：调试并修复

重构阶段：

Step 3: Refactoring while keeping tests green

• 清理代码
• 运行测试确保仍然通过

4. 非 TDD 工作流（如果 TDD 非严格模式）

• 直接实现任务
• 运行现有测试
• 按需手动验证

5. 任务完成

提交更改（遵循 workflow.md 中的提交策略）：

git add -A
git commit -m "{commit_prefix}: {task description} ({trackId})"

更新 plan.md：

• 将已完成任务的 [~] 改为 [x]
• 提交计划更新：

git add conductor/tracks/{trackId}/plan.md
git commit -m "chore: mark task X.Y complete ({trackId})"

更新 metadata.json：

• 递增 tasks.completed
• 更新 updated 时间戳

6. 阶段完成检查

每个任务完成后，检查阶段是否完成：

• 解析 plan.md 的阶段结构
• 如果当前阶段所有任务都是 [x]：

运行阶段验证：

Phase {N} complete. Running verification...

• 执行为该阶段列出的验证任务
• 运行完整测试套件：npm test / pytest 等

报告并等待批准：

Phase {N} Verification Results:
- All phase tasks: Complete
- Tests: {passing/failing}
- Verification: {pass/fail}

Approve to continue to Phase {N+1}?
1. Yes, continue
2. No, there are issues to fix
3. Pause implementation

关键：在继续下一阶段之前等待用户明确批准。

实现过程中的错误处理

工具失败时

ERRO