协作式技能建造（元能力）

本技能把"与深度思考引导专家共创、拆解外部方法、立项建技能"的协作流程固化为可复用方法。需要新增或扩展一个技能（尤其当该技能"需要先想清楚需求再动手"）时，加载本技能，按五阶段推进，避免先入为主、避免绕过用户终审。

> 说明书（v1.9.7）：本文件是给模型读的执行指令本体；给人看的完整说明见 README.md（首屏速查）与 MANUAL.md（完整说明书：§0.5 技能概述 + §1–§12，含工作流规格表、检查点 CP1–CP7、失败编码 F-SCC-01–10、红线与联动）。三者内容同源，冲突以本文件为准。

触发条件（显式 · 先读这一节）

用户消息命中以下任一情形，立即加载并运行本技能，不要猜测、不要自行改用其他技能：

1. 从 0 新建一个技能 ——「帮我造个技能」「给 XX 做个技能」；
2. 把已有工作流/方法沉淀为技能 ——「把这套流程沉淀成技能」「这套做法做成 skill」；
3. 正式走协作流程建技能 ——「用共创方式建技能」「新建技能走协作流程」；
4. 已多轮使用的 SOP/操作手册要求定型 ——「SOP 总体定型」；
5. 建技能前想先找可借鉴的现成技能 ——「建技能前先看看有没有能借鉴的」；
6. 对本技能自身做增强扩展 ——「给 skill-co-creation 加 XX 机制」；
7. 批量建造多个同构技能单元 ——「批量建同构技能单元」「多个技能要共用底座」「一次建 N 个税种技能」；
8. 技能资产体检与清债 ——「清理孤儿文件」「references 未注册/零引用」「health_check 报 FAIL 怎么修」「技能体检」。

不适用（不进入五阶段，直接处理）：已有技能的细碎内容更新——判定标准：改动 ≤2 个文件、不新增流程步骤、不动铁律与门禁；纯文档写作 → 用交付类技能。

一、定位与适用

• 性质：用户级通用元能力，独立于任何业务技能体系（如 tpr 企税组合式技能），可跨项目复用。
• 适用：从 0 新建一个技能，或把一个协作/工作流沉淀为技能。典型信号：用户说"帮我造个技能""把这套方法沉淀成技能""用共创方式建技能"。
• 不适用：已有技能的细碎内容更新（直接改即可，无需走完整五阶段）；纯文档写作（用交付类技能）。

二、五阶段协作流程

流程总览（每阶段的「做什么／退出条件／判据落点」见各节，只列顺序不重复判据）：

阶段 0′ · 续建识别（v1.19.0 新增 · 按需）

> 触发：任何建造任务开工前先跑，成本极低（一次文件检查）。

1. 检查工作区 .workbuddy/tmp/ 与技能内 build/ 是否存在未完结的建造交接物（命名含 handoff / mission / decision-map）。
2. 有 → 先读交接物的 MISSION 锚定件（为什么造、给谁用、验收是什么）与 suggested skills 段，再续建；不重开需求、不重新盘问。
3. 无 → 正常进入前置 · 记忆体联动。
4. 交接物规格、四硬规格（落临时目录 / 必含 suggested skills / 按路径引用不重复 artifact / 强制脱敏）与 MISSION 模板 → references/resume_handoff_spec.md；2026-09-08 增补：交接物须带三轴交付状态声明（C-3）与source 四类标签（C-8）（fact/inference/assumption/gap 分离），详见该规格 §三轴交付状态 / §7。

> 与相邻机制的分工（不可混同）：个人记忆中枢 §E 管长期能力画像；outputs/ 双落盘管交付可见；交接物管这一炉建到哪一步了的断点态。交接物＝过程件，不算交付物、不走双落盘，只在工作区留指针。

前置 · 记忆体联动（够用不造闸）

做什么：建造前先查记忆体与既有技能，判「是否值得建」；并登记能力缺口台账。
退出条件：三出口判定完成（已有技能够用→终止不造／低频不建议／常用省词元→提建议待用户拍板）。

1. 搜常用场景：优先读 个人记忆中枢 知识中枢（memory_minutes 技能演进卡 §A 常用场景/使用频率）；未安装退回工作区 $MEM_ROOT/ 与 ~/.workbuddy/MEMORY.md；conversation_search 作辅助兜底。识别同类场景的频次与当前解决方式。
2. 三出口判定（按「节省词元、提高效率」）：已有技能可满足 → 指认既有技能名与覆盖点，直接复用，流程终止；场景低频/收益不明显 → 一句话说明理由不建议沉淀；常用且更省词元 → 主动提建议，附依据（频次＋预计节省量＋现流程痛点），由用户决定，不擅自立项。判定纪律：现有技能够用就不造 > 建了更整齐。
   - 与 宿主总编排器 的闭环：本请求若由 nexus 的 R3 裁决提名，nexus 已完成「三查防假缺口」，本闸只聚焦记忆体/历史技能去重，不重扫全域地图；若用户直接提出（未过 nexus），本闸须自行盘查，建造前建议先跑 宿主总编排器 拆解确认是否真缺（避免造已存在的东西＝假缺口）。要「下载现成能力」走 find-skills／marketplace-skill-installer（nexus R2），不进本五阶段。
   - 误报降敏（v1.14.0）：沉淀建议被用户裁决（接受/拒绝/忽略）后当轮在提案卡追加裁决记录（日期＋裁决＋一句话理由），不重开条目；同类提案连续 ≥2 次被拒或忽略 → 降敏一档，防反复打扰。
