Files

T

jj.wang 27ea9119a5 LXC deployment: live config for agentd-01, oregon rollback config, win10 helpers and board protocol in the repo

- 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.

2026-10-21 11:56:15 +00:00

3.8 KiB

Raw Blame History

看板协作协议（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 注入内存）。

取 state=Todo 且 assignee=window10 的工作项，按 GW-k 从小到大取一个；win10 上已有 codex 进程则本轮跳过（避免抢游戏/ADB）。
名称 + 描述 + 评论转成文本拼成 prompt 跑 codex exec；同一工作项第二次起 codex exec resume <thread> 只追加新评论。
结束后把最后一条消息贴回评论，按结果标签改状态与 assignee（见状态机）。

Claude 侧

工具：gwent-design/tools/plane-claude.sh（show / comment / state / assign / new / done）。
轮询 Waiting 与 Review（assignee=oregon）：回答问题、验收、改任务书或升级给 kappiee。新任务一律建工作项，不再用临时 brief 文件（紧急修复除外）。

通用规则

消息要短、要有结论；路径用仓库相对路径；大图只贴缩略拼图（≤1600px）。
不在评论里贴 token、密码、完整日志。
有疑问优先按任务书里的默认值继续并在评论里说明，而不是停下等人。

3.8 KiB Raw Blame History Unescape Escape