@namewta/speculo 1.0.1 → 1.0.3

package/template/skills/upstream-fork-sync/SKILL.md

@@ -2,82 +2,20 @@
 id: upstream-fork-sync
 type: skill
 name: upstream-fork-sync
-description: 上游同步评估：为持续二次开发的 Git fork 冻结已集成 checkpoint 与最新上游差异，生成 diff、冲突和定制风险报告；当任务涉及跟踪、评估或记录 fork 上游集成时使用。
----
-
-# Upstream Fork Sync
-
-以**检查点**为主导词。每个仓库始终分开记录：本次观测到的 upstream tip、可选本地 mirror tip，以及已经由产品分支历史证明完成集成的 upstream checkpoint。Fetch 或 mirror 变化不能推进集成 checkpoint。
-
-## 1. 解析上下文
-
-1. 从当前目录向上寻找并读取 `<Path>{roots.state}/workspace.json</Path>`，验证 `path_base` 和所有 roots，再读取 `<Path>{roots.config}</Path>`；无法唯一确定项目根时停止。
-2. 读取项目 `AGENTS.md` 及其作用域内规则。项目存在工程规范时读取适用入口。
-3. 将本 Skill 的唯一持久化根解析为 `<Path>{roots.state}/skills/upstream-fork-sync/</Path>`。独立运行只写该根；不得创建 workflow change 或 command 报告。
-4. 读取 [Repository contract](references/repository-contract.md)，确定仓库、refs、网络刷新和副作用边界。
-
-完成标准：项目根、Skill state 根、目标仓库集合和本次是否允许 fetch 都只有一个解释。
-
-## 2. 建立稳定配置
-
-读取 `<Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path>`。不存在时，只读发现 Git 仓库、remotes、默认产品分支和 upstream tracking refs，按 [Repository contract](references/repository-contract.md) 创建 schema v1 配置；无法从 Git 事实唯一判断的字段一次性询问用户。配置已存在时验证，不静默改写。
-
-读取 `<Path>{roots.state}/skills/upstream-fork-sync/customization-map.md</Path>`。不存在时创建最小稳定清单，记录 fork 必须长期保留的产品不变量和审查热点；无法从项目文档或代码证明的业务约束标记为待确认。该文件不接收运行 SHA、dirty paths、冲突或本次结论。
-
-完成标准：每个 repository id 唯一，所有项目路径和 refs 可解析，稳定配置与动态运行事实分离。
-
-## 3. 创建评估 change
-
-读取 [State schema](references/state-schema.md) 和 [Report contract](references/report-contract.md)，从用户主题生成小写 ASCII kebab-case topic，然后运行：
+description: Assess a requested fork/upstream checkpoint and produce reproducible diff, conflict, and customization-risk evidence.
 
-```bash
-node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> assess \
-  --root . \
-  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
-  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
-  --topic <topic>
-```
-
-- 默认离线使用本地 refs；只有用户明确要求刷新网络 refs 时添加 `--fetch`。
-- 只需预览完整冻结快照时添加 `--dry-run`，此分支不写 state 或 change。
-- 正常运行创建 `<Path>{roots.state}/skills/upstream-fork-sync/{date}-{topic}[-NN]/</Path>`，已有目录永不覆盖。
-
-完成标准：脚本退出 0，change 的 state 与两份报告完整发布，根 `state.json` 只在 change 发布成功后更新。
-
-## 4. 深化风险结论
-
-逐仓库检查报告中的 Git 确认冲突、自动合并重叠和定制风险路径。对每条高风险路径使用报告冻结的 SHA 执行精确 `git diff <base>..<target> -- <path>`，再与 `customization-map.md` 的稳定不变量映射。
-
-只把路径级证据支持的语义结论补入本 change 的报告。保持 Git 冲突、自动合并重叠、定制合同风险和 dirty-worktree 重叠为四个类别；零文本冲突不得表述为集成安全。
-
-完成标准：所有冲突和定制热点都有结论或明确未验证项，报告中的命令可以从冻结 SHA 复现。
-
-## 5. 返回后续选择
-
-返回 change 路径、仓库 checkpoint、观测 upstream SHA、风险摘要和未验证项。列出适合继续处理的已安装 Work，但不自动创建 workflow change、不调用 Work、不 merge、不 commit、不 push；后续路线由用户选择。
-
-完成标准：本次 Skill 在评估 change 完整后停止，用户能用冻结产物自行选择下一 Work。
-
-## 6. 记录外部集成
+---
 
-只有其他 Work 已完成集成且用户要求更新 checkpoint 时进入此分支。读取目标 change state，并运行：
+# upstream-fork-sync
 
-```bash
-node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> record-integration \
-  --root . \
-  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
-  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
-  --change <change> \
-  --repository <repository-id> \
-  --merge-commit <full-sha> \
-  --upstream-sha <full-sha> \
-  --verification '<command>: exit 0'
-```
+This file is the routing entry. Read [`references/entry-procedure.md`](references/entry-procedure.md) only after this skill is selected. Read a named reference there only for the active branch.
 
-该入口只在 merge commit 可从产品 ref 到达、目标 upstream SHA 是其精确非第一父节点且匹配 change 冻结目标时更新状态；它不执行集成。
+## Scope
 
-完成标准：change state 和根 checkpoint 都已原子重读，实际 Git 历史与记录一致。
+- Trigger: Assess a requested fork/upstream checkpoint and produce reproducible diff, conflict, and customization-risk evidence.
+- Output and write owner remain those declared by the entry procedure and the owning command/workflow.
+- Do not infer missing scope, credentials, target, or authorization.
 
