实施Skill implement

该技能用于自动化执行软件开发中的实施计划或代码审查修复,根据计划或审查文件进行代码更改和提交,确保符合编码和提交指南,提高开发效率。关键词:实施、代码更改、提交、自动化、软件开发、DevOps。

DevOps 0 次安装 0 次浏览 更新于 3/11/2026

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

源优先级

当给定一个目录(或自动检测时):

  1. 如果 review.md 存在 → 从审查中实施修复
  2. 否则如果 plan.md 存在 → 实施计划
  3. 如果两者都不存在 → 建议先运行 /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

指令

  1. 解析参数并查找源

    如果提供了文件路径(以 .md 结尾):

    • 直接使用该文件
    • 根据文件名确定是计划还是审查

    如果提供了目录/文件夹:

    • 如果以 .ai/ 开头,直接使用
    • 否则,将其视为 .ai/ 内的文件夹名称
    • 先检查 review.md,然后 plan.md

    如果未提供参数:

    • 从分支名称中提取问题编号(例如,feature/59-...59
    • 查找现有的 .ai/issue-<number>-* 文件夹
    • 先检查 review.md,然后 plan.md

    如果未找到源文件:

    • 建议运行 /create-plan 进行新工作
    • 如果代码存在但需要审查,建议运行 /code-review
  2. 验证先决条件

    • 确认在正确的功能分支上
    • 检查工作目录是否干净(git status
    • 确保在开始前测试通过:go test ./...
  3. 加载指南

    • 阅读 CODING_GUIDELINES.md 获取实施标准
    • 阅读 COMMIT_GUIDELINES.md 获取提交格式
    • 实施测试时阅读 GIT_TEST_SCENARIOS.md(Git 场景设置所需)
  4. 执行工作

    计划模式(从 plan.md 实施)

    对于计划中的每个任务:

    在每个任务之前:

    • 审查任务要求并识别要修改的所有文件
    • 阅读与更改相关的 CODING_GUIDELINES.md 规则

    代码更改:

    • 做出聚焦、原子的更改
    • 遵循代码库中的现有模式
    • 保持更改最小化——不要过度工程

    在每个任务之后:

    • 验证构建:go build ./...
    • 运行测试:go test ./...
    • 审查更改:git diff

    审查模式(从 review.md 实施)

    对于审查中的每个问题:

    必须修复:

    • 在继续之前解决所有必须修复的问题
    • 这些阻止 PR 被合并

    应该修复:

    • 解决应该修复的项目以改进代码质量
    • 记录任何故意跳过的理由

    细节:

    • 如果它们改进代码,考虑实施
    • 如果增加不必要的复杂性,跳过

    修复之后:

    • 验证构建:go build ./...
    • 运行测试:go test ./...
    • 审查更改:git diff
  5. 提交策略

    何时提交

    • 在完成逻辑工作单元后
    • 在计划中的每个检查点后(计划模式)
    • 在修复一类问题后(审查模式)
    • 保持提交原子化和聚焦
    • 使用 /commit 技能进行适当格式化
  6. 检查点验证

    在每个检查点:

    • [ ] 构建成功:go build ./...
    • [ ] 测试通过:go test ./...
    • [ ] 预期行为工作正常
    • [ ] 更改已提交
  7. 跟踪进度

    对于计划模式 - 更新 plan.md 复选框:

    - [x] 已完成任务
    - [ ] 待处理任务
    

    对于审查模式 - 更新 review.md 复选框:

    - [x] 已修复:<问题描述>
    - [ ] 待处理:<问题描述>
    
  8. 处理问题

    如果出现问题:

    • 记录问题
    • 检查是否影响计划/审查
    • 如果需要,调整方法
    • 如果受阻,请求澄清

完成

对于计划模式:

  1. 验证所有测试通过
  2. 检查 plan.md 中所有复选框都已完成
  3. 建议在 PR 前运行 /code-review

对于审查模式:

  1. 验证所有测试通过
  2. 检查所有阻塞问题已解决
  3. 用修复更新 review.md
  4. 如果所有阻塞问题修复,准备 PR