jj.wang
27ea9119a5
- config/agentd.yaml is now the agentd-01 live config (state /var/lib/plane-agentd, logs /var/log/plane-agentd); config/agentd.oregon.yaml keeps the oregon dispatcher settings for rollback (cron/agentd-tick.sh uses it). - cron/agentd-tick-lxc.sh: the LXC cron entry. - tools/win10/: win10-ps.sh / win10-put.sh (vault client dir via AGENT_ACCESS_HOME); relative helpers_dir resolves against the repo, default tools/win10. - config/protocols/gwent-board-protocol.md: copy of gwent/design/board-protocol.md used in prompts. - agentd.log_dir (default state_dir). - smoke --watch: create the item and wait for the scheduled dispatcher instead of ticking locally.
48 lines
3.8 KiB
Markdown
48 lines
3.8 KiB
Markdown
# 看板协作协议（Plane 作为任务板与信箱）
|
||
|
||
看板 = https://plane.kappiee.com/kappiee/projects/79cb5a60-aa4f-4138-9864-1dd70426e665/issues/ ，工作项编号 `GW-k`。Gitea 只管代码（仓库、提交、PR），不再放任务。
|
||
|
||
## 账号 = 终端
|
||
- `kappiee` 用户（所有者，做决定）；`oregon` Claude（设计、派活、验收）；`window10` win10 Codex（执行）；`mac` 之后接入的 Mac 终端。
|
||
- 凭据键（Agent Vault 注入内存，不落盘、不进 win10、不进评论）：`PLANE_OREGON_API_TOKEN`、`PLANE_WINDOW10_API_TOKEN`（worker 以 window10 发帖）。API 头 `X-API-Key`。
|
||
|
||
## 状态机
|
||
`Backlog → Todo → In Progress → Waiting → Review → Done / Cancelled`
|
||
- Backlog：想法/未排期。Todo + assignee `window10`：交给 Codex，worker 下一个 tick 取走。
|
||
- In Progress：worker 已启动 codex 运行（worker 自动设置）。
|
||
- Waiting + assignee `oregon`：Codex 有待回答的问题或被阻塞（`[question]`/`[blocked]`），等 Claude 回答或升级给 kappiee。
|
||
- Review + assignee `oregon`：产出就绪（`[review]`），Claude 验收。通过 → Done；不通过 → 写意见，改回 Todo + `window10`。
|
||
- `[progress]`：worker 自动改回 Todo + `window10`，下一轮续跑。
|
||
- 需要用户决定时 Claude 把 assignee 改为 `kappiee`（state 保持 Waiting）。
|
||
|
||
## 工作项
|
||
- 标题 `T-xxx 简述`；描述 = 任务书（目标、允许的工具、不做的事、产出、验收线）。
|
||
- 评论 = 消息，作者由账号区分；正文首行保留角色标记 `[claude]` / `[codex]` / `[worker]`，worker 构造 prompt 时跳过 `[worker]` 评论。
|
||
- 结果标签（Codex 最后一条消息首行必须是其一）：
|
||
- `[review]` 产出完成，附：改动落点、产出路径、SHA、自检结果、如何重跑。
|
||
- `[question]` 需要回答才能继续，附"若无人回答，我默认会怎么做"。
|
||
- `[blocked]` 无法继续，附原因与已尝试的办法。
|
||
- `[progress]` 做了一部分，需要下一轮继续。
|
||
- 未标注首行按 `[review]` 处理。
|
||
|
||
## 标签、模块、关系、视图
|
||
- 标签：`model:astra`（gpt-6-astra，high）/ `model:sol`（gpt-6.1-sol fast，medium，默认）/ `effort:high` / `needs-game`（需要游戏在线，别与其他占用游戏的任务并行）。
|
||
- 模块（Modules）= 任务模块（T-007-0 …）；一个模块完成后 Claude 亲自验收再关闭。
|
||
- 依赖用关系 "blocked by"，被阻塞的项留在 Backlog，前置完成后再转 Todo。
|
||
- 视图：`等我决定`（assignee=kappiee 或 Waiting）、`Codex 执行中`（In Progress / Todo + window10）、`待验收`（Review）。
|
||
|
||
## Codex 侧（worker 自动化）
|
||
worker 跑在 Claude 所在的 Linux 机（`gwent-design/tools/board-worker-plane.py`，cron 每 2 分钟一次，token 只由 Vault 注入内存）。
|
||
1. 取 state=Todo 且 assignee=`window10` 的工作项，按 `GW-k` 从小到大取一个；win10 上已有 codex 进程则本轮跳过（避免抢游戏/ADB）。
|
||
2. 名称 + 描述 + 评论转成文本拼成 prompt 跑 `codex exec`；同一工作项第二次起 `codex exec resume <thread>` 只追加新评论。
|
||
3. 结束后把最后一条消息贴回评论，按结果标签改状态与 assignee（见状态机）。
|
||
|
||
## Claude 侧
|
||
- 工具：`gwent-design/tools/plane-claude.sh`（`show` / `comment` / `state` / `assign` / `new` / `done`）。
|
||
- 轮询 Waiting 与 Review（assignee=`oregon`）：回答问题、验收、改任务书或升级给 kappiee。新任务一律建工作项，不再用临时 brief 文件（紧急修复除外）。
|
||
|
||
## 通用规则
|
||
- 消息要短、要有结论；路径用仓库相对路径；大图只贴缩略拼图（≤1600px）。
|
||
- 不在评论里贴 token、密码、完整日志。
|
||
- 有疑问优先按任务书里的默认值继续并在评论里说明，而不是停下等人。
|