# Arcgentic：基于状态机的严格轮次驱动开发智能体框架

> Arcgentic将规划、开发+自审计、外部审计和引用跟踪四个角色转化为机械强制的状态机驱动工作流，通过质量门控和子智能体调度实现工程纪律的自动化执行。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-31T10:45:52.000Z
- 最近活动: 2026-05-31T10:56:45.175Z
- 热度: 150.8
- 关键词: 智能体框架, 状态机, 开发工作流, Claude Code, 质量门控, 审计, 子智能体, 工程纪律
- 页面链接: https://www.zingnex.cn/forum/thread/arcgentic
- Canonical: https://www.zingnex.cn/forum/thread/arcgentic
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：Arch1eSUN
- 来源平台：github
- 原始标题：Arcgentic: Agentic Harness for Rigorous Round-Driven Development
- 原始链接：https://github.com/Arch1eSUN/Arcgentic
- 来源发布时间/更新时间：2026-05-31T10:45:52Z

## 原作者与来源\n\n- **原作者/维护者**: Arch1eSUN (Arc Studio)\n- **来源平台**: GitHub\n- **原始标题**: Arcgentic: Agentic Harness for Rigorous Round-Driven Development\n- **原始链接**: https://github.com/Arch1eSUN/Arcgentic\n- **版本**: v0.2.2-alpha.3\n- **许可证**: MIT\n- **发布时间**: 2026年\n\n## 问题背景\n\n大型语言模型辅助开发工作流通常有严格的"意图"，但执行层面往往松散。开发者需要"记得运行审计检查"、"记得先扫描引用"、"记得更新技术债务"。随着项目推进，这种纪律往往会逐渐松懈。\n\nArcgentic的核心洞察是：**将纪律转化为机械执行**。如果门控检查失败，状态机拒绝推进。没有"记得做某事"——系统会强制执行，不通过就阻塞。\n\n## 核心架构\n\nArcgentic采用四层架构设计：\n\n### 第一层：技能（Skills）\n\n告诉Claude如何在特定角色中思考的Markdown文档，包括：\n- `using-arcgentic`: 入口技能\n- `plan-round`: 规划者角色\n- `execute-round`: 开发者+自审计角色\n- `audit-round`: 外部审计者角色\n- `track-refs`: 引用跟踪者角色\n- `orchestrate-round`: 编排者角色\n\n### 第二层：智能体（Agents）\n\n平台无关的子智能体定义，让编排者可以通过Task工具委派角色：\n- 编排者（orchestrator）\n- 审计者（auditor）\n- 规划者（planner）\n- 开发者（developer）\n- 业务分析师/设计师（BA-designer）\n- 代码审查者（CR-reviewer）\n- 契约验证者（SE-contract）\n- 经验编码者（lesson-codifier）\n- 引用跟踪者（ref-tracker）\n\n### 第三层：脚本（Scripts）\n\nBash实现的状态机和门控强制执行：\n- 状态管理（init/transition/pickup/validate）\n- 质量门控（handoff-doc/round-commit-chain/verdict-fact-table）\n- 工具库（yaml.sh, state.sh）\n\n### 第四层：钩子（Hooks）\n\n可选的提交级强制执行，项目可自主选择启用。\n\n## 四个核心角色\n\n| 角色 | 职责 | 关键产出 |\n|------|------|----------|\n| **规划者** | 读取范围→编写16节交接文档 | 详细的手off文档 |\n| **开发者** | 执行任务→内联自审计→产生N提交链 | 符合规范的提交链 |\n| **外部审计者** | 读取交接+提交链→编写裁决 | 带事实表的裁决文档 |\n| **引用跟踪者** | 每日git fetch→分类→维护INDEX.md | 更新的引用索引 |\n\n## 状态机设计\n\nArcgentic的核心是一个严格的状态机：\n\n```\nintake → planning → awaiting_dev_start → dev_in_progress → awaiting_audit → audit_in_progress → passed/needs_fix → closed\n                                                              ↑                                    |\n                                                              └──────── fix_in_progress ←──────────┘\n```\n\n每个状态转换必须通过`transition.sh`执行：\n1. 验证目标状态在当前状态的`next`列表中\n2. 运行所需的门控脚本（失败则拒绝转换）\n3. 更新`current_round.state`并追加到`state_history`\n\n尝试跳过状态？拒绝。尝试在审计前关闭？拒绝。尝试提交未经验证的事实表？拒绝。\n\n## 关键门控机制\n\n### 交接文档门控（handoff-doc-gate.sh）\n\n验证规划文档必须包含：\n- 明确的目标陈述\n- 范围内/范围外定义\n- 至少N个章节（可配置）\n- 验收标准\n\n### 提交链门控（round-commit-chain-gate.sh）\n\n验证开发产出必须形成：\n- N个提交的连贯链\n- 每个提交有明确的意图\n- 提交信息符合规范\n\n### 裁决事实表门控（verdict-fact-table-gate.sh）\n\n验证审计裁决必须包含：\n- 独立可验证的事实表\n- 每个事实可机械验证\n- 通过/需要修复的明确裁决\n\n## 单会话 vs 多会话模式\n\n**模式A：单会话（编排者驱动）**\n\n一个Claude会话加载`orchestrate-round`技能，通过Task工具在需要时委派子智能体。适用于：个人开发者、小型项目、概念验证。\n\n**模式B：多会话（人工角色分离）**\n\n多个Claude会话，每个加载不同角色技能，`state.yaml`作为会话间协议。适用于：团队开发、长期项目、严格审计独立性要求。\n\n两种模式共享相同的`state.yaml`模式和门控脚本，可以中途切换。\n\n## Python CLI工具包\n\nArcgentic同时提供PyPI发布的Python CLI工具：\n\n```bash\npipx install arcgentic\n# 或\nuv tool install arcgentic\n```\n\n主要命令：\n- `arcgentic audit-check`: 运行审计检查引擎\n- `arcgentic quality-gate-enforce`: 聚合质量门控\n- `arcgentic --help`: 查看完整命令列表\n\n## 成本纪律原则\n\nArcgentic严格遵守成本纪律：\n\n- ❌ 插件代码中无付费API调用\n- ❌ 无后台进程/守护进程/cron触发\n- ❌ 无自动云端LLM拉取\n- ✅ 所有LLM推理在Claude Code订阅内进行\n- ✅ 引用仅通过手动`git fetch`更新\n\n## 经验编码协议\n\nArcgentic包含独特的经验学习机制：\n\n1. **观察**: `lesson-codifier`子智能体扫描最近N轮\n2. **检测模式**: 同一问题出现3次→提议新mandate\n3. **验证**: 新颖的保留类型→声明经验迭代\n4. **编码**: 将经验编码为可复用的规则\n\n这一机制源自Moirai项目30+轮严格开发的经验总结。\n\n## 实际应用价值\n\nArcgentic的价值在于将"应该做"转化为"必须做"：\n\n1. **质量保证**: 每个产出都经过机械验证\n2. **知识保留**: 状态文件成为项目记忆的载体\n3. **团队协作**: 明确的角色边界和交接协议\n4. **可审计性**: 完整的历史记录和决策追溯\n5. **持续改进**: 经验编码机制推动团队学习\n\n## 路线图\n\n**当前 v0.2.2-alpha.3**: 核心状态机、10个技能、9个智能体、Python CLI、Claude Code/Codex插件\n\n**即将 v0.3.0**: OpenSpec摄取层、Superpowers市场集成、GitHub引用发现、丰富的执行轮次事实生成\n\n**目标 v1.0.0**: 在2-3个非Moirai项目通过Gate 3后发布稳定版\n\n## 总结\n\nArcgentic代表了LLM辅助开发工作流的一次重要进化——从"建议性"到"强制性"。通过状态机、质量门控和子智能体调度的组合，它将工程纪律从人的记忆转移到系统执行。对于追求高质量、可维护、可审计代码的团队，Arcgentic提供了一套可落地的技术方案。