graphagent-base-state-machine.md
2.42 KB
graphagent Base 状态机(Code Agent 视图)
graphagent 项目(repository /Users/yibo/Documents/lemonAI/graphagent)使用飞书 Base 作为任务状态唯一事实源。本文件是 Code Agent 对 2026-07-25-v2 单字段状态机的视图:只依据 状态 字段执行。
事实源
- Base:
https://wudaima.feishu.cn/base/[REDACTED] - Base Token:
[REDACTED](运行时由 cron job 注入,不写入规则文件) - 需求表:
tblnlIVgHNaQXLAL - Bug 表:
tblMy5bTXxJgudAi - 所有 Base 操作使用
lark-cli ... --as user。 - lark-cli 的 Base 操作使用
base子命令(如lark-cli base +record-list ...),不是bitable。
单字段状态机
需求 / Development Unit
| 状态 | 负责 Agent | Code 准入/动作 |
|---|---|---|
| 待办 | Planning | 不处理 |
| 规划中 | Planning | 不处理 |
| 待开发 | Code | 可认领;第一项写操作:进入 开发中 |
| 开发中 | Code | 实现中 |
| 自测中 | Code | 自测 |
| 待测试 | QA | 不处理 |
| 测试中 | QA | 不处理 |
| 待修改 | Planning | 不处理;由 Planning 重新规划/拆分后流回 待开发 |
| 已完成 | — | 不处理 |
Bug
| 状态 | 负责 Agent | Code 准入/动作 |
|---|---|---|
| 待规划 | Planning | 不处理 |
| 规划中 | Planning | 不处理 |
| 待修复 | Code | 可认领;第一项写操作:进入 修复中 |
| 修复中 | Code | 修复中 |
| 自测中 | Code | 自测 |
| 待测试 | QA | 不处理 |
| 测试中 | QA | 不处理 |
| 待修改 | Code | QA 失败后重新进入 修复中 |
| 已修复 | — | 不处理 |
认领规则
- 每轮只选一条记录;优先 Bug,其次需求。
- Product Outcome 主记录(父记录为空)不由 Code Agent 认领。
- 认领后第一项写操作必须是状态变更:Bug →
修复中,需求 →开发中。
流转约定
- 开发/修复完成且自测通过:需求 →
自测中→待测试;Bug →自测中→待测试。 - 自测失败或证据不足:回退
开发中/修复中,或按负责 Agent 改为待修改(Bug 归 Code;需求/DU 归 Planning)。 - 不自行设置为
已完成/已修复。 - 只读取/写入
状态字段,不再使用任何旧二次审核字段做分发。
自动执行
graphagent-code-development cron job (76750c908ef5) 每 10 分钟按上述规则扫描并认领任务。更新脚本见项目 doc/.tmp/update_code_cron.py。