框架: 能力清单定版7skill×5agent+上下文包六分区合同入README,公约'所有API/工具皆skill'入章程

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

CLAUDE.md

@@ -22,6 +22,7 @@
 
 ## 生成纪律
 
+- **所有 API/工具能力一律封装为 skill**（`.claude/skills/`）：数据库、嵌入、检索、导入、确认、组装全走 skill，主会话与智能体不得裸调外部服务（PG/New-API）或散写一次性工具脚本。能力清单见 README §四。
 - 组装上下文只走 `read-context`，按 schema 的 `aiContext` 裁剪；智能体不得自行翻仓库找上下文。
 - 未在 `装配.yaml` 绑定的 `knowledge/` 内容不得进入上下文。
 - 每次生成后向用户报：依据了什么、产出在哪、伏笔动作；等用户裁决。

README.md

@@ -24,7 +24,7 @@ Claude Code 在这里只扮演一个角色：**智能体运行时**——真架
 2. **运行噪音进 `works/*/评审/`**：检测报告、评分、上下文包回显都在这，.gitignore 挡住——可看、可复跑、不入历史。
 3. **待审与确认交给 git**：智能体产出一律不提交，`git diff` 就是候选评审界面；确认 = commit（提交信息带来源），丢弃 = restore；`git log` 天然是采纳台账。
 
-## 四、目录
+## 四、目录与能力清单
 
 ```
 agent-example/
@@ -42,6 +42,48 @@ agent-example/
     └── 评审/                ← 运行噪音(gitignored)
 ```
 
+### 能力清单（公约：所有 API/工具能力一律封装为 skill，不散写一次性脚本、不裸调外部服务）
+
+**skill = 动手的**（确定性工具能力，每只都是未来 muse API 的一道缝）——共 **7** 只：现有 3 + 按闭环步交付 4。
+
+| skill | 做什么 | 对应 muse API 面 | 状态 |
+|---|---|---|---|
+| read-context | 统一读取器：读装配绑定→按用途+aiContext 三级裁剪→组装六分区上下文包→裁剪清单回显 | 统一创作数据读取器（专题-06 §7） | 现有（文件版）；C4 升 PG 检索版（内部调 search） |
+| confirm | 唯一确认通道：确认=commit、丢弃=restore，仅创始人触发；PG 版加知识行草稿→已确认翻转 | 双轨提交 / 候选三决策入口 | 现有 |
+| eval | 质量收敛环：n=5、每轮只动一个变量、达标固化 `golden/` | 质量域 | 现有 |
+| db | `muse-example` 唯一数据库通道：ssh+容器 psql 封装（凭据按 `db/连接信息.md`），查询/DDL/DML 全走这，结果卡片式打印（=审查面） | 数据访问层 | A2 交付 |
+| import | 导入解析：txt→回目正则静态分章→作品/章行入库（调 db） | 导入解析旅程 | B1 交付；C8 用户旧稿复用 |
+| embed | New-API 嵌入封装：Qwen3-Embedding-8B、`dimensions:1024`、`--noproxy`、批量+失败重试 | AI 网关（嵌入） | B2 交付 |
+| search | 向量检索：意图→embed→pgvector 相似度召回→授权过滤（仅已确认+已绑定）+字段裁剪→带相似度分的结果集 | 知识检索 | B3 交付 |
+
+**agent = 动脑的**（LLM 判断力，达标 prompt 即未来 agent_version.config 种子）——共 **5** 个，全 opus，闭环内不新增。
+
+| agent | 做什么 | 用在 |
+|---|---|---|
+| planner | 设定包/大纲/细纲候选；字段全覆盖或标「字段存疑」；设定咬合自查 | C2 |
+| writer | 整章正文候选：2500–3500 字、AI 味黑名单零命中、新设定申报注释块 | C4 |
+| extractor | 两用场：**拆书**（B2，按库内 schema 逐章产知识行草稿+出处链）与**章后抽取**（C5）；与既有知识冲突标「⚠ 冲突待裁决」不覆盖 | B2 / C5 |
+| detector | 一致性/伏笔/设定违背检查，只出报告落 `评审/` | C4 伴随 |
+| judge | 六维 rubric 1–5 打分，引文证据制，≥4.0 达标 | C6 / eval 内 |
+
+分工判据：需要 LLM 判断的进 agent；确定性的取数、写库、外部调用、流程管控进 skill。agent 只经 skill 拿上下文与落库。
+
+### 上下文组装结构（read-context 的产出合同，操作细节以该 skill 为准）
+
+```
+上下文包(输入:作品+用途+目标;用途∈planning/generation/detection/extraction)
+├── 1 设定区    设定.md 四节,字段级裁剪(如 generation 不给「谜底与真相」「结局方向」)
+├── 2 规划区    主线一句话+当前卷细纲+近三章细纲;「未来卷粗纲」仅 planning 可见
+├── 3 状态区    状态.md 全文(伏笔台账/时间线/角色最新状态)
+├── 4 知识区    仅本章出场清单涉及的卡+其关联卡,不整库倾倒;卡内字段同样按 aiContext 裁
+├── 5 正文近邻  上一章末尾 1–2 场景原文 + 再前一章 frontmatter 摘要
+├── 6 公共范式  仅 装配.yaml 已绑定的库
+└── 尾 裁剪清单  被挡字段+原因 / 未绑定跳过的库 / 出场无关未选卡数 → 回显落 评审/(验收证据)
+(任务指令与输出合同由主会话派发时另附,不属读取器)
+```
+
+三级裁剪对齐专题-06：**字段级**（aiContext）/ **来源级**（装配绑定）/ **用途级**（purpose）。PG 版只改第 4 区取数方式（人工选卡 → search 召回+授权过滤），包结构不变。
+
 ## 五、一次续写怎么走
 
 1. 主会话读 `装配.yaml`（写作槽位绑了哪个写手、绑定了哪些公共库）；