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。