conductor-implement

实施 Track

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

何时使用此技能

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

何时不要使用此技能

• 任务与实施 Track 无关时
• 需要使用此范围之外的其他领域或工具时

指示

• 明确目标、限制和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可执行的步骤和验证方法。

仓库边界

遵循用户或仓库明确规定的工作流限制，而非此通用流程，包括不得编辑已提供计划以及提交或检查点方面的限制。将 Track ID 验证为单个现有目录名称；拒绝路径遍历和 shell 元字符。更改前读取状态和差异，只暂存任务所属路径，并保留无关改动。斜杠命令需要已安装 Conductor 集成；此文件不会安装集成。

预检

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：将当前任务的 [ ] 改为 [~]
• 宣布：“开始任务 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 -- <explicit-task-owned-paths>
git commit -m "{commit_prefix}: {task description} ({trackId})"

更新 plan.md：

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

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

重要：必须等待用户明确批准后，才能进入下一阶段。

实施过程中的错误处理

工具失败时

ERROR: {tool} failed with: {error message}

Options:
1. Retry the operation
2. Skip this task and continue
3. Pause implementation
4. Revert current task changes

• 停止并提供选项
• 不要自动继续

测试失败时

TESTS FAILING after Task X.Y

Failed tests:
- {test name}: {failure reason}

Options:
1. Attempt to fix
2. Rollback task changes
3. Pause for manual intervention

Git 操作失败时

GIT ERROR: {error message}

This may indicate:
- Uncommitted changes from outside Conductor
- Merge conflicts
- Permission issues

Options:
1. Show git status
2. Attempt to resolve
3. Pause for manual intervention

跟踪完成情况

所有阶段和任务完成后：

1. 最终验证

All tasks complete. Running final verification...

• 运行完整测试套件
• 检查 spec.md 中的所有验收标准
• 生成验证报告

2. 更新跟踪状态

在 conductor/tracks.md 中：

• 将此跟踪项的 [~] 改为 [x]
• 更新“Updated”列

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

• 将 status 设为 "complete"
• 将 phases.completed 设为阶段总数
• 将 tasks.completed 设为任务总数
• 更新 updated 时间戳

在 conductor/tracks/{trackId}/plan.md 中：

• 将标题状态更新为 [x] Complete

3. 提供文档同步选项

Track complete! Would you like to sync documentation?

This will update:
- conductor/product.md (if new features added)
- conductor/tech-stack.md (if new dependencies added)
- README.md (if applicable)

1. Yes, sync documentation
2. No, skip

4. 提供清理选项

Track {trackId} is complete.

Cleanup options:
1. Archive - Move to conductor/tracks/_archive/
2. Delete - Remove track directory
3. Keep - Leave as-is

5. 完成摘要

Track Complete: {track title}

Summary:
- Track ID: {trackId}
- Phases completed: {N}/{N}
- Tasks completed: {M}/{M}
- Commits created: {count}
- Tests: All passing

Next steps:
- Run /conductor:status to see project progress
- Run /conductor:new-track for next feature

进度跟踪

在整个过程中持续更新 metadata.json 中的进度：

{
  "id": "auth_20250115",
  "title": "User Authentication",
  "type": "feature",
  "status": "in_progress",
  "created": "2025-01-15T10:00:00Z",
  "updated": "2025-01-15T14:30:00Z",
  "current_phase": 2,
  "current_task": "2.3",
  "phases": {
    "total": 3,
    "completed": 1
  },
  "tasks": {
    "total": 12,
    "completed": 7
  },
  "commits": [
    "abc1234: feat: add login form (auth_20250115)",
    "def5678: feat: add password validation (auth_20250115)"
  ]
}

恢复执行

如果实施过程暂停后恢复：

1. 加载 metadata.json 以获取当前状态

2. 根据 current_task 字段查找当前任务

3. 检查 plan.md 中该任务是否标记为 [~]

4. 询问用户：

   Resuming track: {title}
   
   Last task in progress: Task {X.Y}: {description}
   
   Options:
   1. Continue from where we left off
   2. Restart current task
   3. Show progress summary first
   

重要规则

1. 绝不跳过验证检查点——阶段之间始终等待用户批准
2. 任何失败都要停止——发生错误后不要尝试继续
3. 严格遵循 workflow.md——TDD、提交策略和验证规则均为强制要求
4. 保持 plan.md 更新——任务状态必须反映实际进度
5. 频繁提交——每项任务完成后都应提交
6. 跟踪所有提交——在 metadata.json 中记录提交哈希，以便必要时回滚

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境专属验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并要求澄清。