3. 两类台账（成双账本）：
   - FEAT · 能力缺口（记"想要什么"）：对话出现「能不能加个 XX／要是能自动 YY 就好了」时不论是否立项一律登记三字段（Requested Capability／User Context／Complexity Estimate S|M|L），记入记忆体 §B 待办区（FEAT-日期-序号），供 references/governance-loop/capability-map/ 盘点与 RICE 消费。只登记不承诺。
   - DNT · 已裁决不做（记"拍板不做什么"）：被明确否决的需求记三字段（Denied Capability／否决理由＋日期／复燃时的复核触发条件）。洁净纪律：已实现→不写 DNT／被否决→写 DNT 不写 FEAT。不进 RICE 排序池（不得因被否决过反而抬高优先级）。存放记忆体 §B（DNT-日期-序号），下次同类请求先翻先例再判定。
   • 消费接线（治"只记不滤"）：DNT 与 方法活库/ANTIPATTERNS.md 不得只作被动台账。凡生成改进候选/排序进化项之前过四步：① 查（按能力关键词查 DNT＋ANTI 卡，命中须逐条引用编号）② 滤（与命中项实质同一的候选直接剔除，写明剔除对象）③ 记（剔除动作当轮落痕：候选名/命中编号/日期，无留痕＝未过滤）④ 复燃（满足其"复燃触发条件"才允许重开，须原样引用上次否决理由并说明条件已变；条件未变仍重提＝违反洁净纪律）。
   • 为什么：重复讨论的最大来源正是「同一需求隔几个月被重新提、重新走一遍判定、重新裁决，且无人能引用上次结论」。③ 是把「我绕开了」变成可审计动作的关键（否则仍属自报）。

阶段 1 · 需求共创（三轮收敛提问法）

做什么：把待澄清项建模为设计树，每轮把当前 frontier 一次问完，逐步收敛到建造初稿。
判据全文 → references/co_creation_flow.md（R0–R3 细则／问题书写四条／双通道分流）。
退出条件：frontier 空（覆盖判据，非「问够三轮」）＋ 用户确认初稿「我理解的是 X，对吗」。

• R0 · 设计树与 frontier：① 建模——待澄清项按依赖关系组织成树，不是平铺清单；② frontier——每轮把整个 frontier 一次问完（每题编号 ＋ 必带推荐答案），作答后重算；③ 推迟规则——依赖本轮未决项的问题显式推迟并标注「被 X 阻塞」；④ 终止判据＝frontier 空。
• 为什么要 frontier：原三轮递减是按数量收敛（R1 全量→R2≤5→R3 确认），能说「R1 问了 12 个」，却说不出「还有没有没覆盖的分支」。frontier 空给了穷举一个可验收的终止条件。
• 与「三轮」的关系：三轮是轮数上限，frontier 空是覆盖判据，两者取交集；第 3 轮强制收口残余，未清项显式列为「开放问题清单」带入选型，不无限追问。
• 弱形式兜底：建不出树时不强求画树，只要求每题标注被哪个未决项阻塞——这是可机械检查的最低形式。
• R1 广域盘查：一次性列出所有待澄清项（含用户没想到的盲区），五维度：目标与边界／使用频率与典型场景／与既有技能的关系／输入输出形态与验收／纪律与禁区。可从记忆体与上下文推定的不问，只列「拟采用默认值 X，如有异议请否决」。
• 问题书写四条：① 一问一意不复合（复合问只得一半答案）② 题下给答案桩（用户填一个词即可）③ why this matters 只在易误读时加 ④ 最重要优先排序 ＋ 结尾一条 catch-all（「还有什么我没问到的」）。
• R2 取舍收敛：只提 R1 答案推不出的残余分歧与取舍项（范围裁剪、优先级排序、形态二选一），≤5 个；R1 已明确的不复述。
• R3 初稿确认：出建造初稿（一句话定位 ＋ 流程骨架 ＋ 关键纪律清单），以「我理解的是 X，对吗」闭环收口。
• 事实归 agent、决策归用户：能从环境查到的事实（既有技能、文件、版本、配置）自己去查，不问用户；只有涉及取舍与偏好的决策才问并等。探查进行中时其下游问题挂起，frontier 其余照问（两条流水线并行）。⚠️ 自查严格受【文件遍历禁令】约束，范围不明先问。
• 代答禁令（铁律）：Agent 不得代替用户回答自己提出的问题。grilling 类问题必须真等用户答。
• 与快通道的边界（必须划死）：快通道的「按推荐默认值内部推定」是用户已授权的默认推定（首个问题即采纳推荐＝显式 opt-in，且终审摊开全部推定项供逐条否决），不是「假装问过用户」。一个是授权后的推定，一个是未问先答。
• 参与度双通道分流（R1 每题附「推荐默认值＋推荐理由」）：快通道＝用户对首个问题即采纳推荐且无自定义 → R2/R3 由 Agent 按推荐内部推定，human-in-the-loop 收敛到阶段 5 终审一个节点（终审附「主要设计决策 × 推荐依据 × 参考方法」对照表，此节点不可省）；标准通道＝用户自己回答 ≥2 项或否决过任一推荐 → 正常走三轮；中途降级＝快通道中用户插话提新要求/质疑某默认值 → 即刻降回标准通道，已推定部分逐条列表摊开标「待否决/保留」，不静默沿用。通道判定一句话记入初稿头部。
• 边界纪律：本阶段只出「思路＋需求说明」，不替专长角色深挖流转实现、不替 UI 出美观方案，用户未明确要图时不生成 mockup。结构性设计问题（状态机对不对、路由表几层、字段该不该嵌套）允许一次性原型验证——三条硬门禁：顶部写一句待回答的问题／原型不进交付物／离开会话前落「结论＋折回哪个文件」。细则 → prototyping_gate.md。
• 引入专长角色补全设计：可引入对应领域专家视角补全设计（与「不替 UI 出美观」不冲突），共创者负责收敛为统一共识，不替任一专长越位实现。

