BAIZE AI RESOURCE

面向 AI Agent 的工程化技能库与无人值守开发工作流

ArcReel

面向 AI Agent 的工程化技能库与无人值守开发工作流

ArcReel

资源介绍

ArcReel 仓库以 .agents/skills 目录承载一整套面向 AI 编码 Agent 的技能(skill),每个技能由 SKILL.md 定义触发条件与执行步骤,部分技能还附带脚本、参考文档和子 Agent 配置。它把软件交付拆成一条主流程:先用 grill-with-docs 或 grill-me 通过访谈打磨想法,必要时用 handoff 与 prototype 做可运行验证,再用 to-spec、to-tickets 把想法拆成带阻塞关系的工单,由 implement 驱动 tdd 逐片实现,最后用 code-review 从规范与规格两个维度审查改动。围绕这条主线,还提供 diagnosing-bugs 的反馈回路式缺陷诊断、improve-codebase-architecture 与 codebase-design 的深模块设计词汇、domain-modeling 的领域语言治理,以及 afk-team-workflow 这类无人值守批量执行流程:由 team-lead 规划 stage、委派 implementer 与 local-reviewer、串行 cherry-pick 并创建 PR,直到全部合并或明确暂停。它适合使用 Claude Code、Codex 等 Agent 工具的开发者与团队,用来把零散的提示词经验固化为可重复、可审查的工程流程。

核心能力

主流程技能编排

以 ask-matt 作为路由技能,将 grill-with-docs、prototype、to-spec、to-tickets、implement、code-review 串联为从 idea 到 ship 的主流程,并判定何时进入原型分支、何时拆分为多会话工单。

双轴代码审查

code-review 以用户指定的 commit、分支或 merge-base 为固定点,并行启动 Standards 与 Spec 两个子 Agent,分别检查是否符合仓库编码规范(含 Fowler 坏味道基线)与是否忠实实现原始 issue/spec。

无人值守团队执行

afk-team-workflow 让 team-lead 把 Spec 的子 issue 或一组显式 issue 划成最少的、可独立审查和合入的交付 stage,按 model-selection 为各角色选模型与 effort,委派 implementer 与未参与实现的 local-reviewer 在独立 worktree 中接力交付 issue commit,再串行 cherry-pick 到 stage branch,最后创建 draft PR 并执行 rebase merge,全程无人值守推进到全部合并或明确暂停。

反馈回路式缺陷诊断

diagnosing-bugs 要求先构造一个已经跑红、确定、快速、可无人运行的命令作为反馈回路,再复现、最小化、提出 3–5 个排序假设,最后以回归测试收尾。

深模块设计词汇

codebase-design 统一 module、interface、depth、seam、adapter 等术语,用删除测试判断模块是否值得保留,并给出可测试接口的三条设计规则。

批次复盘报告

afk-retrospective 读取 .afk/.jsonl 与 handoff 文件,核验问题是否仍存在,按价值与紧迫性输出中文单文件 HTML 报告到 .afk/reports/ 供用户裁决。

使用方法

  1. 把 ArcReel 中需要的技能安装到所用 AI 编码 Agent,不必启用整套工作流。

  2. 根据任务选择需求澄清、原型验证、规格拆分、TDD、代码审查或缺陷诊断流程。

  3. 提供项目目标、限制和验收标准,并在技能设置的确认节点审阅方案。

  4. 让 Agent 分阶段执行,最后检查代码差异、测试、评审意见与交付清单后再合并。

使用案例

从想法到合并的完整链路

使用场景有一个新功能想法,需要多会话完成

先用 grill-with-docs 通过访谈澄清想法并沉淀到 CONTEXT.md 与 ADR,再用 to-spec 与 to-tickets 拆成带阻塞关系的工单,逐个运行 implement 实现,最后用 code-review 对照规范与规格审查 diff。

无人值守批量推进 Spec

使用场景一个 Spec 下有多个子 issue 需要连续交付

运行 afk-team-workflow,team-lead 按依赖图划分 stage、为各角色选模型并请求 rebase merge 授权,implementer 与 local-reviewer 接力交付 issue commit,全部集成后创建 draft PR 并收敛到 green HEAD 后合并。

排查难以复现的缺陷

使用场景间歇性失败或两次已知良好状态之间的回归

使用 diagnosing-bugs,先构造一个对该缺陷跑红的紧凑反馈回路,复现并最小化到每个剩余元素都不可删,再提出排序假设定位根因,并以回归测试锁定修复。

包含内容

arcreel-source.zip
README-中文安装说明.md
LICENSE-AGPL-3.0.txt
THIRD-PARTY-NOTICES.md
SHA256.txt

常见问题

ArcReel 的 agent-browser 技能如何安装?
agent-browser 技能依赖通过 npm 全局安装的 agent-browser CLI,安装命令为 `npm i -g agent-browser && agent-browser install`;该技能通过 Chrome/Chromium 的 CDP 与无障碍树快照及紧凑的 `@eN` 元素引用进行浏览器自动化。
ArcReel 的 agent-browser 技能为什么只提供发现桩而不直接给出用法?
该 SKILL.md 是发现桩而非使用指南,运行任何 agent-browser 命令前需从 CLI 加载实际工作流内容:`agent-browser skills get core` 获取工作流、常见模式与排错,`agent-browser skills get core --full` 额外包含完整命令参考与模板;CLI 提供的内容始终与已安装版本匹配,因此指令不会过期。
ArcReel 的 afk-team-workflow 如何生成 batch-id?
Spec 批次的 batch-id 格式为 `spec---`,显式 issue 批次使用同格式的简短 slug;若 `.afk/` 已存在同一范围且未 `closed` 的账本,则暂停并让用户选择接管或重开,两种情况都先读 recovery.md。
ArcReel 的 afk-team-workflow 中 issue 何时算完成并解锁新 frontier?
只有 `OPEN` issue 可进入 stage 与 PR `Closes` 清单;其中 `ready-for-agent`、无他人认领且 blockers 已完成的 issue 进入 frontier,`ready-for-human` 及其被阻塞下游不进入 frontier。带 `Refs #` 的 commit 出现在远程 stage branch 后,该 issue 才算完成并可解锁新 frontier。
ArcReel 的 afk-retrospective 报告默认保存到哪里?
默认生成中文单文件 HTML,保存至 `.afk/reports//.html`,并保留历史报告;用户明确指定其他交付形式时遵从。报告标明 batch-id、生成时间和核验 SHA,正文与必要图示可离线阅读,不依赖远程脚本、字体或样式。