在日常研发中，用 AI Coding Agent 修 Bug 常遇到两大痛点：一是模型缺乏边界感，没找准根因就乱改代码，甚至在“自写自审”循环里把分支改崩；二是重度依赖开发者守在终端前交互，无法无人值守批量交付。HiFox 研发团队构建了名为“狄仁杰”的单 Agent 缺陷修复状态机：过去 15 天承接了全团队已完成任务的 13%，最近派发的 100 个需求实现了 90% 的顺利交付率（原文链接：AI-native 实践：HiFox 团队如何让 Agent 自动修 bug | HiFox Blog ）。本文从工程视角拆解这套可复现的 10 步状态机设计、Runtime 选型与指令迭代经验。

一、真实工单拆解：51 分钟无人值守闭环

以团队内部一个真实 UI 缺陷为例：同事发现“清理构建缓存”弹窗中的临时目录列表无法滚动，在飞书群反馈后，另一位同事直接 @HiFox 任务助手建单，并指派给共享开发机（oh-my-pi Runtime + glm-5.3 模型）上的狄仁杰：

1. ​**诊断与起草方案（14 分 01 秒）**​：狄仁杰复现问题并查调用链，定位根因后严禁改业务代码，而是输出 3 个待定方案选项，停在第一道人工门前。
2. ​人工门 1 授权​：工程师审阅后回复 1A 2A 3A 【进入开发】，解锁产品代码写权限。
3. ​**实现、净室评审与验证（37 分钟）**​：狄仁杰完成编码与净室评审，自动拉起浏览器实测滚动效果，在任务会话中交齐代码 PR、预览链接、修复前后浏览器截图。
4. ​人工门 2 提测​：工程师核对截图与 PR 后回复 【提测】，代码自动合入开发分支并流转至自动化测试。

图 1：狄仁杰核心交付指标与 51 分钟工单耗时拆解

二、核心架构：10 步持久化状态机与阶段契约

普通角色 Prompt 拦不住模型跳步。狄仁杰由 state.json 持久化状态机驱动，主指令管控阶段权限与迁移条件，具体规范下沉到 7 个阶段专属 Skill：

阶段	专属 Skill	必交产物	代码写权限	关键纪律与熔断规则
1. 初始化	主指令内置	state.json	禁止	校验工作区与优先级基线分支
2-3. 诊断与方案	lattice-diagnose/lattice-idea	diagnosis.md/idea.md	禁止	复现找根因、读术语表起草方案，严禁改代码
4. 等待确认	主指令内置	状态历史快照	禁止	人工门 1：仅识别 【进入开发】 令牌
5. 探索与实现	lattice-explore/lattice-implement	findings.md/plan.md/plan-delta.md	允许	查调用链与测试，计划外变更记入 plan-delta.md
6-7. 评审与修补	lattice-review/lattice-implement	review-report.md	受控修补	Reviewer 视角检查，最多循环 6 次，超限停机转人工
8. 验证阶段	lattice-verify	日志与浏览器截图	只读验证	跑测试 + 真实界面验证，推评审分支出 Compare 链接
9-10. 等待与提测	lattice-deliver	ship-summary.md	允许合入	人工门 2：识别 【提测】 后合入开发分支转待测试

权威优先级遵循：​Agent 指令与人工决策 > 仓库 AGENTS.md、文档与分支政策 > 任务描述与运行证据​。每次阶段迁移均校验产物哈希与授权令牌，中断后直接读 state.json 续跑，回复末尾强制附带状态页脚：

{
  "taskId": "BOB-204",
  "phase": "waiting_qa_token",
  "reviewLoops": 1,
  "tokens": { "enterDev": "【进入开发】@idea#a94f2c" },
  "artifacts": ["diagnosis.md", "idea.md", "plan.md", "review-report.md"]
}
​

图 2：10 步状态机配合两道令牌门与评审熔断闭环

三、技术选型与 4 条指令迭代经验

1. ​单 Agent vs 多 Agent​：HiFox 的“小队”功能支持多 Agent 协作，但修 Bug 强耦合，单 Agent 挂载 7 个渐进式 Skill 比多 Agent 传话更快更省（与 Anthropic“慎用子 Agent”经验一致）。
2. ​Runtime 对比​：实测对比 Claude Code、Codex CLI、OpenCode 与 oh-my-pi 后，前几者偏向交互式终端，自带隐藏提示词或自动压缩重试，易干扰状态机。最终选 oh-my-pi 基于四点：指令与循环完全可控、支持导出 ACP session 回放归因、断点恢复与 state.json 咬合、轻量并发且开源可修。
3. ​四条实战铁律​：只用低风险任务验证过的 Skill；人工门从 7 道砍到 2 道（只留 【进入开发】 与 【提测】）；自然语言（“继续”“可以”）不解锁，只认显式令牌；UI 改动必须把截图直接贴进会话流。

四、如何在团队中复用这套工作流？

把 Agent 锁在个人终端会造成上下文孤岛。HiFox 提供共享任务上下文容器（公网 SaaS 免费、不限人数），让 Agent 并行接单，将方案、状态页脚与验证截图全部沉淀在任务页。你可以直接在 HiFox 创建工作区，接入开发机 Runtime，配置“诊断产物 + 两道令牌门 + 强制贴截图”规则，挑 5 个低风险 Bug 试跑验收。

图 3：在 HiFox 共享任务内指派 Agent 并留存证据