
关于
按照 TDD 工作流执行工作轨道实施计划中的任务。
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。
预检
-
验证 Conductor 已初始化:
- 检查
conductor/product.md是否存在 - 检查
conductor/workflow.md是否存在 - 检查
conductor/tracks.md是否存在 - 如缺失:显示错误并建议先运行
/conductor:setup
- 检查
-
加载工作流配置:
- 读取
conductor/workflow.md - 解析 TDD 严格级别
- 解析提交策略
- 解析验证检查点规则
- 读取
Track 选择
如果提供了参数:
- 验证 track 存在:
conductor/tracks/{argument}/plan.md - 如未找到:搜索部分匹配,建议更正
如果没有参数:
-
读取
conductor/tracks.md -
解析未完成的 track(状态
[ ]或[~]) -
显示选择菜单:
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:
上下文加载
加载实现所需的所有相关上下文:
-
Track 文档:
conductor/tracks/{trackId}/spec.md- 需求conductor/tracks/{trackId}/plan.md- 任务列表conductor/tracks/{trackId}/metadata.json- 进度状态
-
项目上下文:
conductor/product.md- 产品理解conductor/tech-stack.md- 技术约束conductor/workflow.md- 流程规则
-
代码风格(如存在):
conductor/code_styleguides/{language}.md
Track 状态更新
将 track 更新为进行中:
-
在
conductor/tracks.md中:- 将此 track 的
[ ]改为[~]
- 将此 track 的
-
在
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
兼容工具
Claude CodeCursor
标签
前端开发