阶段 1 尾闸 · 验证器存在性前置闸

> 在给某技能配自评自改回路（E1–E8 整套）之前先过三问，答案须写出来（不得心里过一下）：① 可检验性——该域任务能否被客观检验（采信层级：可机检 > 不可机检）② 成本可承受性——每次交付都跑得起才算，只跑得起一次的样本不算 ③ 检验者独立性——检验者能否被被检验者改写（能 → 转阶段 5「读数可写性标注」）。
> 任一不过 → 回路降级为「零点＋人判」，不得建自动评分回路。
> 实证反例（防"感觉能验"）：公文域-peilian 首跑实测——跑得最重最被信的"含量"轴把人的排序评反（Z=16.9／W=19.2），该轴已停用。公文写作/政策推演属"正确性靠论证判定"的域，是自评回路最不可靠的地方。
> 与 PAT-0029 的顺序：先过 0029（需求侧：值不值得建）→ 再过本闸（验证侧：验不验得动）。顺序固定，不合并。
> 不做什么：① 有天然 verifier 的域（代码可跑、计算可复算、账实可核对）不必降级 ② "没有 verifier"≠"不能改进"，只等于"不能自评自改"，人工评测照旧有效 ③ 不得据此否决人工评测（本闸主张恰是把权重挪给人）。判据全文 → references/evaluation_evidence_discipline.md。

阶段 1.2 · 决策票地图（按需启用）

> 触发：阶段 1 判定「本会话装不下」（R1 后未决项仍多／需外部调研／需原型验证／需用户外部动作）。它补的是能力上限——原流程对"装不下"的唯一出路是放弃，现在有第三条路：不放弃、不硬收敛，落持存地图跨会话推进。快通道优先，仅判定装不下才降级到地图。
> 五段：Destination／Notes／Decisions so far／雾区／越界区。四类票：research(AFK 读文档/取事实)／grilling(HITL 对话收敛)／task(机械活)／prototype(提 fidelity，HITL)；仅 research 允许一会话多票。
> 雾区三分纪律：① 判据＝能否现在精确陈述问题（能→立条目/立票，即使被阻塞；不能→入雾区，禁止预切成碎片）② 随决策推进毕业为正式条目并从雾区清除（一处存，不两处）③ 越界区永不毕业，已建条目若越界→关掉它＋在越界区留一行（gist＋为什么＋链回）。硬门禁：技能建成即清空雾区，未毕业须显式转 FEAT/DNT 或声明放弃。
> 单一真相源：resolution 正文记在票上，地图只存 gist＋指针。完成判定：「路已清晰，无可决之事」。载体＝工作区 .workbuddy/tmp/（可暂寄技能内 build/，建成即清）。模板与票制 → references/decision_map.md。

阶段 1.5 · 寻找借鉴技能（借鉴侦察）

> 触发：阶段 1 需求已确认后、进入建造前，先搜外部技能生态是否已有可借鉴方法——避免从零硬造。产出（候选清单）喂给阶段 2 拆解。

• 检索链路：① 提炼 1–3 个检索关键词（中英文各一组）② SkillHub 语义检索（首选） search?q=<kw>&limit=10 API，按 score 过滤（忽略 <0.05）③ 兜底 npx skills find（Vercel）／npx clawhub search ④ 无果明说"未找到"，降级为通用方法学拆解，不阻塞建造、不编造候选。
• 取正文链路（实测）：详情页是前端渲染，WebFetch 拿不到正文。可靠链路＝search 拿元数据 → api/v1/download?slug= 下载 zip → 解压读 SKILL.md。不要把"页面抓不到正文"误判为"技能没有说明书"。
• 候选三步漏斗：≤10 热度粗筛（评测报告权重最高，安全报告 malicious/risky 一票否决）→ ≤5 方法论去重（同质只留分高量大者）→ ≤3 拆解建议。任何一步仍超上限 → 列差异对照交用户裁决，Agent 不擅自裁剪（上限是"需用户介入"的触发线，非自由裁量权）。评分公式全文 → references/co_creation_flow.md §热度换算。
• 借鉴三查（防"吸收类假缺口"）：判"外部有、本地空白"前必过：① 外部原文确有 ② 本地 grep 无等价实现 ③ 非平台专有不可迁移。外部"有"≠本地"没有"（实证：v1.19.0 五角色提 44 条吸收提案，某条建议给 sync_version.py 增 --check——该模式 v1.15.0 就已存在，判空白时只比对外部原文、未 grep 本地）。
• 拉取纪律：拉本地须经用户确认，不静默安装；仅供拆解参考，非强制上线。借鉴≠照抄，仅提取可迁移组件。

阶段 1.5 尾闸 · 外部机制 → 先查自家实现再判互证

> 触发：阶段 1.5 检索到任何外部机制／论文／工具，评估是否借鉴之前。默认动作不是「先立卡」，而是四步：

