# 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`。