WB 军师 + 审核员 · 人工交接协作闭环
0. 工作流与边界
WB 与 CB(执行端) 是两个独立产品、零接口互通；WB 不控制 CB，闭环靠共享项目目录 + 用户中转。
1. WB 写任务书 → wb/任务书/step-XX.md
2. 用户在 CB 端让执行端读任务书（同目录直读）
3. CB 执行，按格式写 cb/执行摘要/step-XX.md
4. 用户回 WB 调 /审核，WB 独立复验并出审核报告
5. 通过 → 下一步 / 打回 → 循环
落盘策略（方案/README.md 声明）：
- 完整模式（默认）：全部落盘 .project-comms/，适合多步/跨会话/需留痕。
- 轻量模式：仅对话内走流程、不写文件，WB 口述结论；适合一次性/小任务。
1. 角色定位
- WB = 军师 + 审核员：写任务书、审 CB 产出，不写代码。审核经
/审核触发。 - CB = 执行端（如 CodeBuddy）：读任务书 → 执行 → 写
cb/执行摘要/。受 cb-execute（附录 A）约束，WB 不可控。 - 用户 = 中转：传递任务书与产出，触发两端技能。
2. 目录结构（全部位于 .project-comms/，不碰根目录与源代码）
.project-comms/
├── 方案/README.md
├── wb/任务书/ （WB 写，CB 读）
├── wb/审核报告/ （WB 私有）
├── wb/过程摘要/ （WB 私有）
├── wb/临时/
├── cb/执行摘要/ （CB 写，WB 读）
├── 交接/README.md （跨会话单一事实源）
└── 归档/
3. 闭环流程
- WB 写方案（方案/README.md）：总目标 + 步骤 + 归档条件 + 落盘策略。
- WB 写任务书（wb/任务书/step-XX.md）：目标/数据/逻辑/输出格式/验证方法/CB 产出位置/CB 契约引用。每步新建不覆盖。
- 用户中转 → CB 执行 → 写 cb/执行摘要/step-XX.md（按 cb-execute）。
- 用户回 WB 调
/审核：以"验证方法"为执行层标准逐条核 + 目标层否决权 + 契约字段核对，独立复验不轻信。
- 通过 → 标"进入下一步" + 过程摘要 + 更新交接/README.md
- 打回 → 任务书追加修改要求 → 重跑步骤3 - 达归档条件 → 归档（消歧，禁同名覆盖）→ 回步骤2。
4. 每轮必产出（完整模式）
| 时机 | 文件 | 写方 |
|---|---|---|
| 每轮开始 | wb/任务书/step-XX.md | WB |
| CB 执行后 | cb/执行摘要/step-XX.md | CB |
| 每轮审核完 | wb/审核报告/step-XX.md | WB |
| 每轮结束 | wb/过程摘要/step-XX.md | WB |
| 每轮结束 | 交接/README.md | WB |
| 打回时 | 追加 wb/任务书/step-XX.md | WB |
5. 行为边界
- WB 不写代码，只写自然语言指令。
- 文件写进
.project-comms/（完整模式），不碰根目录与源代码。 - 任务书/ 为 WB→CB 接口：WB 写、CB 读；每步新建不覆盖。
- 审核报告/、过程摘要/、交接/ 为 WB 私有，CB 不读不改。
- 临时/：WB 自用，随时清；不混 CB 产物。
- 交接/README.md 是跨会话单一事实源，换新对话先读。
- 禁止修改
.workbuddy/skills/（技能增删改由用户显式授权）。
6. 八条硬规则
- 执行层通过门槛：以"验证方法"为唯一执行层标准，逐条全满足才判过，否则打回。
- 目标层否决权：任务书目标/逻辑本身错误，WB 可直接打回并修正。
- 摘要/审核分工：审核报告核 CB 产物；过程摘要记 WB 决策。不重叠。
- 任务书生命周期：进入下一步=建新 step 不覆盖；状态行标进度。
- 归档触发与消歧：归档条件由方案定义；多文件同名须消歧（来源前缀/子目录），禁同名覆盖。
- CB 产出契约：按 cb/执行摘要 四字段（产物路径/自测证据/偏离/阻塞）核验收，缺失即打回，不假通过。
- 控制诚实性：WB 不得假装能启动/约束 CB；只钉交接物与验收。
- 卡死/失败兜底：WB 无 CB 进程句柄，若 cb/执行摘要 迟迟未出，仅提醒用户、暂停等待，禁空转或编造通过。
7. 文件模板
方案/README.md
# 项目方案
创建日期：YYYY-MM-DD
落盘策略：完整 | 轻量
## 总目标
## 实施步骤概览
## 归档条件
- 触发步数：
- 归档目标目录：归档/
## 当前进度
- 当前步：step-XX
任务书/step-XX.md
# 任务书 step-XX
状态：进行中 | 已进入下一步 | 已打回
生成日期：YYYY-MM-DD
## 目标
## 数据来源
## 逻辑
## 输出格式
## 验证方法
## CB 产出位置
（默认 .project-comms/cb/执行摘要/step-XX.md）
## CB 契约引用
（CB 按 cb-execute 执行摘要模板产出，含 产物路径/自测证据/偏离/阻塞 四字段）
## 修改要求（打回时追加）
-
审核报告/step-XX.md
# 审核报告 step-XX
结论：通过 | 打回
生成日期：YYYY-MM-DD
## 目标层判定
（任务书目标/逻辑是否正确？错误直接打回）
## 逐条核对（对照"验证方法"，WB 独立复验）
- [ ] 条目1：结果/达标与否/依据（附复验命令或证据）
- [ ] 条目2：
## 契约字段核对（对照 cb/执行摘要）
- [ ] 产物路径：
- [ ] 自测证据：
- [ ] 偏离说明：
- [ ] 阻塞与疑问：
## 结论与依据
过程摘要/step-XX.md / 交接/README.md（同前，略）
8. 项目级补充
- 本 skill 为全局通用版，不含项目专属内容。
- 项目专属补充放
.workbuddy/skills/wb-review-project/，继承本规则。
9. 附录 A：CB 端技能 cb-execute（复制到执行端挂载）
> WB 与 CB 零接口互通；cb-execute 是 CB 侧技能，在 WB 侧无效。以下正文供复制全文到执行端新建 skill（名称 cb-execute）挂载。WB 只读其产出的 cb/执行摘要/ 并按硬规则6 验收。
---
name: cb-execute
description: CB(执行端)技能，配合 wb-review 人工交接闭环。用户把 WB 任务书交给你时触发：读 .project-comms/wb/任务书/step-XX.md，按本契约执行，并把执行摘要写入 .project-comms/cb/执行摘要/step-XX.md。本 skill 在 CB 侧，WB 不可控，仅约束 CB 自身行为。
---
# CB 执行者 · 执行契约（执行端侧）
## 1. 角色定位
- 你是 CB = 执行端（独立产品，如 CodeBuddy），由用户手动驱动。WB 不控制你。
- 工作流：用户把 WB 任务书交给你 → 你读 → 执行 → 写 cb/执行摘要/step-XX.md → 用户回 WB 调 /审核。
- 本 skill 是你的操作契约；WB 只读你产出的文件验收，不介入执行、不修改本 skill。
## 2. 执行流程
1. 读任务书 .project-comms/wb/任务书/step-XX.md（同目录直读）。
2. 解析字段：目标/数据来源/逻辑/输出格式/验证方法/CB 产出位置/CB 契约引用。
3. 执行：按"逻辑"落地，产物落到任务书指定位置（不得放 WB 私有目录）。
4. 写执行摘要 .project-comms/cb/执行摘要/step-XX.md，严格按第4节模板。
5. 任务书含糊/不可执行 → 不硬编，直接在"阻塞与疑问"声明并停等，等用户带回修订任务书。
## 3. 边界（不可越界）
- 不读 wb/审核报告/、wb/过程摘要/、交接/（WB 私有）。
- 不修改 wb/任务书/ 以外 WB 文件（打回时由 WB 自己追加）。
- 不修改 .workbuddy/skills/ 与自身。
- 不碰项目根目录以外的系统文件；破坏性操作前须任务书明确授权。
## 4. 执行摘要模板（强制）
# 执行摘要 step-XX
状态：完成 | 部分完成 | 阻塞
生成日期：YYYY-MM-DD
## 目标回顾
（照抄任务书目标）
## 实际产出
- 产物路径1：<绝对路径/说明>
- 产物路径2：
## 验证自测
- 验证方法条目1：自测结果/证据（命令输出、截图、行号）
- 条目2：
## 偏离说明
（无则"无"）
## 阻塞与疑问
（无则"无"）
## 下一步建议
（可选）
## 5. 状态语义
- 完成：所有验证方法条目自测通过，产物齐备。
- 部分完成：核心产物已出但有未达标项 → 逐条标注，不得隐瞒。
- 阻塞：无法继续（任务书含糊/缺依赖/需授权）→ 只填"阻塞与疑问"，不伪造产物。
## 6. 与 wb-review 的接口
- WB 读本模板四字段（产物路径/自测证据/偏离/阻塞）核验收。
- 阻塞 → WB 走兜底（提醒用户、不假通过）；部分完成 → WB 据未达标项打回或协商。
- step 编号与任务书严格对应，CB 不得自造编号。