-## 停止条件
+## Stop
 
-目标 ref 缺失、保存的 checkpoint 不在产品历史、checkpoint 不在当前 upstream 历史、存在多个 merge-base、配置越界或状态 schema 非法时，停止且不移动 refs、不发布部分 change、不推进 checkpoint。返回准确 repository id、路径、refs 与 SHAs。
+Stop before side effects when the required input, owner, reference, confirmation, schema, or recovery evidence is missing; report the exact blocker and preserve any dry-run evidence.

package/template/skills/upstream-fork-sync/references/entry-procedure.md

@@ -0,0 +1,78 @@
+# Entry procedure
+
+# Upstream Fork Sync
+
+以**检查点**为主导词。每个仓库始终分开记录：本次观测到的 upstream tip、可选本地 mirror tip，以及已经由产品分支历史证明完成集成的 upstream checkpoint。Fetch 或 mirror 变化不能推进集成 checkpoint。
+
+## 1. 解析上下文
+
+1. 从当前目录向上寻找并读取 `<Path>{roots.state}/workspace.json</Path>`，验证 `path_base` 和所有 roots，再读取 `<Path>{roots.config}</Path>`；无法唯一确定项目根时停止。
+2. 读取项目 `AGENTS.md` 及其作用域内规则。项目存在工程规范时读取适用入口。
+3. 将本 Skill 的唯一持久化根解析为 `<Path>{roots.state}/skills/upstream-fork-sync/</Path>`。独立运行只写该根；不得创建 workflow change 或 command 报告。
+4. 读取 [Repository contract](repository-contract.md)，确定仓库、refs、网络刷新和副作用边界。
+
+完成标准：项目根、Skill state 根、目标仓库集合和本次是否允许 fetch 都只有一个解释。
+
+## 2. 建立稳定配置
+
+读取 `<Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path>`。不存在时，只读发现 Git 仓库、remotes、默认产品分支和 upstream tracking refs，按 [Repository contract](repository-contract.md) 创建 schema v1 配置；无法从 Git 事实唯一判断的字段一次性询问用户。配置已存在时验证，不静默改写。
+
+读取 `<Path>{roots.state}/skills/upstream-fork-sync/customization-map.md</Path>`。不存在时创建最小稳定清单，记录 fork 必须长期保留的产品不变量和审查热点；无法从项目文档或代码证明的业务约束标记为待确认。该文件不接收运行 SHA、dirty paths、冲突或本次结论。
+
+完成标准：每个 repository id 唯一，所有项目路径和 refs 可解析，稳定配置与动态运行事实分离。
+
+## 3. 创建评估 change
+
+读取 [State schema](state-schema.md) 和 [Report contract](report-contract.md)，从用户主题生成小写 ASCII kebab-case topic，然后运行：
+
+```bash
+node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> assess \
+  --root . \
+  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
+  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
+  --topic <topic>
+```
+
+- 默认离线使用本地 refs；只有用户明确要求刷新网络 refs 时添加 `--fetch`。
+- 只需预览完整冻结快照时添加 `--dry-run`，此分支不写 state 或 change。
+- 正常运行创建 `<Path>{roots.state}/skills/upstream-fork-sync/{date}-{topic}[-NN]/</Path>`，已有目录永不覆盖。
+
+完成标准：脚本退出 0，change 的 state 与两份报告完整发布，根 `state.json` 只在 change 发布成功后更新。
+
+## 4. 深化风险结论
+
+逐仓库检查报告中的 Git 确认冲突、自动合并重叠和定制风险路径。对每条高风险路径使用报告冻结的 SHA 执行精确 `git diff <base>..<target> -- <path>`，再与 `customization-map.md` 的稳定不变量映射。
+
+只把路径级证据支持的语义结论补入本 change 的报告。保持 Git 冲突、自动合并重叠、定制合同风险和 dirty-worktree 重叠为四个类别；零文本冲突不得表述为集成安全。
+
+完成标准：所有冲突和定制热点都有结论或明确未验证项，报告中的命令可以从冻结 SHA 复现。
+
+## 5. 返回后续选择
+
+返回 change 路径、仓库 checkpoint、观测 upstream SHA、风险摘要和未验证项。列出适合继续处理的已安装 Work，但不自动创建 workflow change、不调用 Work、不 merge、不 commit、不 push；后续路线由用户选择。
+
+完成标准：本次 Skill 在评估 change 完整后停止，用户能用冻结产物自行选择下一 Work。
+
+## 6. 记录外部集成
+
+只有其他 Work 已完成集成且用户要求更新 checkpoint 时进入此分支。读取目标 change state，并运行：
+
+```bash
+node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> record-integration \
+  --root . \
+  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
+  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
+  --change <change> \
+  --repository <repository-id> \
+  --merge-commit <full-sha> \
+  --upstream-sha <full-sha> \
+  --verification '<command>: exit 0'
+```
+
+该入口只在 merge commit 可从产品 ref 到达、目标 upstream SHA 是其精确非第一父节点且匹配 change 冻结目标时更新状态；它不执行集成。
+
+完成标准：change state 和根 checkpoint 都已原子重读，实际 Git 历史与记录一致。
+
+## 停止条件
+
+目标 ref 缺失、保存的 checkpoint 不在产品历史、checkpoint 不在当前 upstream 历史、存在多个 merge-base、配置越界或状态 schema 非法时，停止且不移动 refs、不发布部分 change、不推进 checkpoint。返回准确 repository id、路径、refs 与 SHAs。

