框架: skill官方规范核查落盘——9只功能skill加disable-model-invocation;递送机制定主会话内联(skills:预加载全量注入违反只带本次);规范要点入README

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

.claude/skills/continuation/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: continuation
 description: 续写整章的功能合同(scenario: continuation,写作槽位)。章结构/字数/伏笔纪律/输出契约的功能细节约束;writer 的身份纪律在 agent 文件,这里只管「续写这件事怎么做」。
+disable-model-invocation: true
 ---
 
 # 续写(scenario: continuation | purpose: generation | 槽位: 写作→writer)

.claude/skills/detect/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: detect
 description: 检测的功能合同(scenario: validation/consistency_check,检测槽位)。检查清单由 schema 字段自动生成——凡 aiContext 含 detection 的字段即检查项。
+disable-model-invocation: true
 ---
 
 # 检测(scenario: validation / consistency_check | purpose: detection | 槽位: 检测→detector)

.claude/skills/expansion/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: expansion
 description: 扩写的功能合同(scenario: expansion,写作槽位)。在既有场景内扩动作链/潜台词/感官细节,不灌水不加设定。
+disable-model-invocation: true
 ---
 
 # 扩写(scenario: expansion | purpose: generation | 槽位: 写作→writer)

.claude/skills/extract-knowledge/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: extract-knowledge
 description: 章后抽取的功能合同(scenario: extraction,分析槽位)。采纳后的新章→实体/关系/事件草稿+既有卡更新+状态提议;字段合同就是抽取 checklist。
+disable-model-invocation: true
 ---
 
 # 章后抽取(scenario: extraction | purpose: extraction | 槽位: 分析→extractor)

.claude/skills/parse-book/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: parse-book
 description: 全书解析/拆书的功能合同(scenario: full_parse,分析槽位)。存量作品→规划逆向(大纲/细纲)+实体;参考书再加范式拆取(脱敏)。逐章内环复用 extract-knowledge。
+disable-model-invocation: true
 ---
 
 # 全书解析/拆书(scenario: full_parse | purpose: extraction | 槽位: 分析→extractor)

.claude/skills/planning/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: planning
 description: 规划的功能合同(scenario: planning,规划槽位)。立项设定包/大纲/知识卡/状态的产出结构=schema 字段清单本身;续作修订同用此合同。
+disable-model-invocation: true
 ---
 
 # 规划(scenario: planning | purpose: planning | 槽位: 规划→planner)

.claude/skills/polish/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: polish
 description: 润色的功能合同(scenario: polish,写作槽位;含纠错/去AI味/角色声音修正)。只动表达层,禁改情节事实与对白语义。
+disable-model-invocation: true
 ---
 
 # 润色(scenario: polish | purpose: generation | 槽位: 写作→writer)

.claude/skills/quality-gate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: quality-gate
 description: 质量评分的功能合同(scenario: quality_gate,保护节点)。维度体系对齐专题-04:3 叙事关键定达标线+5 非关键出建议;rubric 与达标口径的单一来源。
+disable-model-invocation: true
 ---
 
 # 质量评分(scenario: quality_gate | 保护节点→judge | 上下文=writer 基线包,同证独立)

.claude/skills/rewrite/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: rewrite
 description: 改写的功能合同(scenario: rewrite,写作槽位)。按用户意见重写指定范围,范围锁定+事实锚+版本核对。
+disable-model-invocation: true
 ---
 
 # 改写(scenario: rewrite | purpose: generation | 槽位: 写作→writer)

README.md

@@ -67,6 +67,8 @@ agent-example/
 | detect | 检查清单由 aiContext 含 detection 的字段自动生成，schema 加字段检查项+1 |
 | quality-gate | 专题-04 维度体系的单一来源（3 叙事关键定达标线+5 非关键出建议） |
 
+**skill 官方规范对齐**（2026-07-09 按 code.claude.com/docs 核查）：frontmatter `name`（≤64，小写连字符）+`description`（≤1024，第三人称，写清做什么+何时用）；正文纯 markdown <500 行，附属文件（scripts/reference）从 SKILL.md 单层链接；progressive disclosure 三级（description 常驻 / 正文按调用加载 / 附属按需）。**功能 skill 递送给子代理**：官方三机制——子代理带 Skill 工具自主调用、frontmatter `skills:` 启动预加载、skill 侧 `context: fork` 反向驱动；但 `skills:` 预加载是"列出的全部注入"，与「一次只带本次功能」冲突——**定为主会话内联**：派发时读 SKILL.md 正文按拼装序塞进功能指令段位，子代理无需 Skill 工具（tools 受限不影响，我们的功能 skill 是纯 markdown 合同、无动态注入语法，内联零损失）。9 只功能 skill 已标 `disable-model-invocation: true`（防主会话误自动触发、description 不占常驻上下文，/name 手动仍可用）。
+
 **skill 形态公约**：每只 skill = `SKILL.md`（何时用+输入输出合同）+ `scripts/*.py`（**封装好的确定性实现**）。Python 3.12 + uv 管理的 `.venv`，依赖清单 `requirements.txt`（psycopg[binary] / requests / pyyaml / click），多用通用依赖不造轮子；PG 经 psycopg 直连（连通事实与凭据见 `db/连接信息.md`），New-API 调用禁系统代理（`trust_env=False`）；脚本失败原样报错不静默。现有三只流程型 skill（read-context/confirm/eval）以流程管控为主，涉库涉外步骤在 PG 版升级时同样下沉进脚本。
 
 **agent = 动脑的**（LLM 判断力，达标 prompt 即未来 agent_version.config 种子）——共 **5** 个，全 opus，与 [专题-06 §3 智能体三层清单](../design-docs/专题-06-元数据驱动的智能体架构.md) 一一对应、无自造型：**第一层开放槽位件 4 + 第二层保护节点件 1**。

meta/chains/README.md

@@ -29,6 +29,7 @@ agent 的提示词按**变化轴**拆三段，不做"一个 agent 一个大 prom
 ## 公约
 
 - 功能细节约束一律住功能 skill,agent 身份段只留跨功能部分;新增 scenario 先在此登记再建 skill;
+- 递送机制(阶段一):功能 skill 由**主会话内联**——派发时读 SKILL.md 正文塞进派发 prompt 的功能指令段位;不用子代理 `skills:` 预加载(它会把列出的全部注入,违反「一次只带本次功能」),子代理无需 Skill 工具;
 - 拼装位置:身份段之后、增量段之前(见 read-context 拼装序);同功能多回合间稳定,吃缓存;
 - purpose 由 scenario 映射(生成类→generation、抽取类→extraction、规划→planning、检测类→detection),purpose 定字段可见集(aiContext),scenario 定功能 skill 与 L0 形态,两者不混;
 - 链登记与实况漂移=G2 治理缺陷,发现即修。