feat: 加写给负责人的 Skill 选型面，并把「源码即生产」的工作方式写成制度

[zaurakworks]

落实负责人 2026-08-15 三项拍板：开发 worktree 放 agent-plugins-work/<分支>；生产检出由一条手动命令更新；选型面给负责人看，不给 Agent 看。

选型面是生成产物，不是手写文档

给 Agent 的那一份其实已经存在——运行端按 description 字段匹配触发，再写一份是第二份会漂的正文。给负责人的这份今天完全不存在：想知道一个 Skill 干什么，只能读它 3.9 KB 到 60 KB 的正文。

docs/skills-overview.md 由 scripts/skills-overview.ts 生成。手写的只有三句：

手写（存在 skillOverview）	推导
它替你做什么	版本 ← pluginVersions
什么时候用	上次复核／失效条件 ← skillLifecycle
你怎么知道它在起作用	体积与预算占比 ← 实测字节

符合性测试重新生成一次并逐字节比对，所以它不可能漂——文档一旦能被手改就会漂，而这正是 docs/lifecycle.md 要防的东西，选型面自己也得守这条。

它第一次生成就暴露了一件事

当前 12 个 Skill，共 208,420 字节，占复杂度预算 99.7%。

| Skill                      | 版本   |   体积 | 占预算 | 上次复核   |
| issue-workflow             | 0.3.18 | 60.1 KB | 29.5% | 2026-08-15 |
| adaptive-problem-solving   | 0.2.11 | 22.0 KB | 10.8% | 2026-08-15 |
| orchestrated-collaboration | 0.2.6  | 21.2 KB | 10.4% | 2026-08-15 |

issue-workflow 一个占 29.5%，是第二名的近 3 倍；总量已到预算的 99.7%。这正是老板视角该看见的，也是关联 agent-control#26（规则与 Skill 体系复杂度收敛）的直接输入。

源码即生产（新增第零节）

2026-08-15 实测：两个运行端把 Skill 解析到工作树本身，不是版本缓存。因此「已审源码 → 已安装内容 → 实际行为」中间那一环不存在——源码即行为。

负责人决定接受这个事实并调整工作方式，而不是造受控快照层（Claude 端可行、Codex 端不可行，半边隔离比不隔离更难查）：

位置	状态	谁动它
workspace/agent-plugins	永远是 origin/main 的干净检出	只有 plugin_release sync 快进它
workspace/agent-plugins-work/<分支>	git worktree，随便改	所有开发在这里

本 PR 自己就是第一个按新规矩做的：在 agent-plugins-work/skill-overview 的 worktree 里完成，生产检出全程停在干净的 main。

强制层次如实写明，不夸大：sync 在检出不干净或不在 main 时直接拒绝（第 2 层）；会话启动钩子事后提醒（第 2⁻ 层）；而「开发不要在生产检出里做」本身仍是纪律（第 4 层）——git 不阻止你在任何 worktree 里编辑。

验证

两份符合性测试通过。两个新门实测会失败：

手改选型面里的一个百分比  → docs/skills-overview.md 与来源不一致：它是生成产物，
                            请跑 node scripts/skills-overview.ts --write，不要手改
删掉一个 Skill 的三句话   → skillOverview 必须恰好覆盖全部 Skill：新增 Skill
                            必须同时给出写给负责人的三句话

配套的 plugin_release sync 在 agent-control 侧另开 PR。