多智能体会话在同一份业务仓库上安全并行的运行手册：交接区 / 看板产物化 / 回执与复核 / 一卡一工作树 / 落地
개요
多个智能体会话在**上安全并行的运行手册，配套 agent-workflow-framework 使用。 两个（或更多）会话同时改一个仓库，最容易出的不是写错代码，而是：互相不知道对方在改什么、成果堆在各自分支上没人合、"做完了"没有可证伪的证据。本手册把这三件事变成机械可核对的纪律： - ：BOARD.md（做什么）/ PLAN.md（谁占了什么）/ LOG.md（发生过什么），文件当信封。 - ：卡数据在 cards/ .yaml，BOARD.md 由 board.py render 生成；手改会被下一次渲染覆盖。 - ：工人交 -receipt.md（人读）+ .receipt.json（机器读）；verify_receipt.py 给出 PASS / FAIL / DEGRADED 三态，只报告不阻断，并把结论记进 ledger/verdicts.jsonl。 - ：每张写卡一个 git worktree + 一个 card/ 分支，卡上声明"只准改哪些路径"，收口用 git 差分核对越界。 - ：分支并回主检出只有 ff / cherry-pick / 幂等 noop 三种计划，主检出脏、基点不明一律拒绝；远端写永远由人逐次授权。 把 skill/agent-collab-runbook 放进你的技能目录（或经 skillshare 同步）。技能只依赖 Python 3.11+ 标准库与 git，不需要任何第三方包。 main 受分支保护：禁强推、禁删除，并要求 checks 这个 CI 检查通过（管理员保留逃生口，单人维护不会被自己锁住）。 CI 做两件事：结构核查（必需文件齐备、Python 无语法错误、通用脱敏扫描 0 命中）与**。 1. 只有声明了哈希/命令的物证才算可证伪的证据；散文与结构化块冲突即判失败。 2. 复核只报告不阻断；FAIL 而仍判 Done 必须在卡上写理由。 3. 远端写（推送 / 建 PR / 发 issue / 全局安装）逐次单独授权——工具链里没有任何自动推送。
README
agent-collab-runbook
多个智能体会话在同一份业务仓库上安全并行的运行手册，配套 agent-workflow-framework 使用。
它解决什么
两个（或更多）会话同时改一个仓库，最容易出的不是写错代码，而是：互相不知道对方在改什么、成果堆在各自分支上没人合、"做完了"没有可证伪的证据。本手册把这三件事变成机械可核对的纪律：
- 公共交接区：
BOARD.md（做什么）/PLAN.md（谁占了什么）/LOG.md（发生过什么），文件当信封。 - 看板只经脚本改：卡数据在
cards/.yaml，BOARD.md由board.py render生成；手改会被下一次渲染覆盖。 - 回执两件套 + 复核器：工人交
-receipt.md（人读）+.receipt.json（机器读）；verify_receipt.py给出PASS / FAIL / DEGRADED三态，只报告不阻断，并把结论记进ledger/verdicts.jsonl。 - 一卡一工作树 + 工作集声明：每张写卡一个
git worktree+ 一个card/分支，卡上声明"只准改哪些路径"，收口用 git 差分核对越界。 - 落地只经
land，绝不推送：分支并回主检出只有ff/cherry-pick/ 幂等noop三种计划，主检出脏、基点不明一律拒绝；远端写永远由人逐次授权。
安装
把 skill/agent-collab-runbook 放进你的技能目录（或经 skillshare 同步）。技能只依赖 Python 3.11+ 标准库与 git，不需要任何第三方包。
目录
| 路径 | 内容 |
|---|---|
SKILL.md |
技能入口：要素表、冷启动五步、目录内容、输出纪律 |
references/handoff-protocol.md |
交接区完整协议（五列看板、卡的字段、LOG 纪律、工作树、回执、落地、敏感内容清单） |
references/receipt-contract.md |
回执契约：两件套、五种物证、四级判据等级、三态与退出码 |
references/acceptance-gates.md |
四查验收与远端写授权纪律 |
references/session-scheduling.md |
用任务看板做排班与唤醒（含"投递成功"的判定线） |
references/framework-cli.md |
与 agent-workflow-framework 的接口边界与命令签名 |
scripts/board.py |
看板渲染器（migrate/render/check/list/show/move/set/add） |
scripts/collab_console.py |
协作控制台（dispatch/collect/verify/close/status/budget/lease/rotate/land） |
scripts/verify_receipt.py |
只报告不阻断的复核器 |
scripts/collab_runbook.py |
框架入口转发 + --sync-check（技能源 ↔ 安装副本逐文件比对） |
docs/adr/ |
为什么这样设计（两套看板的权威、看板产物化、会话轮转与工作树、落地） |
.github/workflows/checks.yml |
CI 门禁：结构核查 + 三个自测（job 名 checks，也就是 main 分支保护要求的那个检查） |
.github/scripts/check_public.py |
结构核查与通用脱敏扫描（本地也能直接跑） |
CONTRIBUTING.md / SECURITY.md / CODE_OF_CONDUCT.md |
参与方式、安全问题报告范围、行为准则 |
质量门禁
main 受分支保护：禁强推、禁删除，并要求 checks 这个 CI 检查通过（管理员保留逃生口，单人维护不会被自己锁住）。
CI 做两件事：结构核查（必需文件齐备、Python 无语法错误、通用脱敏扫描 0 命中）与在干净检出里跑三个自测。
三条不变量
- 只有声明了哈希/命令的物证才算可证伪的证据；散文与结构化块冲突即判失败。
- 复核只报告不阻断；
FAIL而仍判 Done 必须在卡上写理由。 - 远端写（推送 / 建 PR / 发 issue / 全局安装）逐次单独授权——工具链里没有任何自动推送。
自测
python scripts/collab_console.py selftest # 26/26
python scripts/board.py --handoff selftest
python scripts/verify_receipt.py --selftest
许可证
MIT，全文见 LICENSE。
추천 도구
다른 키워드를 입력하거나 필터를 제거해 보세요.
설치
npx skillfish add pj1433139082-hue/agent-collab-runbook