关于 implement
用于依据用户的规格说明或工单实现工作的技能,在基于当前分支的独立 worktree 中开展开发。它涵盖工单认领、测试、提交及代码审查,规范 Agent 的实现流程。
主要功能
- 01在独立 worktree 中开展工作
- 02检查并认领已跟踪的工单
- 03定期运行类型检查和测试
- 04将改动提交到当前分支
- 05提交后请求代码审查
适用场景
- 01实现工单并避免重复开发
- 02根据书面规格实现改动
- 03准备已提交的代码供审查
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ timschoch/ mattpocock-skills --skill implement安装后在 Claude Code 中输入/implement确认已加载。
附带文件agents/openai.yaml
详细介绍
在与当前分支分离的 worktree 上,实现用户在规范或工单中描述的工作。
如果用户提供了工单引用,先从问题跟踪系统获取工单,并在开始前说明工单标题。如果引用不明确,请先询问。
先认领问题
编辑任何文件之前,先认领要实现的问题,以便其他冲突的 Agent 跳过它(参见 docs/agents/triage-labels.md)。如果这项工作对应的问题编号为 N:
首先,检查是否已有认领,运行 gh issue view N --json labels,comments。如果已设置 in-progress,可能有其他 Agent 正在处理:阅读最新的 🤖 in-progress 评论,检查该分支的实际状态(是否有未关闭的 PR?是否有提交?还是空分支/已放弃的分支?),然后跳过或协调,而不是重复实现。只有在问题尚未被认领,或之前的认领明确已被放弃(符合清理器的规则)时,才进行认领。
然后认领:
gh issue edit N --add-label in-progress --remove-label ready-for-agent
gh issue comment N --body "🤖 in-progress: <branch> (<session>) <date>"
此操作具有幂等性:对同一问题重新运行 /implement 不应报错;添加已存在的标签、移除不存在的 ready-for-agent 标签,以及再次发表评论都应可接受。认领评论必须写明工作分支(冲突的 Agent 会检查该分支的状态,而不是遗留的 worktree)。
释放认领
打开 PR(将工作交由审核)时,释放认领:gh issue edit N --remove-label in-progress。如果流程结束时没有打开 PR,则保留该标签;cleanup-merged-branches 清理器会释放已放弃的认领。成功时不要恢复 ready-for-agent;问题会在合并时关闭。
在可行时,于预先商定的关键节点调用 Skill 工具,并传入 "tdd"。
定期运行类型检查,经常运行单个测试文件,并在最后运行一次完整测试套件。
将工作提交到当前分支。
提交后,调用 Skill 工具并传入 "code-review",以审核这项工作。它只会读取已提交的工作。