package/template/skills/writing-great-skills/SKILL.md

@@ -2,84 +2,22 @@
 id: writing-great-skills
 type: skill
 name: writing-great-skills
-description: 编写和编辑高质量 skills 的参考指南 — 使 skill 行为可预测的词汇和原则。
+description: Reference guidance for explicitly requested skill authoring or review; never auto-trigger.
 disable-model-invocation: true
 ---
 
-一个 skill 的存在是为了从随机系统中提取确定性。**可预测性** —— 即 agent 每次运行时采取相同的*流程*，而非产生相同的输出 —— 是根本美德；以下每个杠杆都为此服务。
+# writing-great-skills
 
-**加粗术语**在 [`GLOSSARY.md`](GLOSSARY.md) 中有定义；可查阅获取完整含义。
+This file is the routing entry. Read [`references/entry-procedure.md`](references/entry-procedure.md) only after this skill is selected. Read a named reference there only for the active branch.
 
-## 调用方式
+## Scope
 
-两种选择，付出不同的代价：
+- Trigger: Reference guidance for explicitly requested skill authoring or review; never auto-trigger.
+- Output and write owner remain those declared by the entry procedure and the owning command/workflow.
+- Do not infer missing scope, credentials, target, or authorization.
 
-- **模型调用** skill 保留 **description**，因此 agent 可以自主触发它，*并且*其他 skills 也可以触达它（你也仍然可以手动输入其名称）。它会产生**上下文负载** —— description 每轮都留在窗口里。实现机制：省略 `disable-model-invocation`，并编写一个面向模型的 description，包含丰富的触发短语（"当用户想要……、提及……时使用"）。
-- **用户调用** skill 将 description 从 agent 的触达范围中移除：只有你手动输入其名称才能调用它 —— 其他 skill 也无法触达它。零上下文负载，但它消耗**认知负载**：*你*是必须记住它存在的索引。实现机制：设置 `disable-model-invocation: true`；`description` 变为面向人类的 —— 一句摘要，去掉触发列表。
+For an authorized review or rewrite of a skill/document, read [`references/document-contract.md`](references/document-contract.md) before editing. Its fidelity checks apply to any document; this does not change this skill’s explicit-only activation policy.
 
-只有当 agent 必须自行触达该 skill，或其他 skill 必须触达它时，才选择模型调用。如果它只需手动触发，则设为用户调用，不付出任何上下文负载。
+## Stop
 