• 与「借鉴三查」的分工（立闸前先 grep 存量）：三查管准入（外部确有→本地 grep 无→才算真空白）；本闸管退出（grep 命中后：判互证、不立卡、须留痕）。轴不同、互补——三查缺的正是「grep 命中之后怎么办」。
• 实证（2026-09-25 四源借鉴）：Skill0.5 讲半天的「反事实技能消融」，本体系 公文域-core 的 Z 零点基线一年前就在跑；第一反应「这是新机制得立卡」，grep 后判互证，两条路各白跑一轮。外部命名的价值不是带新做法，是给已有的自有实现一个名字。
• 反条件：① 互证 ≠「我们一直做对了」——自有实现也可能只在部分场景生效（含量轴曾评反人而停用）；② 本闸不替代 方法活库 §五 适配闸四问，只改判定顺序；③ grep 命中但无留痕 ⇒ 视同未执行。

候选三步漏斗（检索完成后的筛选纪律，v1.3.0）：多候选时不得整包丢给用户，按以下三步漏斗收敛：

1. 热度粗筛（≤10）：按下方「热度换算公式」计算总分排序取前 10，单因素权重 评测报告 > 下载量 > 收藏量 > 评论数；无评测报告的候选在呈现时标注"无评测报告"。
   > 热度换算公式（v1.3.1 实测定型，基于 SkillHub API 实测数据）：
   > - 数据可得性：search 接口只返回 downloads/installs/stars（无评论、无评测）；详情接口 /api/v1/skills/<slug> 才有 stats.comments 与 securityReports。
   > - 执行顺序：①先用轻量分 ln(1+D)+1.5·ln(1+S) 对全量候选初排，取前 12（留余量）；②逐个调详情接口取评论数与评测，补算总分复排；③截取前 ≤10。
   > - 对数归一（下载/收藏/评论量级差达 3 个数量级，必须压右偏）：h_D=ln(1+下载量)、h_S=ln(1+收藏量)、h_C=ln(1+评论数)，并在候选池内各维度 max-min 归一到 [0,1]（全池该维度为 0 时记 0）。
   > - 热度分 H = 0.6·D̂ + 0.3·Ŝ + 0.1·Ĉ。
   > - 评测分 E ∈ [0,1]：安全报告 benign=0.4；官方/权威评测 强推荐=1.0、推荐=0.8、中性=0.5、负面=0；无=0；作者 verified +0.1（封顶 1.0）。任一安全报告 status 为 malicious/risky → 一票否决，直接淘汰出漏斗。
   > - 总分 Score = 0.5·E + 0.5·H（评测报告为单因素最高权重项，0.5 > 下载 0.3）。
   > - 行为价值等效（直觉换算）：按市场典型转化率（收藏率≈0.3%~0.5%、评论率≈收藏的 1%~5%），1 条评论 ≈ 10~20 收藏 ≈ 2000~5000 下载的信号价值；对数归一 + 0.6/0.3/0.1 权重即该等级的工程近似。
   > - 兜底源字段对齐（Vercel/ClawHub）：stars→收藏、周下载→下载；无评论/评测则该维度记 0 并在呈现时标注；installs 不重复计入下载维度，仅在 downloads 缺失时代替。
2. 方法论去重（≤5）：逐一分析候选的方法论（解决思路 / 流程模式 / 核心机制），方法论相同或高度相似的聚为一簇，每簇只保留评测分最高且下载量最大的 1 个，其余标注淘汰理由（如"与 X 方法论同质，热度更低"）。去重后最多留 5 个供选择。
3. 拆解建议（≤3）：对留存候选逐个判断"是否值得进入阶段 2 拆解学习"，给出不超过 3 个的建议项，每项说明借鉴点（哪个可迁移组件值得提取）；用户可自定增删，不受建议项限制。
4. 超数量裁决纪律：任何一步若按上述标准筛选后仍超上限（如第 2 步去重后仍有 6 个方法论互异候选），不由 Agent 擅自裁剪——列明候选差异对照（方法论 / 热度 / 评测），交用户裁决取舍。三步的上限（10/5/3）是"需要用户介入"的触发线，不是 Agent 的自由裁量权。

> 取正文链路（v1.9.5 实测修正）：SkillHub 详情页是前端渲染，WebFetch 页面与 api/v1/skills/<slug> 详情接口（lightmake.site / api.skillhub.cn 均返回 405）拿不到正文。可靠链路＝search?q=<kw> 拿元数据 → https://lightmake.site/api/v1/download?slug=<slug> 下载 zip → 解压读 SKILL.md（包内通常还有 test-prompts.json、_meta.json）。不要把"页面抓不到正文"误判为"技能没有说明书"。

检索增效：关键词具体优于宽泛（"react testing" 优于 "testing"）；中英文都试；"deploy" 不行试 "deployment/ci-cd"；关键词不行按类目浏览（SkillHub https://lightmake.site/api/v1/categories、热门 https://lightmake.site/api/skills/top、详情 https://lightmake.site/api/v1/skills/<slug>）。

接入阶段 2：本阶段产出的"已选候选技能（slug/本地路径）"作为阶段 2 拆解输入——阶段 1.5 负责"找到并可选拉取"，阶段 2 负责"结构化拆解提取可迁移组件"。分工：1.5 是借鉴侦察，2 是借鉴消化。

