mcpField
I
implement-afk-agentic

implement-afk-agentic

github.com/nstaab1Agent 工作流050 次安装3 周前更新
代码仓库

关于 implement-afk-agentic

implement-afk-agentic 是一项自动处理已就绪工单并创建拉取请求的技能。遇到需求或设计决策未明确时,它会按规则停止,而不是自行补充假设。

主要功能

  1. 01检查工单与仓库前提条件
  2. 02从配置的目标分支创建分支
  3. 03按 TDD 垂直切片实现
  4. 04对未决工单停止并调整标签
  5. 05审查问题并创建拉取请求

适用场景

  1. 01实现已标记为 Agent 就绪的工单
  2. 02验收标准含糊时暂停处理
  3. 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>:

  1. AGENTS.md、CLAUDE.md 或 docs/agents/ 中明确指定的目标分支或集成分支。
  2. 本地 origin/HEAD 符号引用。
  3. 远程仓库的默认分支。

明确的仓库工作流优先于远程默认分支。说明相互冲突时触发停止规则。

然后:

  1. 从 origin 获取最新的 <base-branch>。
  2. 从问题标题派生 <simple-title>:转换为小写,将每段连续的非字母数字字符替换为 -,并删除开头或结尾的连字符。
  3. 从 origin/<base-branch> 创建并切换到 issue/<issue-number>-<simple-title>,使用不带 # 的数字问题编号。

只有当分支名称完全匹配,且其初始 HEAD 与 origin/<base-branch> 一致时,才开始构建。操作失败时停止运行,且不更改工单标签。

构建

逐个红绿垂直切片地执行 /tdd。工单的 Seams under test 部分就是接缝约定:仅在这些接缝处测试,无需再次确认。

持续运行针对性测试和类型检查。最后运行一次所有相关测试套件。

停止规则

一旦出现工单、规范、领域文档、ADR 和仓库说明均未明确解决的决策:

  1. 在工单上评论,准确说明歧义和发现的选项。
  2. 移除已配置的 ready-for-agent 标签。
  3. 如果缺少事实,添加已配置的 needs-info 标签;如果需要人工判断,则添加 ready-for-human 标签。
  4. 停止,不要创建 PR。

准确停止即表示运行成功。为了继续推进而臆造接缝或设计选择,则表示运行失败。

审查

以 origin/<base-branch> 为固定基准运行 /code-review。将其发现分为:

  • 机械性问题。 有一种明确的修复方法,且没有权衡。修复问题并重新运行受影响的检查。
  • 判断性问题。 涉及权衡、风格选择或任何有争议的内容。保持代码不变,并在 PR 正文的 ## Reviewer: look here 下逐项记录。

发布

提交更改,然后针对 <base-branch> 运行 /open-pr-agentic。创建 PR,但绝不合并。

完成的标准是:所有测试套件均通过;PR 已针对配置的分支创建;如果配置了相应状态,关联的问题正等待人工验证;并且 PR 正文醒目列出了所有判断性发现。

评论

支持 Markdown