-当用户调用 skills 多到你记不住时，积累的认知负载可以通过一个**路由 skill** 来解决：一个用户调用的 skill，列出其他 skills 以及何时使用它们。
-
-## 编写 description
-
-模型调用的 **description** 做两件事 —— 说明该 skill 是什么，并列出应触发它的**分支**。每个词都会增加**上下文负载**，所以 description 比正文更应该被严格修剪：
-
-- **将 skill 的主导词前置** —— description 是它发挥调用作用的地方。
-- **每个分支一个触发器。** 给单个分支换不同说法的同义词属于**重复** —— "使用 TDD 构建功能……要求测试优先开发" 是一个分支写了两次。收拢它们；只保留真正不同的分支。
-- **删除正文中已有的身份信息。** 将 description 限制为触发器，以及任何"当另一个 skill 需要……"的触达子句。
-
-## 信息层级
-
-一个 skill 由两种内容类型构成 —— **步骤**和**参考** —— 它们可以自由混合：一个 skill 可以全是步骤、全是参考，或两者兼有。核心决策是使用哪种以及每种在**信息层级**上的位置，该层级按 agent 对材料需求的紧急程度排序：
-
-1. **skill 内步骤** —— `SKILL.md` 中的有序操作，是最主要的层级：agent 按顺序做什么。每个步骤以一个**完成标准**结束，即告诉 agent 工作完成的条件。使其*可检查*（agent 能否区分已完成和未完成？），并在重要时做到*穷尽*（"每个修改过的模型都已覆盖"，而非"生成一个变更列表"）—— 模糊的标准会引发**过早完成**。
-2. **skill 内参考** —— `SKILL.md` 中的定义、规则或事实，按需查阅。通常是一组合法的扁平同级项（例如一次 review 的所有规则处于同一层级）—— 这是一种合理的安排，不是异味。*本 skill 就是纯参考。*
-3. **外部参考** —— 从 `SKILL.md` 中移出到单独文件的参考，通过**上下文指针**触达，仅在指针被触发时加载。（范围从*已披露*参考 —— 如 `GLOSSARY.md` 这样的同级文件，仍属于该 skill 的一部分 —— 到完全的**外部参考**，存在于 skill 系统之外，任何 skill 都可以指向它。）
-
-一个严格的完成标准驱动彻底的**实地探查** —— agent 在工作过程中的深入挖掘 —— 无论 skill 是否有步骤，因为"每条规则都已应用"绑定扁平参考，正如"每个步骤都已完成"绑定一个顺序一样。
-
-推得太少则顶层膨胀；推得太多则隐藏了 agent 实际需要的材料。这种张力就是整个决策。
-
-**渐进式披露**是沿层级向下移动 —— 从 `SKILL.md` 中移出到链接文件 —— 使顶层保持清晰可读。实现机制：skill 文件夹中一个链接的 `.md` 文件，以其包含的内容命名（本 skill 将其完整定义披露到 `GLOSSARY.md`）。有些 skills 以不止一种方式使用，每种不同的使用方式是一个**分支** —— 不同次运行走 skill 的不同路径。分支是最清晰的披露测试标准：将每个分支都需要的材料内联，将只有某些分支需要的材料放到指针后面。**上下文指针**的*措辞*，而非其目标，决定了 agent 触达该材料的时机和可靠性。
-
-层级决定了一段内容*放在多远的位置*，而**就近原则**决定了*它旁边放什么*：将概念的定义、规则和注意事项放在同一个标题下，而非散落各处，这样读一处就能连带看到其周边内容。
-
-## 何时拆分
-
-**粒度**指你分割 skills 的细密程度，每次切割消耗两种负载之一，因此仅在切割值得时才拆分。两种切割方式：
-
-- **按调用** —— 当你有一个独特的**主导词**应独立触发时，或另一个 skill 必须触达它时，拆分出一个**模型调用** skill。你为新产生的始终加载的 **description** 付出**上下文负载**，所以这种独立触达能力必须值得。
-- **按顺序** —— 当后续步骤（一个步骤的**完成后步骤**）诱使 agent 仓促完成当前步骤（**过早完成**）时，拆分一段**步骤**序列。将它们移出视野鼓励 agent 对当前任务做更多**实地探查**。
-
-## 修剪
-
-将每个含义保留在**单一事实来源**中：一个权威位置，这样改变行为只需修改一处。
-
-检查每一行是否具备**相关性**：它是否仍然影响该 skill 的行为？
-
-然后逐句而非逐行地猎杀**无效操作**：对每个句子单独执行无效操作测试，当句子未通过时，删除整个句子，而非从中修剪词语。要激进 —— 大多数未通过的文本应该删除，而非重写。
-
-## 主导词
-
-**主导词**是一个紧凑的概念，已存在于模型的预训练中，agent 在运行该 skill 时用它来思考（例如*课程*、*战争迷雾*、*示踪子弹*）。它在文本中反复出现（尽管不一定 —— 一个强有力的主导词可能只需出现一次），积累出一种分布式定义，通过调用模型已有的先验知识，以最少的 token 锚定整个行为区域。
-
-它两次服务于可预测性。在正文中它锚定*执行*：每次该词出现时，agent 都会采取相同的行为。在 description 中它锚定*调用*：当同一个词出现在你的提示语、文档和代码中时，agent 将该共享语言与 skill 关联起来，更可靠地触发它。
-
-寻找机会将 skills 重构为使用主导词。在三处地方展开的三元组（**重复**），一个用一整句话来暗示一个概念的 description —— 每一处都是恳请**收拢**为单个 token 的段落。示例如下：
-
-- "快速、确定性、低开销" -> *紧凑* —— 一个在某个阶段被反复重述的特性 —— 收拢为一个预训练词（一个*紧凑*的循环）。
-- "一个你相信的循环" -> *红色* —— 将模糊的门禁转换为二进制可观察状态（循环在 bug 上变*红*，或不变）。
-
-你赢两次：更少的 token，*以及* agent 用来锚定其思考的更锐利的钩子。假定每个 skill 都携带着可以被主导词消除的重述 —— 去找到它们。
-
-## 失败模式
-
-用这些来诊断用户在使用 skill 时可能遇到的问题。
-
-- **过早完成** —— 在真正完成之前就结束一个步骤，注意力滑向*完成状态*。防御手段，按顺序：首先锐化完成标准（成本低，局部修改）；仅当标准不可简化的模糊*且*你观察到仓促行为时，通过拆分（按顺序切割）隐藏完成后步骤。
-- **重复** —— 同一含义出现在不止一个地方。增加维护成本和 token 消耗，并将含义在层级上的显著度虚高到超出其实际排名。
-- **沉积** —— 因为增加感觉安全而删除感觉危险，导致陈旧层堆积。任何没有修剪纪律的 skill 的默认命运。
-- **蔓延** —— skill 过于冗长，即使每一行都是活的且独特的。损害可读性和可维护性，浪费 token。解药是层级：将**参考**披露到指针后面，并按**分支**或顺序拆分，使每条路径只携带其所需的内容。
-- **无效操作** —— 模型默认就会遵守的行，你付出负载却说不出任何效果。测试标准：它是否改变了默认行为？一个弱主导词（当 agent 已经大致做到时要求*彻底*）就是无效操作；修复方法是用更强烈的词（*毫不留情*），而非换一种技巧。
-- **否定** —— 通过禁止来引导会适得其反：*不要想大象* 命名了大象，使其更易被调用，而非更少。使用**积极**措辞 —— 陈述目标行为，使被禁止的行为从未被提及；保留禁止性表述仅作为一种无法用积极方式表达的硬护栏，即便如此，也要成对提供替代行为。
+Stop before side effects when the required input, owner, reference, confirmation, schema, or recovery evidence is missing; report the exact blocker and preserve any dry-run evidence.

package/template/skills/writing-great-skills/references/document-contract.md