> 纪律（吸收 find-skills 配套，v1.2.0 吸收）：①借鉴≠照抄——阶段 2 仅提取可迁移方法学组件，不照搬候选技能的资产结论；②拉取本地须先经用户确认候选，不静默安装；③客户端检测默认 WorkBuddy（$SKILLS_ROOT/），仅当 __CFBundleIdentifier 含 codebuddy 才用 ~/.codebuddy/skills/；④网络检索可能失败，失败即降级到"通用方法学拆解"，不阻塞建造；⑤借鉴三查（v1.19.0 新增 · 防"吸收类假缺口"）——判"外部有此机制、本地空白"之前必过三查：① 外部原文确有此机制；② 本地 grep 无等价实现；③ 非平台专有不可迁移。三查全过才算真空白。
> 为什么要这条（本轮实证）：v1.19.0 立项时，五个分析角色共提 44 条吸收提案，其中一条建议"给 sync_version.py 增 --check 只报不改模式"——该模式 v1.15.0 起就已存在。原因是判"空白"时只比对外部原文，未 grep 本地实现。外部"有" ≠ 本地"没有"，这是与"三查防假缺口"同构的失效，只是发生在吸收场景而非派活场景。

阶段 2 · 方法拆解（external-skill-learning）

若新技能要借鉴某个外部/已有技能的方法学：
- 调用等效的结构化拆解能力（v1.41.0 更名：原 旧体系模块 已并入本技能阶段 2）拆解目标技能，提取可迁移组件（提示词片段/流程模式/数据结构/设计原则），存入新技能的 references/；
- 标注来源（技能名+版本），不臆造；仅借鉴、不照搬资产结论。

阶段 3 · 立项创建（skill-creator）

做什么：按规范建技能本体 —— frontmatter → 骨架 → 自主进化八件套 → 语言规范 → 外壳四查 → 说明书四件套。
判据全文 → references/stage3_build_gates.md（五槽闸／语言六条／外壳四查／E1–E8 详判／验收六条细则／16 项 bump 清单要点）。
退出条件：version 已 bump、description 为标准字段且 ≤400 字、验收用例已先红后绿、说明书四件套齐。

• 首闸 · 改动分类与槽位闸：动手改任何技能行为之前先判两问 —— ① 走直落还是先影子仓（知识/资产→直落；行为→影子仓；纯机械对齐→直落＋记 CHANGELOG）；② 改哪个槽（触发语／正文规则／references／scripts／删除，五槽）。答不出槽记「其他（须写明）」不硬塞；改的槽须与失败的槽一致，槽位错配＝改动无效。 判据 → stage3_build_gates.md §一。
• 验收用例先于本体立：动作序为「写用例 → 跑红 → 建本体 → 跑绿」。三条硬要求：① expected 须来自独立真值源（用户原话／正样本／既有成熟技能的可观测行为），不得从待建 SKILL.md 推导——同义反复＝不可证伪；真值源须独立于被验者（truth_source: self 记 PART 档不阻断、不得计入「已验」）。② seam 必填（四值枚举：触发入口／路由判定／产出物结构／脚本实跑）——无正确 seam 即记为发现，是接口设计缺陷，回阶段 1/2 重界定。③ 纵向切片：一条用例→一次建造→再写下一条，禁批量写完再建。
• 基准盲区自检：每条核心机制须有一条专为它红的用例（拿掉该机制即转红）；无对应用例的机制＝不可验收机制，记为发现不是「以后再补」。验收报跨分布落差（同批用例在两个结构不同的分布下各跑一遍报落差），不只报通过率——单一分布结构上记不出移除某机制的代价。
• 新机制真被调用须独立追踪：改动声称新增的机制，须留下独立于改动者的调用痕迹；无痕迹⇒判「未验」，不得因「分数变好了」就认定是它起的作用。
• frontmatter 硬要求：必含 name／description／agent_created: true；description 必须是标准字段名（禁 display: 等别名替代）且承载可被 编排器脚本 build_manifest.py 的 classify() 解析的领域关键词——用别名会让技能误归「其他/工具」域 ⇒ 编排器找不到 ⇒ 假缺口。入库前跑 build_manifest.py --incremental 确认 domain 正确、summary 非空。
• 全局纪律声明门禁：新建/升格/重构/瘦身/升级均须在纪律区植入「全局纪律遵守声明」（指针指向记忆真相源，不重述全文）；豁免清单见 global_discipline_exempt.md，须用户确认入表，Agent 不得擅自放宽。
• 步骤 0 · 写前哨兵（强制）：动任何技能文件之前跑 python scripts/concurrent_write_guard.py <目录> [--fresh-min 15] —— ① 15 分钟内被写过 → 别动；② 三处版本一致（SKILL.md／CHANGELOG 首条／注册表）；③ CHANGELOG 倒序。铁律：同一时段只开一个会话改同一批文件。
• 资产经济性闸：新建可复用资产前先问「一次成本 vs 预期复用次数」，预期复用 < 回本点则不建、只留笔记；安全/合规/证据纪律类资产豁免。
• 自主进化八件套 E1–E8（默认植入）：E1 进化触发器／E2 验收评分卡（维度须带权重、不得等权）／E3 影子试运行（样本<3 不判胜出）／E4 熔断护栏（任何情况不可豁免）／E5 运行遥测（无遥测不作晋级依据）／E6 晋级门禁（严格提案制，无全自动通道）／E7 迭代优先级（先排序后改技能，三层 RICE→MoSCoW→Value-Effort）／E8 存量回检与补植。opt-out 仅在用户明确说「不需要」时生效，E4 任何情况保留。蓝图与参数 → autonomous_evolution_blueprint.md。
• 版本 bump 检查清单 16 项：主档只列必对齐五处（SKILL.md version＝description 标记＝正文 H1＝README／manifest.yaml／CHANGELOG 首条倒序／registry/unit.yaml／全库注册表），16 项全文 → version_discipline.md。动作：sync_version.py <目录> <新版本>（写）｜sync_version.py --all --check（批次收尾，异常须为 0，非 0 要么当轮修要么明示哪几个未修及原因）｜scan_versions.py（八类漂移一次扫出）。
• 提示词语言规范六条（创建时达标，不等交付审查兜底）：description 画像 ≤400 字＋单行版本标记（只由脚本写）／显式触发区块／单一称谓／短句结构化（单句≤100 字）／交叉引用显式到「文件＋节号」（禁「见上文/同源」，弱模型断链会静默跳过）／bump 后 grep 回查旧数字旧称谓。细目 → stage3_build_gates.md §二。
• 外壳四查：① 接口清洗（无用参数清掉，脏参数不让模型现场猜）② 隐性惯例显式化（技能里没写＝等于没有）③ 重复套路工具化（第二次出现的手工算→固化为 scripts/）④ 跨模型可用（关键路径在更弱一档模型上仍成立）。依据：StarHarness 冻结权重只进化外壳，三个 benchmark 提 20–35pp。细目 → stage3_build_gates.md §三。

