complete-task

Complete Task Command

功能说明

标记任务为已完成状态，更新任务元数据，并将任务从 active 目录移动到 completed 目录进行归档。

⚠️ CRITICAL: 状态更新要求

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

前置条件

在执行此命令前，请确认以下条件全部满足：

• 所有工作流步骤已完成
• 代码已审查通过（review.md 显示批准）
• 代码已提交到 Git
• 代码已合并到目标分支（如果需要）
• 所有测试通过
• Issue 已同步更新（如果有关联 Issue）
• PR 已合并（如果有 PR）

如果以上条件未全部满足，请勿执行此命令。

执行流程

1. 验证任务存在

检查任务文件是否存在：

ls -la .ai-workspace/active/{task-id}/task.md

如果任务不在 active 目录，检查是否已经在 completed 或 blocked 目录。

2. 读取并验证任务状态

读取 .ai-workspace/active/{task-id}/task.md，检查：

工作流进度：

• 所有步骤是否标记为完成 ✅
• current_step 是否为最后一步（如 finalize 或 code-review）

任务状态：

• status 是否为 active（即将改为 completed）
• 是否有未解决的阻塞问题

文件完整性：

• analysis.md 存在（如果是 feature-development 或 security-fix）
• plan.md 存在（如果是 feature-development）
• implementation.md 存在
• review.md 存在且显示批准

如果发现任何问题，提示用户并停止执行。

3. 更新任务状态 (CRITICAL)

必须更新 .ai-workspace/active/{task-id}/task.md：

status: completed
current_step: finalize
updated_at: {当前时间，格式: yyyy-MM-dd HH:mm:ss}
completed_at: {当前时间，格式: yyyy-MM-dd HH:mm:ss}

在工作流进度中标记所有步骤完成：

## 工作流进度

- [x] requirement-analysis (claude, {日期})
- [x] technical-design (claude, {日期})
- [x] implementation (claude, {日期})
- [x] code-review (claude, {日期})
- [x] finalize (claude, {当前日期})  ← 标记为完成

添加完成总结（在 task.md 末尾添加）：

---

## 任务完成总结

### 完成信息

- **完成时间**: {当前时间}
- **完成者**: {当前AI}
- **关联 PR**: #{pr-number}（如果有）
- **关联 Issue**: #{issue-number}（如果有）
- **目标分支**: {分支名}

### 交付成果

- [x] 需求分析文档: `analysis.md`
- [x] 技术方案文档: `plan.md`
- [x] 实现报告: `implementation.md`
- [x] 代码审查报告: `review.md`
- [x] 代码提交: {commit-hash}
- [x] PR 合并: #{pr-number}

### 任务完成标准

- [x] 功能完整实现
- [x] 代码审查通过
- [x] 所有测试通过
- [x] 文档完整
- [x] 代码已合并

### 备注

{如有需要，添加备注}

4. 归档任务 (CRITICAL)

将任务从 active 目录移动到 completed 目录：

# 确保 completed 目录存在
mkdir -p .ai-workspace/completed

# 移动任务目录
mv .ai-workspace/active/{task-id} .ai-workspace/completed/