@@ -0,0 +1,23 @@
+# Document fidelity and progressive disclosure
+
+Apply to AGENTS, commands, skills, Work entries, workflow contracts, templates and references. This is an editing contract, not a new auto-triggered capability.
+
+## Before editing
+
+Locate the real user-maintained source, callers and generator. Record the source revision, symlinks, file modes, frontmatter, licenses and uncommitted user work. Back up the affected real sources, not just a diff statistic. Never edit an installed system/plugin cache or replace a symlink with a regular file. An out-of-root target needs separate source ownership/authorization.
+
+## Structure
+
+Keep entry triggers narrow: necessary task condition plus a meaningful near-neighbor exclusion. Keep inputs, owner, exact required outputs, permission boundaries, acceptance and stop conditions visible. Move mode-only steps, long examples and full templates to named references with an explicit read condition. Moving content is not deleting it; validate every call path. Required-per-run safety checks remain required. Reference evidence and original research are not candidates for lossy summarization.
+
+## Behavioral fidelity
+
+Preserve capabilities, user-specified quantities, default tools, output formats, failure stops and existing write gateways. Missing authorization is not a reason to fabricate completion. Record any behavior changes separately; never trade lower quality, fewer outputs or weaker verification for a context budget. Required evidence can exceed a suggested read budget; explain the expansion.
+
+## Retrieval and writing
+
+Locate matching IDs/entries using a targeted search or range read, then reread a small relevant original span with provenance. Do not load whole indexes by default. Before formal memory writes check the original gateway, unfinished transactions and ownership. Resume only owned transactions under their original protocol; conflicting other-task resources block only the affected write set and dependent work, never justify takeover.
+
+## Acceptance
+
+Validate syntax, metadata, references, positive and negative trigger cases, critical workflows, unchanged quantities/tools and failure stops. Regenerate owned outputs; check a second generation is identical. Reread real sources and links. Deliver modified paths, behavior differences, full before/after character counts including moved references, backup locations, actual commands/results and incomplete items. Distinguish entry size, whole-source size and measured loaded context. Without comparable actual usage, do not claim token, billing or plan-quota savings.

package/template/skills/writing-great-skills/references/entry-procedure.md