阶段 3.5 · 联邦批量建造（F 包 · 按需启用）

> 触发：要建 ≥3 个同构单元（共享底座、各持权威、建成后需持续自进化）→ 启用；不满足则跳过，不强行套用。判例：13 个税种技能→启用；一个独立 PPT 技能→不启用。
> 核心命题：把深度从参数空间（本体写多厚）迁到上下文空间（可检索证据有多少）——本体瘦下来，深度交给运行期累积。
> 判据全文、回检表十三条、六件套逐条判据 → references/federation_batch_build.md §一/§七；方法学来源 PAT-0007（Zeva）。

六件套速查（F1–F6）：F1 瘦内核（SKILL.md 只放触发区块/路由铁律/证据检索入口，口径规则一律不进本体）｜F2 底座只读（base_mode: read-only，禁止复制底座内容进单元）｜F3 命名空间隔离（规则 ID 带单元码前缀，跨单元引用必须显式声明写入 cross_refs——只隔离不声明＝防了互渗换来互盲）｜F4 证据层脚手架（evidence/ 三件套；证据五元组含失效条件，缺失效条件判不合规；准入三闸＋遗忘降级）｜F5 warm-up 种子（3~5 条可核验种子，禁止生成期编造，编不如缺；种子类型三分须在 source_type 显性标注，不得伪装法条型）｜F6 验收改轨（弃一次性准确率，改 Evolve 曲线三指标：首答正确率单调不降/同类失效复发率=0/拦截率随里程碑上升；每里程碑样本≥10，样本<3 不判胜出，曲线回落即冻结进化回查根因）。

执行臂 · 先选路再执行：

> 选路纪律：已有成熟存量却另起炉灶新建＝反模式（丢存量深度/重复造轮子/两侧各漂移一份）。判例：增值税已有 某业务域枢纽技能 → 走 adopt，不新建。
> adopt 五道硬门禁（CP10/CP11）：自研 agent_created: true／有 version／非共享底座／落盘前强制整目录备份（失败即中断）／厚技能先 dry-run 经确认才 apply。adopt 不做三件事：不改版本号／不重写本体／不自动搬移存量 rules（只出 _migration_todo.md，防断链）。
> CP8 门禁：脚本未实跑出样例，不得进入批量建造。

四条硬边界（自进化不可失控）：R1 高风险域无在线试错权（税务结论错一次即执法风险）→ 只能在影子态爬坡，正式态必经专家监督｜R2 规范因果≠物理因果（反事实不可得）→ 用权威解读/司法判例替代实验，证据须过「反例未否证」｜R3 自进化会自我强化错误 → 三闸门＋遗忘降级，冲突不静默覆盖，须裁决后标 resolved｜R4 分布漂移（政策一变旧证据全失效）→ 每条证据带法源时效戳，EVT 事件触发批量复检。与 E1–E8 的关系：F 包不替代八件套，E3 承接 R1、E2 承接 F6、E4 熔断仍不可豁免。

执行序与两项进阶（细则 → federation_batch_build.md）：① 阻塞边与就绪前沿——每单元带 blocked_by，按 frontier 推进，无边即无边不强行造依赖（F3 的显式声明＋阻塞边＝把声明从文本升级为可排序结构）。② 宽重构 expand-contract——跨若干既有技能的统一改名/改字段/改契约不作纵向切片，走 expand（并存不断链）→ migrate 分批（按簇/目录）→ contract（删旧形式）；contract 落盘前整目录备份＋用户确认；契约期带过期时间/收口责任人，防永久双轨。（现有 evolution_audit.py --remediate 与 adopt 尾部追加只做了 expand，缺 contract——这是"补了新形式、旧形式永不删"的成因。）

