关于 implement-afk-agentic
implement-afk-agentic 是一项自动处理已就绪工单并创建拉取请求的技能。遇到需求或设计决策未明确时,它会按规则停止,而不是自行补充假设。
主要功能
- 01检查工单与仓库前提条件
- 02从配置的目标分支创建分支
- 03按 TDD 垂直切片实现
- 04对未决工单停止并调整标签
- 05审查问题并创建拉取请求
适用场景
- 01实现已标记为 Agent 就绪的工单
- 02验收标准含糊时暂停处理
- 03完成审查后创建但不合并拉取请求
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nstaab1/ nathan-agent-skills --skill implement-afk-agentic安装后在 Claude Code 中输入/implement-afk-agentic确认已加载。
附带文件agents/openai.yamlreferences/afk-implementation.md
详细介绍
实现 AFK Agentic
在键盘前无人操作的情况下实现一个工单。工单是本次运行的人类输入:执行其中已明确的内容,并对未明确的内容停止。
在新仓库中配置此工作流或更改其生命周期时,请阅读 references/afk-implementation.md。
前置条件
编写代码前,请阅读问题跟踪器、分诊标签、领域文档和仓库说明。确认:
- 工单带有已配置的
ready-for-agent标签; - 工单填写了 Seams under test 部分;
- 验收标准可测试且明确无歧义;
- 仓库声明了 PR 目标分支/集成分支,或者可以明确确定远程默认分支;并且
- 可以执行问题跟踪器中所需的评论和更改标签操作。
任何前置条件未通过都会触发停止规则。未指定接缝的工单从未达到 AFK 就绪状态。
分支
按以下顺序解析 <base-branch>:
AGENTS.md、CLAUDE.md或docs/agents/中明确指定的目标分支或集成分支。- 本地
origin/HEAD符号引用。 - 远程仓库的默认分支。
明确的仓库工作流优先于远程默认分支。说明相互冲突时触发停止规则。
然后:
- 从
origin获取最新的<base-branch>。 - 从问题标题派生
<simple-title>:转换为小写,将每段连续的非字母数字字符替换为-,并删除开头或结尾的连字符。 - 从
origin/<base-branch>创建并切换到issue/<issue-number>-<simple-title>,使用不带#的数字问题编号。
只有当分支名称完全匹配,且其初始 HEAD 与 origin/<base-branch> 一致时,才开始构建。操作失败时停止运行,且不更改工单标签。
构建
逐个红绿垂直切片地执行 /tdd。工单的 Seams under test 部分就是接缝约定:仅在这些接缝处测试,无需再次确认。
持续运行针对性测试和类型检查。最后运行一次所有相关测试套件。
停止规则
一旦出现工单、规范、领域文档、ADR 和仓库说明均未明确解决的决策:
- 在工单上评论,准确说明歧义和发现的选项。
- 移除已配置的
ready-for-agent标签。 - 如果缺少事实,添加已配置的
needs-info标签;如果需要人工判断,则添加ready-for-human标签。 - 停止,不要创建 PR。
准确停止即表示运行成功。为了继续推进而臆造接缝或设计选择,则表示运行失败。
审查
以 origin/<base-branch> 为固定基准运行 /code-review。将其发现分为:
- 机械性问题。 有一种明确的修复方法,且没有权衡。修复问题并重新运行受影响的检查。
- 判断性问题。 涉及权衡、风格选择或任何有争议的内容。保持代码不变,并在 PR 正文的
## Reviewer: look here下逐项记录。
发布
提交更改,然后针对 <base-branch> 运行 /open-pr-agentic。创建 PR,但绝不合并。
完成的标准是:所有测试套件均通过;PR 已针对配置的分支创建;如果配置了相应状态,关联的问题正等待人工验证;并且 PR 正文醒目列出了所有判断性发现。