@@ -0,0 +1,79 @@
+# Entry procedure
+
+一个 skill 的存在是为了从随机系统中提取确定性。**可预测性** —— 即 agent 每次运行时采取相同的*流程*，而非产生相同的输出 —— 是根本美德；以下每个杠杆都为此服务。
+
+**加粗术语**在 [`GLOSSARY.md`](../GLOSSARY.md) 中有定义；可查阅获取完整含义。
+
+## 调用方式
+
+两种选择，付出不同的代价：
+
+- **模型调用** skill 保留 **description**，因此 agent 可以自主触发它，*并且*其他 skills 也可以触达它（你也仍然可以手动输入其名称）。它会产生**上下文负载** —— description 每轮都留在窗口里。实现机制：省略 `disable-model-invocation`，并编写一个面向模型的 description，包含丰富的触发短语（"当用户想要……、提及……时使用"）。
+- **用户调用** skill 将 description 从 agent 的触达范围中移除：只有你手动输入其名称才能调用它 —— 其他 skill 也无法触达它。零上下文负载，但它消耗**认知负载**：*你*是必须记住它存在的索引。实现机制：设置 `disable-model-invocation: true`；`description` 变为面向人类的 —— 一句摘要，去掉触发列表。
+
+只有当 agent 必须自行触达该 skill，或其他 skill 必须触达它时，才选择模型调用。如果它只需手动触发，则设为用户调用，不付出任何上下文负载。
+
+当用户调用 skills 多到你记不住时，积累的认知负载可以通过一个**路由 skill** 来解决：一个用户调用的 skill，列出其他 skills 以及何时使用它们。
+
+## 编写 description
+
+模型调用的 **description** 做两件事 —— 说明该 skill 是什么，并列出应触发它的**分支**。每个词都会增加**上下文负载**，所以 description 比正文更应该被严格修剪：
+
+- **将 skill 的主导词前置** —— description 是它发挥调用作用的地方。
+- **每个分支一个触发器。** 给单个分支换不同说法的同义词属于**重复** —— "使用 TDD 构建功能……要求测试优先开发" 是一个分支写了两次。收拢它们；只保留真正不同的分支。
+- **删除正文中已有的身份信息。** 将 description 限制为触发器，以及任何"当另一个 skill 需要……"的触达子句。
+
+## 信息层级
+
+一个 skill 由两种内容类型构成 —— **步骤**和**参考** —— 它们可以自由混合：一个 skill 可以全是步骤、全是参考，或两者兼有。核心决策是使用哪种以及每种在**信息层级**上的位置，该层级按 agent 对材料需求的紧急程度排序：
+
+1. **skill 内步骤** —— `SKILL.md` 中的有序操作，是最主要的层级：agent 按顺序做什么。每个步骤以一个**完成标准**结束，即告诉 agent 工作完成的条件。使其*可检查*（agent 能否区分已完成和未完成？），并在重要时做到*穷尽*（"每个修改过的模型都已覆盖"，而非"生成一个变更列表"）—— 模糊的标准会引发**过早完成**。
+2. **skill 内参考** —— `SKILL.md` 中的定义、规则或事实，按需查阅。通常是一组合法的扁平同级项（例如一次 review 的所有规则处于同一层级）—— 这是一种合理的安排，不是异味。*本 skill 就是纯参考。*
+3. **外部参考** —— 从 `SKILL.md` 中移出到单独文件的参考，通过**上下文指针**触达，仅在指针被触发时加载。（范围从*已披露*参考 —— 如 `GLOSSARY.md` 这样的同级文件，仍属于该 skill 的一部分 —— 到完全的**外部参考**，存在于 skill 系统之外，任何 skill 都可以指向它。）
+
+一个严格的完成标准驱动彻底的**实地探查** —— agent 在工作过程中的深入挖掘 —— 无论 skill 是否有步骤，因为"每条规则都已应用"绑定扁平参考，正如"每个步骤都已完成"绑定一个顺序一样。
+
+推得太少则顶层膨胀；推得太多则隐藏了 agent 实际需要的材料。这种张力就是整个决策。
+
+**渐进式披露**是沿层级向下移动 —— 从 `SKILL.md` 中移出到链接文件 —— 使顶层保持清晰可读。实现机制：skill 文件夹中一个链接的 `.md` 文件，以其包含的内容命名（本 skill 将其完整定义披露到 `GLOSSARY.md`）。有些 skills 以不止一种方式使用，每种不同的使用方式是一个**分支** —— 不同次运行走 skill 的不同路径。分支是最清晰的披露测试标准：将每个分支都需要的材料内联，将只有某些分支需要的材料放到指针后面。**上下文指针**的*措辞*，而非其目标，决定了 agent 触达该材料的时机和可靠性。
+
+层级决定了一段内容*放在多远的位置*，而**就近原则**决定了*它旁边放什么*：将概念的定义、规则和注意事项放在同一个标题下，而非散落各处，这样读一处就能连带看到其周边内容。
+
+## 何时拆分
+
+**粒度**指你分割 skills 的细密程度，每次切割消耗两种负载之一，因此仅在切割值得时才拆分。两种切割方式：
+
+- **按调用** —— 当你有一个独特的**主导词**应独立触发时，或另一个 skill 必须触达它时，拆分出一个**模型调用** skill。你为新产生的始终加载的 **description** 付出**上下文负载**，所以这种独立触达能力必须值得。
+- **按顺序** —— 当后续步骤（一个步骤的**完成后步骤**）诱使 agent 仓促完成当前步骤（**过早完成**）时，拆分一段**步骤**序列。将它们移出视野鼓励 agent 对当前任务做更多**实地探查**。
+
+## 修剪
+
+将每个含义保留在**单一事实来源**中：一个权威位置，这样改变行为只需修改一处。
+
+检查每一行是否具备**相关性**：它是否仍然影响该 skill 的行为？
+
+然后逐句而非逐行地猎杀**无效操作**：对每个句子单独执行无效操作测试，当句子未通过时，删除整个句子，而非从中修剪词语。要激进 —— 大多数未通过的文本应该删除，而非重写。
+
+## 主导词
+
+**主导词**是一个紧凑的概念，已存在于模型的预训练中，agent 在运行该 skill 时用它来思考（例如*课程*、*战争迷雾*、*示踪子弹*）。它在文本中反复出现（尽管不一定 —— 一个强有力的主导词可能只需出现一次），积累出一种分布式定义，通过调用模型已有的先验知识，以最少的 token 锚定整个行为区域。
+
+它两次服务于可预测性。在正文中它锚定*执行*：每次该词出现时，agent 都会采取相同的行为。在 description 中它锚定*调用*：当同一个词出现在你的提示语、文档和代码中时，agent 将该共享语言与 skill 关联起来，更可靠地触发它。
+
+寻找机会将 skills 重构为使用主导词。在三处地方展开的三元组（**重复**），一个用一整句话来暗示一个概念的 description —— 每一处都是恳请**收拢**为单个 token 的段落。示例如下：
+
+- "快速、确定性、低开销" -> *紧凑* —— 一个在某个阶段被反复重述的特性 —— 收拢为一个预训练词（一个*紧凑*的循环）。
+- "一个你相信的循环" -> *红色* —— 将模糊的门禁转换为二进制可观察状态（循环在 bug 上变*红*，或不变）。
+
+你赢两次：更少的 token，*以及* agent 用来锚定其思考的更锐利的钩子。假定每个 skill 都携带着可以被主导词消除的重述 —— 去找到它们。
+
+## 失败模式
+
+用这些来诊断用户在使用 skill 时可能遇到的问题。
+
+- **过早完成** —— 在真正完成之前就结束一个步骤，注意力滑向*完成状态*。防御手段，按顺序：首先锐化完成标准（成本低，局部修改）；仅当标准不可简化的模糊*且*你观察到仓促行为时，通过拆分（按顺序切割）隐藏完成后步骤。
+- **重复** —— 同一含义出现在不止一个地方。增加维护成本和 token 消耗，并将含义在层级上的显著度虚高到超出其实际排名。
+- **沉积** —— 因为增加感觉安全而删除感觉危险，导致陈旧层堆积。任何没有修剪纪律的 skill 的默认命运。
+- **蔓延** —— skill 过于冗长，即使每一行都是活的且独特的。损害可读性和可维护性，浪费 token。解药是层级：将**参考**披露到指针后面，并按**分支**或顺序拆分，使每条路径只携带其所需的内容。
+- **无效操作** —— 模型默认就会遵守的行，你付出负载却说不出任何效果。测试标准：它是否改变了默认行为？一个弱主导词（当 agent 已经大致做到时要求*彻底*）就是无效操作；修复方法是用更强烈的词（*毫不留情*），而非换一种技巧。
+- **否定** —— 通过禁止来引导会适得其反：*不要想大象* 命名了大象，使其更易被调用，而非更少。使用**积极**措辞 —— 陈述目标行为，使被禁止的行为从未被提及；保留禁止性表述仅作为一种无法用积极方式表达的硬护栏，即便如此，也要成对提供替代行为。

package/template/workflows/learning/A-archive/A-archive.md

@@ -11,6 +11,13 @@ keywords: [archive, cold-archive, close]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 1. 用户明确指定 root Change 并写入 close/confirm；没有确认只输出待归档清单。

package/template/workflows/learning/A-assess-and-plan/A-assess-and-plan.md

@@ -11,6 +11,13 @@ keywords: [评估, baseline, course-design, objectives, background]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 1. 确认 I 已完成，收集学习目标、期望效果、受众、范围、时间、表达基线和深度。缺少会改变课程设计的选择时，一次只问一个问题。

