From 8099b85f9dca3bd230fa8bc4f05b23478957727f Mon Sep 17 00:00:00 2001 From: lili Date: Thu, 9 Jul 2026 09:58:56 -0700 Subject: [PATCH] =?UTF-8?q?=E6=A1=86=E6=9E=B6:=20skill=E5=AE=98=E6=96=B9?= =?UTF-8?q?=E8=A7=84=E8=8C=83=E6=A0=B8=E6=9F=A5=E8=90=BD=E7=9B=98=E2=80=94?= =?UTF-8?q?=E2=80=949=E5=8F=AA=E5=8A=9F=E8=83=BDskill=E5=8A=A0disable-mode?= =?UTF-8?q?l-invocation;=E9=80=92=E9=80=81=E6=9C=BA=E5=88=B6=E5=AE=9A?= =?UTF-8?q?=E4=B8=BB=E4=BC=9A=E8=AF=9D=E5=86=85=E8=81=94(skills:=E9=A2=84?= =?UTF-8?q?=E5=8A=A0=E8=BD=BD=E5=85=A8=E9=87=8F=E6=B3=A8=E5=85=A5=E8=BF=9D?= =?UTF-8?q?=E5=8F=8D=E5=8F=AA=E5=B8=A6=E6=9C=AC=E6=AC=A1);=E8=A7=84?= =?UTF-8?q?=E8=8C=83=E8=A6=81=E7=82=B9=E5=85=A5README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- .claude/skills/continuation/SKILL.md | 1 + .claude/skills/detect/SKILL.md | 1 + .claude/skills/expansion/SKILL.md | 1 + .claude/skills/extract-knowledge/SKILL.md | 1 + .claude/skills/parse-book/SKILL.md | 1 + .claude/skills/planning/SKILL.md | 1 + .claude/skills/polish/SKILL.md | 1 + .claude/skills/quality-gate/SKILL.md | 1 + .claude/skills/rewrite/SKILL.md | 1 + README.md | 2 ++ meta/chains/README.md | 1 + 11 files changed, 12 insertions(+) diff --git a/.claude/skills/continuation/SKILL.md b/.claude/skills/continuation/SKILL.md index 09ecb20..4cacb47 100644 --- a/.claude/skills/continuation/SKILL.md +++ b/.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) diff --git a/.claude/skills/detect/SKILL.md b/.claude/skills/detect/SKILL.md index 6424693..3cca3f7 100644 --- a/.claude/skills/detect/SKILL.md +++ b/.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) diff --git a/.claude/skills/expansion/SKILL.md b/.claude/skills/expansion/SKILL.md index 5299aef..8fd087f 100644 --- a/.claude/skills/expansion/SKILL.md +++ b/.claude/skills/expansion/SKILL.md @@ -1,6 +1,7 @@ --- name: expansion description: 扩写的功能合同(scenario: expansion,写作槽位)。在既有场景内扩动作链/潜台词/感官细节,不灌水不加设定。 +disable-model-invocation: true --- # 扩写(scenario: expansion | purpose: generation | 槽位: 写作→writer) diff --git a/.claude/skills/extract-knowledge/SKILL.md b/.claude/skills/extract-knowledge/SKILL.md index 0251861..2005e2d 100644 --- a/.claude/skills/extract-knowledge/SKILL.md +++ b/.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) diff --git a/.claude/skills/parse-book/SKILL.md b/.claude/skills/parse-book/SKILL.md index a26c9dd..1eb249c 100644 --- a/.claude/skills/parse-book/SKILL.md +++ b/.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) diff --git a/.claude/skills/planning/SKILL.md b/.claude/skills/planning/SKILL.md index 3ad4567..d83e057 100644 --- a/.claude/skills/planning/SKILL.md +++ b/.claude/skills/planning/SKILL.md @@ -1,6 +1,7 @@ --- name: planning description: 规划的功能合同(scenario: planning,规划槽位)。立项设定包/大纲/知识卡/状态的产出结构=schema 字段清单本身;续作修订同用此合同。 +disable-model-invocation: true --- # 规划(scenario: planning | purpose: planning | 槽位: 规划→planner) diff --git a/.claude/skills/polish/SKILL.md b/.claude/skills/polish/SKILL.md index a0e8956..ba54fc3 100644 --- a/.claude/skills/polish/SKILL.md +++ b/.claude/skills/polish/SKILL.md @@ -1,6 +1,7 @@ --- name: polish description: 润色的功能合同(scenario: polish,写作槽位;含纠错/去AI味/角色声音修正)。只动表达层,禁改情节事实与对白语义。 +disable-model-invocation: true --- # 润色(scenario: polish | purpose: generation | 槽位: 写作→writer) diff --git a/.claude/skills/quality-gate/SKILL.md b/.claude/skills/quality-gate/SKILL.md index 0ef19be..b1e2b60 100644 --- a/.claude/skills/quality-gate/SKILL.md +++ b/.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 基线包,同证独立) diff --git a/.claude/skills/rewrite/SKILL.md b/.claude/skills/rewrite/SKILL.md index 40d493e..2f7dcd5 100644 --- a/.claude/skills/rewrite/SKILL.md +++ b/.claude/skills/rewrite/SKILL.md @@ -1,6 +1,7 @@ --- name: rewrite description: 改写的功能合同(scenario: rewrite,写作槽位)。按用户意见重写指定范围,范围锁定+事实锚+版本核对。 +disable-model-invocation: true --- # 改写(scenario: rewrite | purpose: generation | 槽位: 写作→writer) diff --git a/README.md b/README.md index cd840c9..dceac96 100644 --- a/README.md +++ b/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**。 diff --git a/meta/chains/README.md b/meta/chains/README.md index e48d7f1..ad3a8d6 100644 --- a/meta/chains/README.md +++ b/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 治理缺陷,发现即修。