子 agent 完成判据与抗抢跑：每个子任务以 completion criterion 收尾，判据两属性——clarity（能否判 done/not-done；模糊即 premature completion）与 demand（要求多少，驱动 legwork，不绑定步骤——全参考型文档靠"每条规则都过一遍"同样设穷尽门槛）。最强判据＝checkable + exhaustive。因果认知：可见的 post-completion steps 提供冲向终点的拉力，判据清晰度提供阻力——子 agent 看到后面还有 N 步会抢跑，唯一有效解药是把当前步判据 sharpen 到无法含糊。防御顺序（不可跳步）：① 先锐化边界 ② 边界不可约模糊且已观察抢跑才拆分序列隐藏后续步骤 ③ 隐藏只在真实上下文边界（handoff/子 agent 派发）有效，inline 调用什么也清不掉。强制范围：F 包子 agent 与阶段 5 终审必过，其余降级为推荐项。

阶段 4 · 接入与契约（按需）

• 若新技能属于某组合式体系（如 tpr 企税），更新总编排：①意图识别/分诊分支；②技能注册/路由表；③交接契约（入参/出参/确认状态）；并校验"三处一致性"（模板/脚本/指标库等多源同改）。
• 若是独立技能，在 SKILL.md 写清调用关系与边界，避免与既有技能环路。
• 单向委托链原则：协作层只回传上层，不反向互引造成环路。

阶段 5 · 终审交付（human-in-the-loop）

做什么：先机检、再双轴审查、后落实回检，🔴 清零才请求终审；终审后同轮报备五步。
判据全文 → references/stage3_build_gates.md §四 ／ references/lessons_and_cases.md（工作台 SOP／总体定型六病灶）。
退出条件：🔴 清零 ＋ 用户终审确认 ＋ 报备五步完成 ＋ 双落盘已呈现。

• 前置校验五项（不过即停，不消耗审查成本）：① 交付物路径可解析；② version 已 bump 且与 CHANGELOG 首条一致；③ 说明书套数齐全（标准档四件）；④ test-prompts.json 可解析；⑤ co_creation_lint.py 跑过（体量/description/悬空指针/双版漂移/陈旧命名/自述数字，见 references/distillation_method.md）。校验项必须可机读，含主观判断的不得塞进来（否则变成第二个审查门禁）。
• 质量门禁执行臂：scripts/quality_gate.py —— 纯确定性、零模型调用。四子命令 score（七维加权、归一到 100、通过线 85，任一维无 evidenceRefs 判 invalid 不通过）／gate（硬闸 HG-01~07，合规率须 1.0，缺项不默认绿）／repair（≤2 轮、退步即回滚）／check。契约正身＝交付完整性校验器 技能的 contracts/quality-gate.json（跨技能正身，不在本技能内）。跑不过不进人工审查——人工审查不查「能不能算出来」，只查「算得对不对」。
• 规则冲突扫描：交付物含 DO/DON'T 规则列表时，终审前跑 python scripts/rule-conflict-check.py <SKILL.md路径> 做 DO×DON'T / DO×DO / DON'T×DON'T 三模式交叉扫描，致命/严重冲突未清零不得终审（与 🔴 同级）。分工：审查查「本体质量」，本扫描查「规则自相矛盾」。
• 孤儿治理：python scripts/fix_reference_orphans.py --skill <目录> --scan 确认无 M2 未注册／M5 零引用；修复走同脚本配置驱动（幂等＋备份＋--verify 回跑验收），--strict 防「修了一半以为完了」。指南 → reference_orphan_guide.md。
• 双轴并行审查（材料互不可见）：

• 为什么要拆：两线原本串行、同 agent、共享上下文，规范类意见会稀释需求类意见；且回检只查 (a)，不查 (b)(c)——而 (b)(c) 恰是技能建造最常见的两类缺陷（顺手加规则、加了却加错位置）。
• 产出：两轴结论原样并列于 ## 规范轴／## 需求轴 标题下，不合并、不重排、不跨轴选「最严重项」（合并重排会再造一个统一分级清单，把拆轴收益抵消）。各轴自报总数与本轴最严重项。
• 快通道未产需求卡时：需求轴降级并在报告明写 no spec available，不得静默跳过。
• 三级标记：🔴 阻断（不修不交付）／🟡 建议修（附理由）／💭 可选。🔴 未清零不得请求终审；🟡 用户可拍板保留。
• 表达纪律：意见具体到文件＋行号；说清 why（「这会导致 X」）；建议而非命令；一份审查一次说完，不分轮挤牙膏；开头给总体印象并点名干净写法。
• 落实回检门禁（建造者自查）：「把约束写进文档」≠「在交付物中落实」。每条约束写成「位置＋交互＋禁止项」可指认形态，逐条指认，指不出即判未落实、当轮补齐；字段级——数据模型每字段须在交互层有录入入口，并列「字段 × 录入入口」清单。与需求轴分工：回检＝自查，需求轴＝审查者独立发现，两道都要过，不可互相替代。
• 读数可写性标注（终审读数必带）：凡读数（评分卡分／用例结果／遥测／审计判定）落库须标两项 —— ①谁产生 ②产生者能否改写该度量面。本体系脚本产出只作线索与体检（脚本与被评技能同在闭环内，真变强与放宽标准得同一分数且内部无法察觉）；人工判定可作终判；结构上独立的外部对照须写明独立在哪。E6「用户确认」不可被任何自动读数替代。 纯核算类读数（机检硬规范、账实核对）不适用。
• 收尾报备五步（漏做＝交付未完成）：① 跑 编排器脚本 build_manifest.py --incremental（地图增量重扫）；② 回写 个人记忆中枢 §E 技能卡 ＋ 工作区当日日志；③ 主动告知用户「新增/更新 X，会 Y，可配 Z」；④ 跑 方法活库/scripts/build_skill_card.py --skill <名> --id SC-XXXX（新建）或 --merge（刷新自动半；已建卡者必须刷，否则 lint_skill_card.py 判漂移 FAIL；无机制来源者不建卡、不降档）；⑤ 若新建/重建/移动了索引档 → 跑 build_asset_router.py ＋ --check（退出码 1＝存在不可达索引档，须当轮补宿主指针，不得留给下一轮）。造技能不回流＝编排器永远滞后技能库。
• 交付可见性（双落盘）：正式件落规范目录，同时在工作区 outputs/<产物名>/ 留可见副本并以工作区路径呈现——产物只落 $SKILLS_ROOT/ 等用户级/隐藏目录时 UI 产物面板不收录，用户看不到＝未交付。呈现后须确认用户可见，不得以「落盘成功/接口返回成功」等同于已交付。
• 元技能自省（不可豁免）：本技能定下的规则同样约束自身迭代 —— 本技能 bump 时须走与其他技能完全相同的阶段 5 门禁，不得因「改的是自己」而豁免。规范若只约束产出物、不约束建造者，等于没有规范。

