implement-task

Implement Task Command

功能说明

根据技术方案实施任务，编写代码和测试，输出实现报告。

⚠️ CRITICAL: 状态更新要求

执行此命令后，你必须立即更新任务状态。参见规则 7。

执行流程

1. 验证前置条件

检查必需文件：

• .ai-workspace/active/{task-id}/task.md - 任务文件
• .ai-workspace/active/{task-id}/plan.md - 技术方案

注意：{task-id} 格式为 TASK-{yyyyMMdd-HHmmss}，例如 TASK-20260205-202013

如果任一文件不存在，提示用户先完成前置步骤。

2. 读取技术方案

仔细阅读 plan.md，理解：

• 技术方案和实现策略
• 详细的实施步骤
• 需要创建/修改的文件清单
• 测试策略

3. 执行代码实现

按照 .agents/workflows/feature-development.yaml 中的 implementation 步骤：

必须完成的任务：

• 按照方案实现功能代码
• 编写完整的单元测试
• 本地运行测试验证功能
• 更新相关文档和注释
• 遵循项目编码规范

实施原则：

1. 严格遵循方案：不要偏离技术方案
2. 分步实施：按照 plan.md 中的步骤顺序执行
3. 及时测试：每完成一个步骤就运行测试
4. 保持简洁：不要过度设计或添加额外功能

4. 运行测试验证

# 根据项目类型运行测试
mvn test -pl :{module-name}  # Maven 项目
npm test                      # Node.js 项目
pytest                        # Python 项目

确保所有测试通过。

5. 输出实现报告

创建 .ai-workspace/active/{task-id}/implementation.md，必须包含以下章节：

# 实现报告

## 已修改文件列表

### 新增文件
- `{file-path}` - {说明}

### 修改文件
- `{file-path}` - {修改内容摘要}

## 关键代码说明

### {模块/功能名称}
**文件**: `{file-path}:{line-number}`

**实现逻辑**：
{重要逻辑的解释}

**关键代码**：
```{language}
{关键代码片段}

测试结果

单元测试

• 测试文件: {test-file-path}
• 测试用例数: {数量}
• 通过率: {百分比}

测试输出：

{测试运行结果}

集成测试

{如果有}

与方案的差异

{如果实现与方案有差异，说明原因}

待审查事项

需要 reviewer 特别关注的点：

• {关注点1}
• {关注点2}

已知问题

{实现过程中发现的问题或待优化项}

下一步建议

{对代码审查的建议或后续优化方向}

### 6. 更新任务状态

更新 `.ai-workspace/active/{task-id}/task.md`：
- `current_step`: implementation
- `assigned_to`: {当前 AI}
- `updated_at`: {当前时间}
- 标记 implementation.md 为已完成
- 在工作流进度中标记代码实现为完成

### 7. 告知用户

输出格式：

✅ 任务 {task-id} 实现完成

实现概要：

• 修改文件: {数量} 个
• 新增文件: {数量} 个
• 测试通过: {数量}/{总数}

输出文件：

• 实现报告: .ai-workspace/active/{task-id}/implementation.md

下一步： 使用以下命令进行代码审查：

• Claude Code / OpenCode: /review-task {task-id}
• Gemini CLI: /fit:review-task {task-id}
• Codex CLI: /prompts:fit-review-task {task-id}

或使用项目的 code-review 插件： /code-review:code-review