name: 实施 description: 执行实施计划,做出更改并适当提交 allowed-tools: 读取、搜索、全局匹配、编辑、写入、Bash
实施
执行实施计划或审查修复,根据指南进行代码更改和提交。
参数
/implement [target]
目标(可选)
指定要实施的内容。可以是:
- 无 - 自动从分支名称检测,检查 review.md 然后 plan.md
- 目录名称 -
.ai/内的文件夹(例如,issue-59-add-no-verify-option) - 相对路径 - 到
.ai/文件夹的路径(例如,.ai/my-feature) - 文件路径 - 直接到特定文件的路径(例如,
.ai/my-feature/plan.md)
源优先级
当给定一个目录(或自动检测时):
- 如果
review.md存在 → 从审查中实施修复 - 否则如果
plan.md存在 → 实施计划 - 如果两者都不存在 → 建议先运行
/create-plan或/code-review
示例
# 从分支自动检测,优先 review.md 而非 plan.md
/implement
# 使用 .ai/ 中的特定文件夹
/implement issue-59-add-no-verify-option
# 使用相对路径
/implement .ai/my-feature
# 直接使用特定文件
/implement .ai/my-feature/plan.md
/implement .ai/my-feature/review.md
指令
-
解析参数并查找源
如果提供了文件路径(以
.md结尾):- 直接使用该文件
- 根据文件名确定是计划还是审查
如果提供了目录/文件夹:
- 如果以
.ai/开头,直接使用 - 否则,将其视为
.ai/内的文件夹名称 - 先检查
review.md,然后plan.md
如果未提供参数:
- 从分支名称中提取问题编号(例如,
feature/59-...→59) - 查找现有的
.ai/issue-<number>-*文件夹 - 先检查
review.md,然后plan.md
如果未找到源文件:
- 建议运行
/create-plan进行新工作 - 如果代码存在但需要审查,建议运行
/code-review
-
验证先决条件
- 确认在正确的功能分支上
- 检查工作目录是否干净(
git status) - 确保在开始前测试通过:
go test ./...
-
加载指南
- 阅读 CODING_GUIDELINES.md 获取实施标准
- 阅读 COMMIT_GUIDELINES.md 获取提交格式
- 实施测试时阅读 GIT_TEST_SCENARIOS.md(Git 场景设置所需)
-
执行工作
计划模式(从 plan.md 实施)
对于计划中的每个任务:
在每个任务之前:
- 审查任务要求并识别要修改的所有文件
- 阅读与更改相关的 CODING_GUIDELINES.md 规则
代码更改:
- 做出聚焦、原子的更改
- 遵循代码库中的现有模式
- 保持更改最小化——不要过度工程
在每个任务之后:
- 验证构建:
go build ./... - 运行测试:
go test ./... - 审查更改:
git diff
审查模式(从 review.md 实施)
对于审查中的每个问题:
必须修复:
- 在继续之前解决所有必须修复的问题
- 这些阻止 PR 被合并
应该修复:
- 解决应该修复的项目以改进代码质量
- 记录任何故意跳过的理由
细节:
- 如果它们改进代码,考虑实施
- 如果增加不必要的复杂性,跳过
修复之后:
- 验证构建:
go build ./... - 运行测试:
go test ./... - 审查更改:
git diff
-
提交策略
何时提交
- 在完成逻辑工作单元后
- 在计划中的每个检查点后(计划模式)
- 在修复一类问题后(审查模式)
- 保持提交原子化和聚焦
- 使用
/commit技能进行适当格式化
-
检查点验证
在每个检查点:
- [ ] 构建成功:
go build ./... - [ ] 测试通过:
go test ./... - [ ] 预期行为工作正常
- [ ] 更改已提交
- [ ] 构建成功:
-
跟踪进度
对于计划模式 - 更新 plan.md 复选框:
- [x] 已完成任务 - [ ] 待处理任务对于审查模式 - 更新 review.md 复选框:
- [x] 已修复:<问题描述> - [ ] 待处理:<问题描述> -
处理问题
如果出现问题:
- 记录问题
- 检查是否影响计划/审查
- 如果需要,调整方法
- 如果受阻,请求澄清
完成
对于计划模式:
- 验证所有测试通过
- 检查 plan.md 中所有复选框都已完成
- 建议在 PR 前运行
/code-review
对于审查模式:
- 验证所有测试通过
- 检查所有阻塞问题已解决
- 用修复更新 review.md
- 如果所有阻塞问题修复,准备 PR