package/template/workflows/learning/C-consolidate/C-consolidate.md

@@ -11,6 +11,13 @@ keywords: [consolidate, synthesis, provenance, topic, relocate]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 1. 用户指定目标 domain/topic 和 source Change IDs。允许 active/closed 的未归档根 Change；已归档内容必须先显式恢复。已有综合子树只能整棵选择，不得拆分。

package/template/workflows/learning/H-homework/H-homework.md

@@ -11,9 +11,16 @@ keywords: [homework, assignment, questions, grading, explain]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
-1. 用户指定一个或多个 Lesson/OBJ 和题数（默认 5）。读取课程正文、目标、来源和背景；不得把题目答案提前写入作业。
+1. 用户指定一个或多个 Lesson/OBJ 和题数（默认 5）。按 Lesson/OBJ 索引只读取对应课程正文、目标、来源和背景；不得把题目答案提前写入作业。
 2. 创建 `homework/HW-<NNN>-<slug>-attempt-01.md`，写元数据、Q1…、空白 A1… 和 `Submission: pending`，更新 `homework/INDEX.md`。
 3. 用户填写 A1…并在文件中加入精确行 `Submission: ready` 后再次激活 H。H 校验回答原文和提交标记，冻结问题/答案内容。
 4. 只在同一文件末尾追加 `## Review`：每题给出 `correct|partial|incorrect|uncertain`、证据覆盖、中文详细讲解、`Explain (English)`、误区和下一步，并记录引用的 Lesson/source anchor。

package/template/workflows/learning/I-init-setup/I-init-setup.md

@@ -11,6 +11,13 @@ keywords: [初始化, learner-profile, context, learning-v2]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 1. 读取 `<Path>{roots.state}/learning/status.json</Path>`。不存在时从 `_state/status.json` 原子创建；存在 v1 或未知 schema 时停止并返回 `learning-reset-required`，不修复旧文件。

package/template/workflows/learning/INDEX.md

@@ -11,6 +11,8 @@ keywords: [learning, 学习, 教学, 作业, 复习, 综合, 知识, eli5]
 
 本索引只用于被动发现 Learning 和已发布的主题知识；被动读取不得初始化状态、创建 Change 或修改复习状态。需要执行 Work 时必须读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+激活后读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`：先定位相关 entry，再回读少量原文与 provenance；正式写入前检查 owner/gateway、pending transaction、lock 和 recovery evidence。
+
 ## 永久知识（主题视图）
 
 - 总目录：`<Path>{roots.state}/learning/context/INDEX.md</Path>`

package/template/workflows/learning/L-lesson/L-lesson.md

@@ -11,6 +11,13 @@ keywords: [lesson, 教学, eli5, 图文, explanation]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 1. 确认 Change 有 `course.md`、`background/foundation.md`、`baseline.md`、目标 OBJ 和 `sources.md`；缺失时返回 A-assess-and-plan。

package/template/workflows/learning/R-review/R-review.md

@@ -11,9 +11,16 @@ keywords: [复习, retention, spaced-review, transfer]
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/learning/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
-1. 用户明确指定 Lesson、Homework、Change 或 topic；读取对应的 sources、目标和过去证据。没有真实间隔时只记录 `due_at`，不伪造通过。
+1. 用户明确指定 Lesson、Homework、Change 或 topic；按 review/来源索引只读取对应 sources、目标和到期的过去证据。没有真实间隔时只记录 `due_at`，不伪造通过。
 2. 在 Change 的 `review/INDEX.md` 和 `review/RV-<id>.md` 生成新复习记录。题目必须包含延迟回忆、机制/反例和新的迁移情境，不复制刚看过的示例。
 3. 原样保存回答并给出逐项证据；失败只生成补救范围和 `needs_review`，不删除历史、不改写 archived 原文。
 4. 只有通过真实延迟复习才设置 `mastery.retention=passed`、`mastery.overall=retention_verified`，并在 context topic view 标记 `mastered`。R 完成后不自动激活 A。

package/template/workflows/learning/README.md

@@ -2,6 +2,8 @@
 
 本合同只在用户明确激活 Learning 或其中一个 Work 后读取。Learning 将学习拆成课程设计、完整授课、单文件作业、可选保持复习和用户触发的主题整合；Work 之间不自动串联。
 
+激活后读取 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`，按当前 Change、Lesson/OBJ、topic 和 evidence 关键词定位最小相关工件；不默认整读 context、archive 或其他 Change。
+
 ## Work 条目
 
 <!-- AUTO-INDEX-START -->
@@ -118,7 +120,7 @@ Workflow 自身只读模板；Change 内容只写当前 Change 或其 `children/
 
 Learning v1 不自动迁移。`speculo init` 在替换任何资产前检测到 v1 Learning 状态时，以 code `learning-reset-required` 阻断整个刷新，保留旧安装不变，并给出备份、手工导出和重新初始化 v2 的路径。不会自动删除、移动或覆盖用户旧数据。
 
-详细 schema、工件所有权、引用和副作用规则位于 `<Path>{roots.workflows}/learning/common/</Path>`；验证命令为：
+详细 schema、工件所有权、引用和副作用规则位于 `<Path>{roots.workflows}/learning/common/</Path>`；激活与记忆读取规则位于 `<Path>{roots.workflows}/learning/common/rules/activation-and-memory.md</Path>`；验证命令为：
 
 ```bash
 node <Path>{roots.workflows}/learning/common/tools/validate-learning.mjs</Path> --workflow-root <Path>{roots.workflows}/learning</Path>

