用途
complete 是一个任务收尾命令，用于在实现工作全部完成后，执行完整的验证、文档更新、审查，并自动合并到 develop 分支。当所有实现已完成、准备定稿时使用。
主要能力
- 验证 PLAN 完成情况与规格符合度
- 更新所有项目文档
- 创建包含文档变更的最终提交
- 运行强制代码审查与安全审计
- 合并到 develop 分支
- 清理特性分支
使用方式
命令用法：
/complete careerbrain 002 # 完成指定 issue
/complete careerbrain # 完成当前/活跃 issue
前置条件：
- 所有实现已完成（代码已编写）
- 存在有已完成工作的活跃 issue
- PLAN.md 存在且阶段大部分完成
执行流程：
- 检查 PLAN.md 完成情况：确认所有阶段是否完成，列出未完成阶段。
- 规格符合度验证：
- 验收场景覆盖：搜索匹配每个 Given/When/Then 场景的测试，必要时创建缺失测试。
- 成功指标验证：检查性能、覆盖率、可访问性。
- 范围外约束执行：扫描违反范围外条目的代码。
- 代理约束检查：验证未添加依赖（如有约束），检查未修改范围外文件。
- 更新规格状态标记：如果 TASK 有 implements: 字段，更新规格中的内联状态标记（例如将 🚧 改为 ✅），提供已实现内容的公开可见性。
- 更新所有文档：扫描并验证 spaces/[project]/docs/ 下的所有文档，包括 architecture-overview.md、data-model.md、api-overview.md、README.md。
- 更新 CHANGELOG：强制在 [Unreleased] 部分添加条目，分类包括 Added（新功能 TASK）、Fixed（缺陷修复 BUG）、Changed（修改）、Security（安全更新）。
- 最终 WORKLOG 条目：记录完成摘要，包括已实现和已推迟的内容。
- 更新状态：设置 issue frontmatter 为 status: complete。
- 创建最终提交：暂存并提交文档变更。
- 运行最终审查：如尚未完成，启动 code-reviewer 代理和 security-auditor 代理，若存在 CRITICAL 问题则阻止。
- 合并到 develop：
git checkout develop
git pull origin develop
git merge --no-ff feature/###-slug
git push origin develop
git branch -d feature/###-slug
- 建议后续步骤：
- 开始下一任务：/implement project ### --full
- 查看状态：/project-status project
- 合并到 main（需要 PR）：gh pr create --base main --head develop
适用场景
适用于遵循 GitFlow 工作流的开发项目，在特性分支实现完成后需要规范化收尾时使用。典型工作流为：/issue → /plan → /implement → /commit → /complete。
限制
- 需要所有实现已完成，且存在活跃 issue 和 PLAN.md。
- 合并到 develop 为自动执行，但 develop 到 main 需要 PR。
- 若代码审查或安全审计发现 CRITICAL 问题，合并会被阻止。
- 文档检查清单要求验证 PLAN.md、关联 SPEC、architecture-overview.md、ADRs、CHANGELOG.md、WORKLOG.md、README.md 等。