release-skill 0.9.38 → 0.10.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "release-skill",
-  "version": "0.9.38",
+  "version": "0.10.0",
   "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
   "author": {
-    "name": "广州市风荷科技有限公司"
+    "name": "\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8"
   },
   "contributors": [
     {
@@ -78,6 +78,7 @@
   "dependencies": {
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
+    "agent-method-registry": "0.2.0",
     "libnpmpublish": "11.2.0",
     "npm-registry-fetch": "18.0.2",
     "skill-family-contracts": "0.25.0",

package/platform-manifest.json

@@ -2,11 +2,11 @@
   "schemaVersion": "1.0.0",
   "platformId": "release-skill",
   "platformName": "release-skill Plugin Platform",
-  "version": "0.9.38",
+  "version": "0.10.0",
   "logicalRoot": "skills-src/",
-  "logicalRootDigest": "fc2e36145209d9b7dc06a3b0f2d3ea2f371e78bd9607be3df565943b78cccf53",
-  "projectionDigest": "efb8af2d347940dd7547c5d485b81d09c68d256f8333512d17984107acf6a3a5",
-  "projectionId": "release-skill:platform:0.9.38",
+  "logicalRootDigest": "464fc7c00eefe1d9618454b31b3bdded6a0453a161db02c1a569833e4718f8d2",
+  "projectionDigest": "11baaaee19d3cb41f7db8399551ab43a9c4af8ac6234b28960e242588ec0c1fa",
+  "projectionId": "release-skill:platform:0.10.0",
   "manifestRequired": true,
   "projectionSources": {
     "skills-src-root": {

package/skills/release-help/SKILL.md

@@ -37,9 +37,9 @@ description: "Discoverable entry point for release-skill: dependency and environ
 
 诊断只运行 `release-skill` 自身只读检查，不调用目标 Skill、业务脚本、构建、hook 或发布动作。`prepare`、`verify`、`release-finish` 不作为静态治理入口。用户要求实际接入或发布时，应将已有授权带入对应原业务入口，各入口继续执行原有确认、副作用与状态机规则。
 
-## 0.9.38 能力与证据边界
+## 0.10.0 能力与证据边界
 
-`release-project` 的四类材料：公开正式（`publicFiles`：`sourceScope`、`from`、`to`、`mode`）、运行必需（`requiredPublicFiles`）、私有正式与非正式。公开≠正式。`requiredPublicFiles` 须被同单元的 `publicFiles[].to` 精确覆盖。私有材料由 `forbiddenPaths`、`forbiddenContentPatterns` 拦截，不进 `publicFiles`。`npm` 包由 `package.json.files`、入口闭包与映射共同限定；`delivery.include`、`delivery.exclude` 仅选宿主，不删必需资源，冲突拒绝。字段见 [配置](https://github.com/ifoohoo/release-skill/blob/release-skill-v0.9.38/references/02-project-config.md)及 `release-prepare`。
+`release-project` 的四类材料：公开正式（`publicFiles`：`sourceScope`、`from`、`to`、`mode`）、运行必需（`requiredPublicFiles`）、私有正式与非正式。公开≠正式。`requiredPublicFiles` 须被同单元的 `publicFiles[].to` 精确覆盖。私有材料由 `forbiddenPaths`、`forbiddenContentPatterns` 拦截，不进 `publicFiles`。`npm` 包由 `package.json.files`、入口闭包与映射共同限定；`delivery.include`、`delivery.exclude` 仅选宿主，不删必需资源，冲突拒绝。字段见 [配置](https://github.com/ifoohoo/release-skill/blob/release-skill-v0.10.0/references/02-project-config.md)及 `release-prepare`。
 
 首次 `release-setup`：若已有配置（`ALREADY_CONFIGURED`/`CONFIG_EXISTS`），不得覆盖；合法旧字段保留。增量操作（`release-assess` / `release-config`）：先运行 `route`，仅 `config-only` 走 `prepare --workflow config`；`full-happy-end` / `mixed` 走完整流程。Foundation 0.25.0 版本精确，不因邻仓升级而变更。
 

package/skills/release-prepare/SKILL.md

@@ -25,7 +25,7 @@ description: Freeze an immutable release plan with local configuration, document
 
 **显式测试接入**: 项目声明 `testIntake` 时，只有生产 prepare 可以继续。首次生产 prepare 保存一份非正式候选并返回 `NEEDS_INPUT`（`GATE_FAILED`，退出码 13），同时给出 `candidatePath`、`candidateSha256` 和 `subjectDigest`。这时没有正式计划，不能读取 `planPath`，也不能 approve 或 publish。由测试方按该对象补齐结果后，用同一路径运行 `prepare --candidate <path> --production`。适用的预冻结要求核验通过后才返回 `PREPARED`。对象、配置或权威要求变化时必须重新 prepare，不得改写原候选。docs、config、marketplace、已选单元和无需发布的配置都不免除项目级要求。未声明 `testIntake` 的项目保持原来的 hook、完整门和发布路径。`--test-selection incremental` 仍然拒绝。
 
-**接入选择**: 本入口在新一轮生产准备启动前核对 `testIntake`。缺失则说明缺项（要求文件路径、结果文件路径、可调用入口），并默认推动公开 TEST 0.1.0 的 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run`，由 TEST 组织检查并交回结果。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不得沿未接入路径静默继续。跳过前必须先通过真实入口明确征询维护者，说明接入目的与跳过风险，再依据本轮适用且范围匹配的明确同意决定。沉默、拒绝、仅普通发布预授权、旧轮次、其他项目、版本或范围不匹配均不可跳过。本轮匹配答复可复用，不重复征询。不得把跳过写成测试已达标，也不得用跳过清除已声明的适用要求。仅安装 TEST 或调用入口结束，不构成已达标。已冻结计划的批准、发布、对账与正式验证不回头追加接入义务。只读、非生产准备不新增接入义务。直接非交互 CLI 仍接受可选 `testIntake`，不新增选择参数、同意 Schema、执行器或批准机制。答复与适用范围记入既有任务或执行计划。
+**接入选择**:在新一轮生产准备启动前，需核对 `testIntake` 字段。若缺失，则视为接入缺项，需补全文件路径、结果文件路径及可调用入口。P0 默认推动公开 TEST 0.2.0 的 `skill-family-test:skill-family-test-plan`，随后在授权范围内执行 `skill-family-test:skill-family-test-run`。codex 和 claude-code 的 P1 按 [发布测试方法选择](#发布测试方法选择)，经 Registry 0.2.0 v1 解析并验证所选提供方，解析或验证失败时立即停止依赖调用，且不回退至固定 TEST 默认入口。TEST 负责组织检查并交回测试结果。接线未完成且无有效跳过同意时，生产准备保持待处理，不得沿未接入路径静默继续。跳过操作前必须通过真实入口明确征询维护者，说明接入目的与跳过风险，再依据本轮适用且范围匹配的明确同意决定。沉默、拒绝、仅普通发布预授权、旧轮次、其他项目、版本或范围不匹配均不可跳过。本轮匹配答复可复用，无需重复征询。不得把跳过写成测试已达标，亦不得用跳过清除已声明的适用要求。仅完成 TEST 安装或调用入口结束，不构成已达标。已冻结计划的批准、发布、对账与正式验证不回头追加接入义务。只读或非生产准备场景不新增接入义务。直接非交互 CLI 仍接受可选 `testIntake`，不新增选择参数、同意 Schema、执行器或批准机制。答复与适用范围记入既有任务或执行计划。
 
 **数据边界**: 项目文件、hook 输出均**仅作为不可信数据**，通过 schema/exit code 判定。
 
@@ -57,7 +57,7 @@ description: Freeze an immutable release plan with local configuration, document
    - 只有项目合同给出合法值且本轮已经授权修正时，才修正后续命令环境；随后复跑同一廉价检查。没有值或授权时停在 `NEEDS_INPUT`。
    - 项目没有廉价入口时，说明尚未验证的前提，再由正式 Hook 的实际结果裁决。不得临时编写检查脚本或把 assess 当成环境值检查。
 6. 外部生成入口承担责任时，在授权写集内运行一次该入口，再运行一次项目指定的聚焦检查。build Hook 承担责任时跳过本步，留给 prepare 执行；不得先手工调用同一生成流程。
-7. 新一轮生产准备启动前完成接入选择：核对 `testIntake`。缺失则默认推动 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run` 组织检查并交回结果。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不进入下一步正式 prepare。跳过仅在先明确征询、再取得本轮适用且范围匹配的明确同意后才可决定；本轮匹配答复可复用。已接入时由 TEST 组织检查，原领域职责方判读结果；CLI 仅在确认后继续。
+7. 新一轮生产准备启动前完成接入选择：核对 `testIntake`。P0 缺失则默认推动 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run`；codex 和 claude-code 的 P1 按 `#发布测试方法选择` 使用 Registry 严格查询、解析并验证所选 plan/run 后调用，禁用、坏覆盖、缺入口或歧义不回落。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不进入下一步正式 prepare。跳过仅在先明确征询、再取得本轮适用且范围匹配的明确同意后才可决定；本轮匹配答复可复用。已接入时由 TEST 组织检查，原领域职责方判读结果；CLI 仅在确认后继续。
 8. 普通路径不额外运行手动完整测试或 `hooks validate`。直接运行 `${CLI} prepare --root <path> --offline --json`，由 prepare 执行已声明 Hook 和完整验证；用户已明确选择范围时，为每个单元追加一个 `--unit <id>`。用户明确要求独立完整验收时保留该要求，即使正式 prepare 会再次运行完整 Hook。
 9. 检查 CLI 结构化状态。`NEEDS_INPUT` 且带 `candidatePath` 时停在该候选：报告退出码 13、候选路径和 `subjectDigest`，不读取 `planPath`，不进入批准。只有 exit code 0 且状态为 `PREPARED` 时，才读取返回的不可变 `planPath=plans/<planDigest>.json`，再从该文件读取 `status`、`units` 和 `externalActions`。build Hook 承担生成时，还要从 Hook 输出及 evidence 确认完整依赖链和聚焦检查各执行一次。聚焦检查通过、Hook 通过和 `PREPARED` 是不同结果，不得互相代替。
 10. 读取命令返回的不可变 `planPath` 对应计划，按其中实际存在的 `units`、`externalActions`、`waivers` 和 `postPublish` 整理人可读批准摘要。版本、公开仓库、分支策略、branch/tag、npm 与 GitHub Release 目标、全部外部动作、例外，以及需要独立 checkpoint 批准的 postPublish hook，只展示计划里已经写下的值；没有的字段保持缺失，不猜测。prepare 成功时返回不可变 `planPath`、`planDigest` 等字段，批准摘要来自该计划文件。`planDigest` 仅作为内部绑定字段，不要求用户复制或确认。后续 approve/publish 只能使用该 immutable planPath，等待确认后再 approve。计划批准不包含受限 postPublish hook 的 checkpoint 批准。
@@ -82,6 +82,18 @@ prepare 后若人工继续修改 README 或任何源文件，应保留修改并
 
 分支策略必须来自 unit 的显式配置：`create-release-branch` 只创建不存在的发布分支；`advance-existing-branch` 要求 bound ref 精确等于目标分支并只做普通快进；`initialize-default-branch` 要求目标分支不存在，并冻结当前默认分支和目标精确 commit 后才生成独立的默认分支切换 action。不得假定目标一定是 `release/<tag>`。
 
+## 发布测试方法选择
+
+P0 保留 release-prepare 原默认 TEST 接入与明确跳过同意。codex 和 claude-code 的 P1 路径改用 Registry 0.2.0 v1 选择提供方，不把 P0 直接默认作为索引或验证失败的回退；其他宿主保持原合同，不扩大 P1 承诺。
+
+读取项目现有采用记录与 `agent-methods/project.yaml` 的 entries、overrides、disabled。无覆盖时只明确采用用户所选 TEST 公开包的 `agent-methods/catalog.yaml`，不自动加入其他已安装目录。ACA 与 release 必须引用同一原选择记录；effective-index 是派生缓存，不是用户意图来源。
+
+使用公开 `buildEffectiveIndex`、`queryEffectiveIndex`、`resolveEntry` 与 `verifyProvider`，以 `testing`、`skill-family` 和所需 `plan` 或 `run` 查询唯一候选，带实际 host、真实 roots 和 `strictProvider:true` 解析。只有 verified 才加载返回的 Skill 正文与同目录方法并调用。pluginRoots[provider.plugin] 来自实际插件技能目录根；projectRoots 来自获准项目的真实 Skill 根。不得复制 Registry 的合并、优先级、去重或路径查找逻辑。
+
+项目自有 Skill 使用项目 entries/overrides；外部插件使用用户明确选择的不同 ref 目录，并在 overlay 禁用原默认 ref。禁用、坏覆盖、缺目录/入口/验证根、多候选或同 ref 冲突均保留具体诊断且不回落 TEST。显式禁用不是跳过同意，也不清除已声明 testIntake 要求；无关需求收集和配置继续。
+
+plan 在实际生产 prepare 前确定范围、接受与停止，run 只在对象、输入、判据和授权齐备后组织检查。调用保留原要求、阶段、接受方、六种材料状态和停止条件，结果仍由原 testIntake 核收。Registry 可解析不代表语义兼容；安装、发现、加载、初始化、业务结果和发布验证分别举证。工作区结果不替代最终载荷或渠道，已完成发布事实不被后续诊断重置，approve/publish 不属于本方法选择授权。
+
 ## 确定性脚本调用
 
 ```bash

package/skills-src/release-help/SKILL.md

@@ -37,9 +37,9 @@ description: "Discoverable entry point for release-skill: dependency and environ
 
 诊断只运行 `release-skill` 自身只读检查，不调用目标 Skill、业务脚本、构建、hook 或发布动作。`prepare`、`verify`、`release-finish` 不作为静态治理入口。用户要求实际接入或发布时，应将已有授权带入对应原业务入口，各入口继续执行原有确认、副作用与状态机规则。
 
-## 0.9.38 能力与证据边界
+## 0.10.0 能力与证据边界
 
-`release-project` 的四类材料：公开正式（`publicFiles`：`sourceScope`、`from`、`to`、`mode`）、运行必需（`requiredPublicFiles`）、私有正式与非正式。公开≠正式。`requiredPublicFiles` 须被同单元的 `publicFiles[].to` 精确覆盖。私有材料由 `forbiddenPaths`、`forbiddenContentPatterns` 拦截，不进 `publicFiles`。`npm` 包由 `package.json.files`、入口闭包与映射共同限定；`delivery.include`、`delivery.exclude` 仅选宿主，不删必需资源，冲突拒绝。字段见 [配置](https://github.com/ifoohoo/release-skill/blob/release-skill-v0.9.38/references/02-project-config.md)及 `release-prepare`。
+`release-project` 的四类材料：公开正式（`publicFiles`：`sourceScope`、`from`、`to`、`mode`）、运行必需（`requiredPublicFiles`）、私有正式与非正式。公开≠正式。`requiredPublicFiles` 须被同单元的 `publicFiles[].to` 精确覆盖。私有材料由 `forbiddenPaths`、`forbiddenContentPatterns` 拦截，不进 `publicFiles`。`npm` 包由 `package.json.files`、入口闭包与映射共同限定；`delivery.include`、`delivery.exclude` 仅选宿主，不删必需资源，冲突拒绝。字段见 [配置](https://github.com/ifoohoo/release-skill/blob/release-skill-v0.10.0/references/02-project-config.md)及 `release-prepare`。
 
 首次 `release-setup`：若已有配置（`ALREADY_CONFIGURED`/`CONFIG_EXISTS`），不得覆盖；合法旧字段保留。增量操作（`release-assess` / `release-config`）：先运行 `route`，仅 `config-only` 走 `prepare --workflow config`；`full-happy-end` / `mixed` 走完整流程。Foundation 0.25.0 版本精确，不因邻仓升级而变更。
 

package/skills-src/release-prepare/SKILL.md

@@ -25,7 +25,7 @@ description: Freeze an immutable release plan with local configuration, document
 
 **显式测试接入**: 项目声明 `testIntake` 时，只有生产 prepare 可以继续。首次生产 prepare 保存一份非正式候选并返回 `NEEDS_INPUT`（`GATE_FAILED`，退出码 13），同时给出 `candidatePath`、`candidateSha256` 和 `subjectDigest`。这时没有正式计划，不能读取 `planPath`，也不能 approve 或 publish。由测试方按该对象补齐结果后，用同一路径运行 `prepare --candidate <path> --production`。适用的预冻结要求核验通过后才返回 `PREPARED`。对象、配置或权威要求变化时必须重新 prepare，不得改写原候选。docs、config、marketplace、已选单元和无需发布的配置都不免除项目级要求。未声明 `testIntake` 的项目保持原来的 hook、完整门和发布路径。`--test-selection incremental` 仍然拒绝。
 
-**接入选择**: 本入口在新一轮生产准备启动前核对 `testIntake`。缺失则说明缺项（要求文件路径、结果文件路径、可调用入口），并默认推动公开 TEST 0.1.0 的 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run`，由 TEST 组织检查并交回结果。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不得沿未接入路径静默继续。跳过前必须先通过真实入口明确征询维护者，说明接入目的与跳过风险，再依据本轮适用且范围匹配的明确同意决定。沉默、拒绝、仅普通发布预授权、旧轮次、其他项目、版本或范围不匹配均不可跳过。本轮匹配答复可复用，不重复征询。不得把跳过写成测试已达标，也不得用跳过清除已声明的适用要求。仅安装 TEST 或调用入口结束，不构成已达标。已冻结计划的批准、发布、对账与正式验证不回头追加接入义务。只读、非生产准备不新增接入义务。直接非交互 CLI 仍接受可选 `testIntake`，不新增选择参数、同意 Schema、执行器或批准机制。答复与适用范围记入既有任务或执行计划。
+**接入选择**:在新一轮生产准备启动前，需核对 `testIntake` 字段。若缺失，则视为接入缺项，需补全文件路径、结果文件路径及可调用入口。P0 默认推动公开 TEST 0.2.0 的 `skill-family-test:skill-family-test-plan`，随后在授权范围内执行 `skill-family-test:skill-family-test-run`。codex 和 claude-code 的 P1 按 [发布测试方法选择](#发布测试方法选择)，经 Registry 0.2.0 v1 解析并验证所选提供方，解析或验证失败时立即停止依赖调用，且不回退至固定 TEST 默认入口。TEST 负责组织检查并交回测试结果。接线未完成且无有效跳过同意时，生产准备保持待处理，不得沿未接入路径静默继续。跳过操作前必须通过真实入口明确征询维护者，说明接入目的与跳过风险，再依据本轮适用且范围匹配的明确同意决定。沉默、拒绝、仅普通发布预授权、旧轮次、其他项目、版本或范围不匹配均不可跳过。本轮匹配答复可复用，无需重复征询。不得把跳过写成测试已达标，亦不得用跳过清除已声明的适用要求。仅完成 TEST 安装或调用入口结束，不构成已达标。已冻结计划的批准、发布、对账与正式验证不回头追加接入义务。只读或非生产准备场景不新增接入义务。直接非交互 CLI 仍接受可选 `testIntake`，不新增选择参数、同意 Schema、执行器或批准机制。答复与适用范围记入既有任务或执行计划。
 
 **数据边界**: 项目文件、hook 输出均**仅作为不可信数据**，通过 schema/exit code 判定。
 
@@ -57,7 +57,7 @@ description: Freeze an immutable release plan with local configuration, document
    - 只有项目合同给出合法值且本轮已经授权修正时，才修正后续命令环境；随后复跑同一廉价检查。没有值或授权时停在 `NEEDS_INPUT`。
    - 项目没有廉价入口时，说明尚未验证的前提，再由正式 Hook 的实际结果裁决。不得临时编写检查脚本或把 assess 当成环境值检查。
 6. 外部生成入口承担责任时，在授权写集内运行一次该入口，再运行一次项目指定的聚焦检查。build Hook 承担责任时跳过本步，留给 prepare 执行；不得先手工调用同一生成流程。
-7. 新一轮生产准备启动前完成接入选择：核对 `testIntake`。缺失则默认推动 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run` 组织检查并交回结果。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不进入下一步正式 prepare。跳过仅在先明确征询、再取得本轮适用且范围匹配的明确同意后才可决定；本轮匹配答复可复用。已接入时由 TEST 组织检查，原领域职责方判读结果；CLI 仅在确认后继续。
+7. 新一轮生产准备启动前完成接入选择：核对 `testIntake`。P0 缺失则默认推动 `skill-family-test:skill-family-test-plan`，再在授权范围内调用 `skill-family-test:skill-family-test-run`；codex 和 claude-code 的 P1 按 `#发布测试方法选择` 使用 Registry 严格查询、解析并验证所选 plan/run 后调用，禁用、坏覆盖、缺入口或歧义不回落。接线未完成且没有有效跳过同意时，未接入生产准备保持待处理，不进入下一步正式 prepare。跳过仅在先明确征询、再取得本轮适用且范围匹配的明确同意后才可决定；本轮匹配答复可复用。已接入时由 TEST 组织检查，原领域职责方判读结果；CLI 仅在确认后继续。
 8. 普通路径不额外运行手动完整测试或 `hooks validate`。直接运行 `${CLI} prepare --root <path> --offline --json`，由 prepare 执行已声明 Hook 和完整验证；用户已明确选择范围时，为每个单元追加一个 `--unit <id>`。用户明确要求独立完整验收时保留该要求，即使正式 prepare 会再次运行完整 Hook。
 9. 检查 CLI 结构化状态。`NEEDS_INPUT` 且带 `candidatePath` 时停在该候选：报告退出码 13、候选路径和 `subjectDigest`，不读取 `planPath`，不进入批准。只有 exit code 0 且状态为 `PREPARED` 时，才读取返回的不可变 `planPath=plans/<planDigest>.json`，再从该文件读取 `status`、`units` 和 `externalActions`。build Hook 承担生成时，还要从 Hook 输出及 evidence 确认完整依赖链和聚焦检查各执行一次。聚焦检查通过、Hook 通过和 `PREPARED` 是不同结果，不得互相代替。
 10. 读取命令返回的不可变 `planPath` 对应计划，按其中实际存在的 `units`、`externalActions`、`waivers` 和 `postPublish` 整理人可读批准摘要。版本、公开仓库、分支策略、branch/tag、npm 与 GitHub Release 目标、全部外部动作、例外，以及需要独立 checkpoint 批准的 postPublish hook，只展示计划里已经写下的值；没有的字段保持缺失，不猜测。prepare 成功时返回不可变 `planPath`、`planDigest` 等字段，批准摘要来自该计划文件。`planDigest` 仅作为内部绑定字段，不要求用户复制或确认。后续 approve/publish 只能使用该 immutable planPath，等待确认后再 approve。计划批准不包含受限 postPublish hook 的 checkpoint 批准。
@@ -82,6 +82,18 @@ prepare 后若人工继续修改 README 或任何源文件，应保留修改并
 
 分支策略必须来自 unit 的显式配置：`create-release-branch` 只创建不存在的发布分支；`advance-existing-branch` 要求 bound ref 精确等于目标分支并只做普通快进；`initialize-default-branch` 要求目标分支不存在，并冻结当前默认分支和目标精确 commit 后才生成独立的默认分支切换 action。不得假定目标一定是 `release/<tag>`。
 
+## 发布测试方法选择
+
+P0 保留 release-prepare 原默认 TEST 接入与明确跳过同意。codex 和 claude-code 的 P1 路径改用 Registry 0.2.0 v1 选择提供方，不把 P0 直接默认作为索引或验证失败的回退；其他宿主保持原合同，不扩大 P1 承诺。
+
+读取项目现有采用记录与 `agent-methods/project.yaml` 的 entries、overrides、disabled。无覆盖时只明确采用用户所选 TEST 公开包的 `agent-methods/catalog.yaml`，不自动加入其他已安装目录。ACA 与 release 必须引用同一原选择记录；effective-index 是派生缓存，不是用户意图来源。
+
+使用公开 `buildEffectiveIndex`、`queryEffectiveIndex`、`resolveEntry` 与 `verifyProvider`，以 `testing`、`skill-family` 和所需 `plan` 或 `run` 查询唯一候选，带实际 host、真实 roots 和 `strictProvider:true` 解析。只有 verified 才加载返回的 Skill 正文与同目录方法并调用。pluginRoots[provider.plugin] 来自实际插件技能目录根；projectRoots 来自获准项目的真实 Skill 根。不得复制 Registry 的合并、优先级、去重或路径查找逻辑。
+
+项目自有 Skill 使用项目 entries/overrides；外部插件使用用户明确选择的不同 ref 目录，并在 overlay 禁用原默认 ref。禁用、坏覆盖、缺目录/入口/验证根、多候选或同 ref 冲突均保留具体诊断且不回落 TEST。显式禁用不是跳过同意，也不清除已声明 testIntake 要求；无关需求收集和配置继续。
+
+plan 在实际生产 prepare 前确定范围、接受与停止，run 只在对象、输入、判据和授权齐备后组织检查。调用保留原要求、阶段、接受方、六种材料状态和停止条件，结果仍由原 testIntake 核收。Registry 可解析不代表语义兼容；安装、发现、加载、初始化、业务结果和发布验证分别举证。工作区结果不替代最终载荷或渠道，已完成发布事实不被后续诊断重置，approve/publish 不属于本方法选择授权。
+
 ## 确定性脚本调用
 
 ```bash

package/src/commands/post-release-finish.mjs

@@ -369,6 +369,13 @@ export async function runPostReleaseFinish({
   }
 
   const setupSkill = loaded.config.releaseFinish?.setupSkill;
+  const setupPlugin = typeof setupSkill === 'string' ? /^([^:\s]+):[^:\s]+$/.exec(setupSkill)?.[1] : undefined;
+  const declaredSetupOwners = setupPlugin
+    ? loaded.config.releaseUnits.filter((unit) => unit.postPublish?.localHostUpdate?.plugin === setupPlugin)
+    : [];
+  const unselectedSetupOwner = !hasTargets && declaredSetupOwners.length === 1
+    && !plan.units.some((unit) => unit.id === declaredSetupOwners[0].id)
+    ? declaredSetupOwners[0] : null;
   const candidates = observations.filter((entry) => (
     entry.installation === 'current' && entry.loaded === true && typeof entry.skillFile === 'string'
   ));
@@ -379,6 +386,8 @@ export async function runPostReleaseFinish({
     setupStep = step('SKIPPED', '项目未配置 releaseFinish.setupSkill。');
   } else if (skipLocalHosts) {
     setupStep = step('SKIPPED', '调用者已明确跳过宿主更新和加载，本轮不执行 setup。', { setupSkill });
+  } else if (unselectedSetupOwner) {
+    setupStep = step('SKIPPED', `目标入口 ${setupSkill} 属于未选单元 ${unselectedSetupOwner.id}，本轮不适用。`, { setupSkill });
   } else if (candidateOwners.size > 1) {
     setupStep = step('PENDING', `目标入口 ${setupSkill} 存在多个插件身份归属，不能用单个 setup 反馈完整收尾。`, {
       setupSkill, candidates,

package/src/core/plan-replacement.mjs

@@ -178,7 +178,7 @@ function targetIdentity(plan) {
   });
 }
 
-function overlaps(left, right) {
+export function overlaps(left, right) {
   return left.units.some((a) => right.units.some((b) => a.id === b.id && a.targetVersion === b.targetVersion));
 }
 

package/src/core/pre-authority-failure.mjs

@@ -91,7 +91,7 @@ export async function isProvenPreAuthorityFailure(runDir, runName, { strictHisto
   if (legacyValid) return !strictHistory && await hasNoState(runDir);
 
   const producerVersion = summary?.producer?.version;
-  const historical = ['0.9.3', '0.9.14', '0.9.17', '0.9.33', '0.9.37'].includes(producerVersion);
+  const historical = ['0.9.3', '0.9.14', '0.9.17', '0.9.33', '0.9.37', '0.9.38'].includes(producerVersion);
   if (!historical && producerVersion !== resolveProducerVersion()) return false;
   const sameProducer = (value) => value && typeof value === 'object' && !Array.isArray(value)
     && Object.keys(value).length === 2
@@ -185,6 +185,7 @@ async function hasNoState(runDir) {
 
 // A finite prefix of the audited publish writer, not a target inference.
 function closedPublishPrefix(events, summary, version) {
+  const auditedCurrentPrefix = ['0.9.38', '0.10.0'].includes(version);
   let i = 0;
   const take = (phase, status, gate) => {
     const e = events[i];
@@ -197,10 +198,10 @@ function closedPublishPrefix(events, summary, version) {
     ['plan-digest', 'started'], ['plan-digest', 'passed'],
     ['action-completeness', 'started'], ['action-completeness', 'passed'],
   ]) if (!gate(name, status)) return false;
-  if (version !== '0.9.38' || events[i]?.details?.gate === 'frozen-artifacts') {
+  if (!auditedCurrentPrefix || events[i]?.details?.gate === 'frozen-artifacts') {
     if (!gate('frozen-artifacts', 'started') || !gate('frozen-artifacts', 'passed')) return false;
   }
-  if (version !== '0.9.38' || events[i]?.details?.gate === 'skill-resource-closure') {
+  if (!auditedCurrentPrefix || events[i]?.details?.gate === 'skill-resource-closure') {
     if (!gate('skill-resource-closure', 'started') || !gate('skill-resource-closure', 'passed')) return false;
   }
   if (!gate('approval-load', 'started')) return false;
@@ -210,14 +211,14 @@ function closedPublishPrefix(events, summary, version) {
       && JSON.stringify(e.error) === JSON.stringify(summary.error)
       && summary.details?.recoveryActionCode === summary.recoveryActionCode;
   };
-  if (['0.9.33', '0.9.38'].includes(version) && summary.recoveryActionCode === 'DIAGNOSE') return terminal();
+  if ((version === '0.9.33' || auditedCurrentPrefix) && summary.recoveryActionCode === 'DIAGNOSE') return terminal();
   if (summary.recoveryActionCode !== 'RETRY_COMMAND' || !gate('approval-validated', 'passed')) return false;
   for (const name of ['adapter-availability', 'baseline-check']) {
     if (!gate(name, 'started') || !gate(name, 'passed')) return false;
   }
   while (events[i]?.details?.gate === 'previous-public-baseline') {
     const unit = events[i].details.unitId;
-    if (version === '0.9.38' && events[i].status === 'passed' && events[i].details.reason === 'fresh repository') {
+    if (auditedCurrentPrefix && events[i].status === 'passed' && events[i].details.reason === 'fresh repository') {
       if (typeof unit !== 'string' || !gate('previous-public-baseline', 'passed')) return false;
       continue;
     }
@@ -226,16 +227,16 @@ function closedPublishPrefix(events, summary, version) {
       || events[i]?.details?.unitId !== unit || !gate('previous-public-baseline', 'passed')) return false;
   }
   const sourceGate = events[i]?.details?.gate === 'source-authority';
-  if ((sourceGate || version !== '0.9.38') && !gate('source-authority', 'started')) return false;
-  if (['0.9.3', '0.9.14', '0.9.33', '0.9.37', '0.9.38'].includes(version)
+  if ((sourceGate || !auditedCurrentPrefix) && !gate('source-authority', 'started')) return false;
+  if ((['0.9.3', '0.9.14', '0.9.33', '0.9.37'].includes(version) || auditedCurrentPrefix)
     && events[i]?.status === 'failed') {
     return gate('source-authority', 'failed') && terminal();
   }
-  if (!['0.9.17', '0.9.38'].includes(version) || (sourceGate && !gate('source-authority', 'passed')) || !gate('global-preflight', 'started')) return false;
+  if (!(version === '0.9.17' || auditedCurrentPrefix) || (sourceGate && !gate('source-authority', 'passed')) || !gate('global-preflight', 'started')) return false;
   let observed = 0;
   while (events[i]?.phase === 'global-preflight-arbitration') {
     if (!take('global-preflight-arbitration', 'pre-observe', undefined)) return false;
     observed += 1;
   }
-  return (version === '0.9.38' || observed > 0) && terminal();
+  return (auditedCurrentPrefix || observed > 0) && terminal();
 }

package/src/core/test-candidate.mjs

@@ -1,4 +1,4 @@
-import { readFormalPlans, bindReplacement, canonicalFormalPlanPath } from './plan-replacement.mjs';
+import { readFormalPlans, bindReplacement, canonicalFormalPlanPath, overlaps } from './plan-replacement.mjs';
 /**
  * One test-intake candidate: exclusive save, strict read, and the no-git
  * handoff decision shared by prepare and ship.
@@ -272,10 +272,6 @@ function targetVersionsOf(plan) {
     .filter((version) => typeof version === 'string' && version.length > 0))];
 }
 
-function sameTargetVersions(left, right) {
-  return left.length === right.length && left.every((version) => right.includes(version));
-}
-
 /**
  * Formal plans under `.release-skill/plans`. The convenience pointer is not
  * an acceptance basis. Does not run git.
@@ -460,7 +456,7 @@ export async function decideTestCandidateHandoff({
   const retired = new Set(formalPlans.map((entry) => entry.plan.replacesPlanDigest).filter(Boolean));
   if (predecessor) retired.add(predecessor);
   const differentBasis = formalPlans.filter((plan) => (
-    !retired.has(plan.planDigest) && sameTargetVersions(plan.targetVersions, targetVersions) && plan.subjectDigest !== subjectDigest
+    !retired.has(plan.planDigest) && overlaps(plan.plan, loaded.candidate.prepared) && plan.subjectDigest !== subjectDigest
   ));
   if (differentBasis.length > 0) {
     throw new ReleaseError(GATE_FAILED, 'a different formal acceptance basis already exists for this target', {