package/template/workflows/learning/common/rules/activation-and-memory.md

@@ -0,0 +1,24 @@
+# Activation and memory retrieval protocol
+
+本规则只在用户明确激活当前 workflow 或某个 Work 后读取。INDEX 只用于被动发现，不初始化状态、不读取 active change、不写入知识。
+
+## Locate before read
+
+1. 先解析当前 workflow 的 roots、状态索引和稳定 ID；不存在时静默跳过，不能凭旧路径猜测。
+2. 根据当前请求、Work 分支、关键词、稳定 ID、状态和 provenance，先搜索相关索引行或目录项，再定位最小相关 entry；不把索引全文默认装入上下文。
+3. 只回读命中的 entry 和直接 provenance；需要恢复、冲突裁决、归档、迁移或执行安全证明时，才读取该阶段声明的完整证据集合。
+4. 没有匹配证据时返回缺失证据并停止依赖该结论的分支，不补造事实。
+
+## Memory writes
+
+正式知识、永久 context、synthesis 或 archive 写入前，先解析唯一 owner 与 gateway，检查 pending transaction、lock、未完成 promotion 和 recovery evidence。gateway 不明或事务未闭合时，只阻塞记忆写入，继续独立且已授权的审计、定位、验证和其他工作。
+
+每次写入必须记录 source IDs、证据定位、验证时间或 digest；写入后定位受影响索引项并重新读取目标 entry，确认 owner、locator、内容和状态投影一致。原始证据不可被派生视图覆盖。
+
+## Read budget
+
+当前 Work 的权威状态、schema、Map/Plan、当前输入和直接所有权合同可以完整读取；非当前分支的知识树、历史 change、研究库、项目 Skill 和示例只按索引与关键词读取。执行、冲突、恢复和归档 Work 需要完整证据时，以该 Work 的显式合同为准。
+
+## 事务与归属隔离
+
+启动正式写入前检查原网关未闭合事务与写集。属于本任务的事务按原恢复协议处理；属于其他任务的事务不得接管、解锁、清空或覆盖。只暂停资源重叠的写入与依赖分支，继续独立、已授权工作；事务年龄不构成接管授权。写后按变更 ID 定位受影响的索引项并回读目标原文，不为核验默认整读整库。

package/template/workflows/ops/A-archive-and-learn/A-archive-and-learn.md

@@ -13,6 +13,13 @@ keywords: [复盘, 错误教训, SOP, 知识合并, 项目归档]
 
 A 是 RETROSPECTIVE、知识提升和 scope-aware 归档的唯一 owner。它保留完整失败历史，但只把有证据、仍有效且对后续工作有用的结论合并为现役知识。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/ops/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/ops/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 ### 1. 验证完成证据

package/template/workflows/ops/E-execute-and-stabilize/E-execute-and-stabilize.md

@@ -13,6 +13,13 @@ keywords: [执行, attempt, 调试, 诊断, 回滚, 验证, 稳定性]
 
 E 是正常部署、批准回滚、attempt 诊断、验证和 completed 转换的唯一 owner。它不补写计划或批准，也不把命令退出零当作部署完成。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/ops/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/ops/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 模式
 
 - `deploy`：执行当前批准计划；
@@ -24,7 +31,7 @@ E 是正常部署、批准回滚、attempt 诊断、验证和 completed 转换
 
 ### 1. 恢复与预检
 
-读取所有既有 attempts、当前 status、request、inventory、deployment model、target profile、plan/approval、`<Path>{roots.workflows}/ops/common/rules/execution-loop.md</Path>` 与 `<Path>{roots.workflows}/ops/common/rules/target-profile-and-release-gates.md</Path>`。除 verification-only 外必须通过 `--stage pre-execute`，重建 plan/profile 摘要、source、target、路径包含、整体控制面身份、权限、容量、端口、Gate、数据保护、preview 和 rollback material。
+执行与恢复阶段有意完整读取所有既有 attempts、当前 status、request、inventory、deployment model、target profile、plan/approval、`<Path>{roots.workflows}/ops/common/rules/execution-loop.md</Path>` 与 `<Path>{roots.workflows}/ops/common/rules/target-profile-and-release-gates.md</Path>`。除 verification-only 外必须通过 `--stage pre-execute`，重建 plan/profile 摘要、source、target、路径包含、整体控制面身份、权限、容量、端口、Gate、数据保护、preview 和 rollback material；这是执行安全与恢复证据例外。
 
 在第一条 mutation 前重采集 identity assertions 并按 exact/ordered-list/set/digest 比较。任何 profile/identity/构件漂移、新 mutation、新权限或计划外写入都会零 mutation 停止，令 approval invalidated 并返回 I/P。发现同一 target/deployment root 正被另一 change 执行时阻塞。
 

package/template/workflows/ops/I-intake-and-assess/I-intake-and-assess.md

@@ -13,6 +13,13 @@ keywords: [摄入, change, 项目识别, 系统盘点, 部署分析, target prof
 
 I 是初始化、scope/project/change 选择、部署模型和 target profile 的唯一 owner。它回答“当前工作属于哪里、目标现在是什么、项目需要怎样部署、现场身份与授权边界是什么、是否已经可以规划”，不构建、安装、启动服务或修改目标。
 
+## 读取范围
+
+1. 先读取 `<Path>{roots.workflows}/ops/README.md</Path>` 与当前 Work 的状态入口。
+2. 再读取 `<Path>{roots.workflows}/ops/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
+3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
+
+
 ## 流程
 
 ### 1. 初始化与确定 Scope