阶段 6 · 状态登记与出口

> 为什么补这一阶段：前置的"够用不造"是入口闸门，只管生不管死。已实证：全库自研技能建成即进地图与注册表，无中间态、无退役通道；孤儿治理管的是引用孤儿，不是技能孤儿。

• in-progress 是关键创新：公开、可单独安装、不发文档页、可无预警改动或消失、允许 STUB（仅有设计笔记）——这是实验品的正式管理通道，有了它本地反馈循环才真实可跑，不必等"做完再发布"。
• 原子同步四处（改态必须同时改，任一失败即整体回滚）：能力地图／版本注册表／README 索引／本地链接。状态变更须同步记忆体 §E，否则新增一处漂移源。已建骨架卡者另须刷卡的自动半（build_skill_card.py --merge）。
• 索引档入口判据：本技能若有索引档（13 类白名单），宿主为 disable-model-invocation: true 时必须由至少一个可见技能转出（直转或经 方法活库/ASSET-ROUTER.md 路由中继），否则该索引档物理存在但永不进入上下文（＝假资产，同 references/ 孤儿）。判定与命令见阶段 5 报备 ⑤。
• 毕业与退役判据：in-progress → promoted（跑通 N 次、有验收用例、无 🔴）；promoted → deprecated（被替代、长期零调用、用户裁决弃用）。deprecated 需定期清仓，否则变垃圾场。
• 脚本：set_skill_state.py <目录> --state <四态> [--apply]（默认 dry-run；退出码 2参数/3无效或非自研/4备份失败/5原子同步中断/0成功或无变更；幂等可重跑）。四态义务矩阵 → references/skill_lifecycle.md。

调用权限位与生态位（阶段 6 登记项 · 对应 R10/R11）：
- 三值权限位：orchestration（只能由用户/显式点名触发、负责编排）／discipline（可被任何 agent 静默取用、只持纪律）／both（本技能即此类）。硬规则：orchestration 的技能不得被另一编排层当 discipline 静默取用，交叉调用只允许"显式点名交接"。本地化边界（不可照搬外部二值模型）：允许 宿主总编排器 显式派活给本技能，禁止的只是"静默取用"——照搬外域的"编排层不可互调"会切断已跑通的路。宿主支持度：当前作文档约定 ＋ 脚本可校验，不依赖宿主原生字段。
- description 按权属分文体：面向人（orchestration）写一行摘要并剥掉触发列表；面向模型（discipline）保留 rich trigger phrasing。判据：「模型能否自主地、有用地伸手够它」。
- 判据全文 → references/invocation_authority.md。

三、关键纪律 · 路由卡（判据全文 → references/discipline_cards.md）

> 本区只回答「什么时候必须想起哪条」，不回答「怎么做」——37 条纪律的判据全文在 discipline_cards.md，按症状查。
> 为什么这样拆：纪律曾全量在主档（22.8KB），与阶段正文、资产清单三处重复；且每条带完整判据+反例+边界 ⇒ 逐轮只增不减 ⇒ v1.40.0 主档超单文件读取上限 2.2 倍，模型读不完即规则漏读。淬炼方法见 references/distillation_method.md。

异常速查 → references/troubleshooting_card.md（已知异常「现象→根因→动作+兜底」表；卡内命中不了或反复复发的转 troubleshooting_loop.md 六段诊断循环）。

四、与既有能力的协作

脚本索引（全部只读或带快照/守恒断言；用法 python -S scripts/<名>.py --help）：

五、质量自查与停止条件

交付前逐项过，任一项指不出位置＝未落实、当轮补齐。（本表是速查；各项判据全文在对应 references，符号 → 后为落点。）

停止：用户确认交付即终止；共创阶段无法收敛核心目标时向用户说明卡点并建议降级（走阶段 1.2 决策票地图或拆分为多个小技能），不编造结论。

六、references 资产清单（路由表）

> 本表只回答「什么时候翻哪个文件」。判据全文在各文件内；本表不复述内容（复述＝双维护＝必然漂移）。
> 新增 references/ 文件的同一轮必须登记进本表，否则 fix_reference_orphans.py --scan 必报 M2 孤儿——「治理动作自己制造孤儿」的悖论靠这一条防。

待接线档（v1.35–v1.37 新建，方案已拟、正文未接）：self_recursion_capability.md §6.2 ／ observer_layer_spec.md §6 ／ observation_memory_topology.md §5 —— 均为等用户点头才落地的 diff，不得当作已实现能力引用。