release-skill 0.9.35 → 0.9.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "release-skill",
-  "version": "0.9.35",
+  "version": "0.9.36",
   "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
   "author": {
     "name": "广州市风荷科技有限公司"

package/platform-manifest.json

@@ -2,11 +2,11 @@
   "schemaVersion": "1.0.0",
   "platformId": "release-skill",
   "platformName": "release-skill Plugin Platform",
-  "version": "0.9.35",
+  "version": "0.9.36",
   "logicalRoot": "skills-src/",
-  "logicalRootDigest": "05adb1b81257f99a74b7736f13a174095f79b0745f4c1a5947bb7d95ee9cf8ad",
-  "projectionDigest": "9ae26428567a5d7eaf2586626dcd503e0035205e99c3ec3c335f13b94ffa58c4",
-  "projectionId": "release-skill:platform:0.9.35",
+  "logicalRootDigest": "7ea5732a23d0b214990070bb6d3d9201cb5881f29efcfb2cbe4af5dd54531272",
+  "projectionDigest": "1e2ae0eeb42be53db44d4e1de02aea4034a68f6aa530afc681a53f24bd4c4622",
+  "projectionId": "release-skill:platform:0.9.36",
   "manifestRequired": true,
   "projectionSources": {
     "skills-src-root": {

package/references/.render-manifest.json

@@ -10,8 +10,8 @@
       "bytes": 16742
     },
     "02-project-config.md": {
-      "digest": "95ef58bcf788636c2b0300955e095a050829b51f6e5b4fc1a8d618d6b8a18021",
-      "bytes": 34314
+      "digest": "3e19eedbabb7e17d8afd4d9efc6a43309b7cc04e72866d44bd1afac787c8b462",
+      "bytes": 34998
     },
     "03-readme-quality.md": {
       "digest": "d74e41052592443ebbd450d0ace5f9b9b19c7a94db50f952b17c1c5a4c5dc230",

package/references/02-project-config.md

@@ -247,7 +247,9 @@ releaseUnits:
 
 Qoder 保持 build-only 分发边界，不新增发布计划内的 distribution 或安装检查点。本机收尾更新 Qoder 有四个前提：冻结计划已声明、用户显式选择、Hub 来源匹配、既有用户范围安装核对通过。流程不添加市场或执行首次安装。更新完成仅表示安装载荷已变更，不表示当前会话已加载新版，后续仍须重新加载或新开会话，并完成一次真实的只读业务调用。
 
-冻结与安装两侧均核验原生 `.qoder-plugin/plugin.json` 与 Claude 兼容 `.claude-plugin/plugin.json`：原生清单缺失时方可启用兼容清单，原生清单存在但无效时不得回退；两清单同时存在时，均须可解析为有效对象，且 `name/version/skills` 完全一致，以原生清单为优先。安装侧结果须与冻结侧选定的相对清单路径及 `skills` 一致，不得忽略额外出现的损坏或冲突清单。写入前复验冻结快照摘要，安装后须完整比较声明载荷与冻结来源，现有 `external-marketplace-v1` 合同允许宿主额外文件，因此完整载荷比较不得替代双清单的独立核验。
+在已核对的市场安装根内，分别读取 `marketplace.json` 的 `url` 来源与 `.claude-plugin/marketplace.json` 的 `github` 来源；至少一个存在，且所有存在候选都须有效并绑定同一冻结目标。根目录来源核对 `source.url/source.sha`；兼容来源沿现有 Claude 断言核对仓库、冻结标签、提交和版本。任一损坏或冲突均拒绝，不猜测优先级。
+
+冻结与安装两侧均核验原生 `.qoder-plugin/plugin.json` 与 Claude 兼容 `.claude-plugin/plugin.json`：原生清单缺失时方可启用兼容清单，原生清单存在但无效时不得回退；两清单同时存在时，均须可解析为有效对象，以原生清单为优先。每个已存在候选（包括未选候选）都须核对目标 `name/version`；其 `skills` 必须为非空字符串，经 `Foundation 0.25.0` 的 `resolveContained` 解析为根内真实目录。跨候选只比较 `name/version`，允许各自合法 `skills` 不同；原生正常不能遮蔽兼容无效。安装侧结果须与冻结侧选定的相对清单路径及 `skills` 一致，不得忽略额外出现的损坏或冲突清单。写入前复验冻结快照摘要，安装后须完整比较声明载荷与冻结来源，现有 `external-marketplace-v1` 合同允许宿主额外文件，因此完整载荷比较不得替代双清单的独立核验。
 
 0.9.21 起，同一声明也能执行 Claude、Codex、Kimi、CodeBuddy 和 WorkBuddy 的本机更新，无需恢复旧宿主 distribution。插件仓库、标签、提交和快照摘要必须来自冻结 unit 与对应标签动作。Claude、Codex 和 CodeBuddy 家族使用已有同源 Hub 市场；刷新前后分别核对宿主专用条目，安装后比较完整冻结载荷。CodeBuddy/WorkBuddy 只升级已有插件，并在插件写入前再次确认 Hub 分支未漂移。Kimi 直接使用冻结 GitHub Release 和终端交互，其只有仓库 URL 的 Hub 文件不承担标签或提交证明。启动进程保留三个代理变量 `http_proxy`、`https_proxy`、`all_proxy`。
 

package/schemas/.render-manifest.json

@@ -17,6 +17,10 @@
       "digest": "86c9cab024ebe9c7f8ec3358fcc12d05b8ed246ab59da2b0acc6a517f31274ea",
       "bytes": 2488
     },
+    "evidence-event-v2.schema.json": {
+      "digest": "693430e636afc85bf4a79e3f7bf3fb87254cbd62f2e3f35c35d6f84e5e8e0be1",
+      "bytes": 6058
+    },
     "evidence-event.schema.json": {
       "digest": "b7e14522a5aba818cab191545f23d2323be0e4c80566e9d3e4da576103a00490",
       "bytes": 2390
@@ -34,8 +38,8 @@
       "bytes": 57111
     },
     "release-run.schema.json": {
-      "digest": "4a041b8f6488e7d61b7eb271ebdbc2e043731df41c4437783ef63e77f664c192",
-      "bytes": 19002
+      "digest": "26c44ddf1ed42f266a2ddee7f6132cee94c59593e37f24359c9c48f12612ec22",
+      "bytes": 21874
     },
     "test-intake.schema.json": {
       "digest": "654e91ce518cb2b8aca84947d0c3bb8c4262ab047d86081e7e93dc07a9c6c739",

package/skills/release-finish/SKILL.md

@@ -72,9 +72,9 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 - Claude/Codex 的 Hub 目标只使用已经登记的同源市场。升级前先读取声明的 Hub 分支，并核对宿主专用索引中的插件仓库、标签、提交及存在的版本字段。刷新市场后再次核对实际目录和条目，再执行原有更新或重装命令。Claude 精确当前安装会离线核对真实载荷；Codex 列表不提供安装根时，仍须正式重装，从安装输出取得 `installedPath` 后核对载荷。旧安装动作继续使用冻结市场引用预检；远端不可达或引用不符时返回 `MANUAL_REQUIRED`。每个宿主单独保留结果，失败不会中断其他已选宿主。
 - Kimi 的精确当前安装会在返回 `ALREADY_CURRENT` 前核对真实载荷；发生安装或迁移时，只在操作完成后核对结果。配置根依次取显式 `kimiHome`、`KIMI_CODE_HOME`、用户主目录下的 `.kimi-code`，TUI 与安装后观察使用同一根。release-finish 当前只采用并验证 Kimi Code 的受控终端交互界面（TUI）路径，并把 TUI 工作目录固定为 `--root` 指定的当前发布项目。用户已确认冻结计划、显式选择更新且 `--hosts` 包含 `kimi` 时，流程读取完整的初始 `Trust this folder?` 对话框，要求其中只有一个正向项 `Trust this folder` 和一个选中项。正向项已经选中时不发送方向键，直接确认；已知拒绝项选中时，按它与正向项的相对位置移动一次，重新读取完整对话框并确认正向项已选中，然后才提交。插件命令发出后再次出现目录信任、界面或选中项未知、正向项缺失或重复、移动后无法确认、超时或提前退出时，该宿主失败并停止后续安装步骤。若后续 Kimi 版本出现新的可复现界面差异，先记录 Kimi 版本、可见选项、选中项及选项关系；这些事实足以唯一确认当前目录、正向信任项和选择结果时，在最近测试补回归与兼容并继续，目录身份或选项语义不明时仍停止并交回主会话。插件信任仍先清理 ANSI/OSC 控制序列和软换行，再分别核对冻结仓库与标签；只有选中 `Trust and install` 才提交并重新加载。包名、版本、发布标签、已安装修订号和受管安装根必须与冻结计划一致；`.git` 只提供附加诊断，不是通过条件。旧的本地路径安装会在同一 TUI 会话中先移除，再按发布标签安装。
 - CodeBuddy/WorkBuddy 只升级既有安装，不自动首装。CodeBuddy 仅探测全局 `codebuddy`/`cbc`，配置根固定为有效 `HOME` 下的 `.codebuddy`；WorkBuddy 仅在 macOS 探测应用内嵌 CLI，配置根固定为有效 `HOME` 下的 `.workbuddy`，两者不互作回退。Hub 目标先核对各自 `plugins/marketplaces/<hub>` 的远端和分支，再核对 `.codebuddy-plugin/marketplace.json` 条目。刷新市场后确认远端分支未漂移，才更新插件；最后核对列表中的版本、`gitCommitSha` 和 `plugins/cache/<hub>/<plugin>/<version>` 的完整载荷。旧 bundled-family 目标继续要求插件标签和市场分支均指向冻结提交。非 macOS 的 WorkBuddy 返回 `SKIPPED_UNSUPPORTED_PLATFORM`。
-- Qoder 首先通过 `qoder plugins marketplace list --json` 验证目标 Hub 的名称、仓库地址、分支信息及本机 checkout 状态，随后使用 `qoder plugins list --json` 核对唯一插件条目的市场归属、`scope=user`、版本号与 `installPath`。若目标市场或插件未安装，返回 `MANUAL_REQUIRED`，禁止自动添加市场或执行首次安装。对于旧版已安装情况，仅执行 `qoder plugins marketplace update <name>` 与 `qoder plugins update <plugin@marketplace> --scope user`。在市场刷新后、插件更新前，必须从 Hub 的 `marketplace.json` 中校验目标条目的 `source.url` 与 `source.sha`。
+- Qoder 首先通过 `qoder plugins marketplace list --json` 验证目标 Hub 的名称、仓库地址、分支信息及本机 checkout 状态，随后使用 `qoder plugins list --json` 核对唯一插件条目的市场归属、`scope=user`、版本号与 `installPath`。若目标市场或插件未安装，返回 `MANUAL_REQUIRED`，禁止自动添加市场或执行首次安装。对于旧版已安装情况，仅执行 `qoder plugins marketplace update <name>` 与 `qoder plugins update <plugin@marketplace> --scope user`。在市场刷新后、插件更新前，必须完成以下来源核验。在已核对的市场安装根内，分别读取 `marketplace.json` 的 `url` 来源与 `.claude-plugin/marketplace.json` 的 `github` 来源；至少一个存在，且所有存在候选都须有效并绑定同一冻结目标。根目录来源核对 `source.url/source.sha`；兼容来源沿现有 Claude 断言核对仓库、冻结标签、提交和版本。任一损坏或冲突均拒绝，不猜测优先级。
 
-  冻结快照与真实 `installPath` 均需比对 `.qoder-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 两个候选清单。仅当原生清单缺失时，方可启用兼容清单；原生清单存在但无效时不得回退。存在的清单均须可解析为有效对象，并满足插件身份与根内技能目录要求，双清单的 `name/version/skills` 必须完全一致，且以原生清单为优先。安装侧选择的相对清单路径及 `skills` 必须与冻结侧选择一致。安装侧额外出现的损坏或冲突清单不得忽略；允许宿主附加文件的 `external-marketplace-v1` 载荷完整比较，不可替代对清单的独立核验。
+  冻结快照与真实 `installPath` 均需比对 `.qoder-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 两个候选清单。仅当原生清单缺失时，方可启用兼容清单；原生清单存在但无效时不得回退。存在的清单均须可解析为有效对象，且以原生清单为优先。每个已存在候选（包括未选候选）都须核对目标 `name/version`；其 `skills` 必须为非空字符串，经 `Foundation 0.25.0` 的 `resolveContained` 解析为根内真实目录。跨候选只比较 `name/version`，允许各自合法 `skills` 不同；原生正常不能遮蔽兼容无效。安装侧选择的相对清单路径及 `skills` 必须与冻结侧选择一致。安装侧额外出现的损坏或冲突清单不得忽略；允许宿主附加文件的 `external-marketplace-v1` 载荷完整比较，不可替代对清单的独立核验。
 
   冻结快照摘要须在宿主写入前完成复验，安装后仍需复验完整声明载荷与冻结来源；即使版本已为目标版本，也必须完成全部复验后方可返回 `ALREADY_CURRENT`。市场在检查与更新之间可能发生变更，若事后身份校验失败，报告错误，不进行自动降级、卸载或覆盖。
 

package/skills/release-help/SKILL.md

@@ -29,7 +29,7 @@ description: "Discoverable entry point for release-skill: dependency and environ
 
 治理诊断只运行 release-skill 自己的只读检查程序，不运行目标 Skill、业务脚本、构建、hook 或发布动作，也不把 `prepare`、`verify`、`release-finish` 当作静态治理入口。用户要求实际接入或发布时，把已有授权带到对应原业务入口；各入口继续执行原有确认、副作用和状态机合同。
 
-## 0.9.35 能力与证据边界
+## 0.9.36 能力与证据边界
 
 四类工程材料接到现有 `release-project` 字段。公开正式材料写入 `publicFiles`（`sourceScope` / `from` / `to` / `mode`）。运行必需资源写入 `requiredPublicFiles`，必须被同一单元 `publicFiles[].to` 精确覆盖。私有正式材料与非正式运行材料不列入 `publicFiles`，需要挡住时使用 `forbiddenPaths` / `forbiddenContentPatterns`。正式不等于公开。是否进入公开快照由 `publicFiles` 是否列出决定。npm 是载荷渠道。`package.json` 的 `files` 与入口闭包和公开映射同时约束。`delivery.include` / `delivery.exclude` 只选择宿主，不是文件包含或排除。排除不得拿掉运行必需资源。互相冲突的配置必须失败关闭。
 

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

@@ -72,9 +72,9 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 - Claude/Codex 的 Hub 目标只使用已经登记的同源市场。升级前先读取声明的 Hub 分支，并核对宿主专用索引中的插件仓库、标签、提交及存在的版本字段。刷新市场后再次核对实际目录和条目，再执行原有更新或重装命令。Claude 精确当前安装会离线核对真实载荷；Codex 列表不提供安装根时，仍须正式重装，从安装输出取得 `installedPath` 后核对载荷。旧安装动作继续使用冻结市场引用预检；远端不可达或引用不符时返回 `MANUAL_REQUIRED`。每个宿主单独保留结果，失败不会中断其他已选宿主。
 - Kimi 的精确当前安装会在返回 `ALREADY_CURRENT` 前核对真实载荷；发生安装或迁移时，只在操作完成后核对结果。配置根依次取显式 `kimiHome`、`KIMI_CODE_HOME`、用户主目录下的 `.kimi-code`，TUI 与安装后观察使用同一根。release-finish 当前只采用并验证 Kimi Code 的受控终端交互界面（TUI）路径，并把 TUI 工作目录固定为 `--root` 指定的当前发布项目。用户已确认冻结计划、显式选择更新且 `--hosts` 包含 `kimi` 时，流程读取完整的初始 `Trust this folder?` 对话框，要求其中只有一个正向项 `Trust this folder` 和一个选中项。正向项已经选中时不发送方向键，直接确认；已知拒绝项选中时，按它与正向项的相对位置移动一次，重新读取完整对话框并确认正向项已选中，然后才提交。插件命令发出后再次出现目录信任、界面或选中项未知、正向项缺失或重复、移动后无法确认、超时或提前退出时，该宿主失败并停止后续安装步骤。若后续 Kimi 版本出现新的可复现界面差异，先记录 Kimi 版本、可见选项、选中项及选项关系；这些事实足以唯一确认当前目录、正向信任项和选择结果时，在最近测试补回归与兼容并继续，目录身份或选项语义不明时仍停止并交回主会话。插件信任仍先清理 ANSI/OSC 控制序列和软换行，再分别核对冻结仓库与标签；只有选中 `Trust and install` 才提交并重新加载。包名、版本、发布标签、已安装修订号和受管安装根必须与冻结计划一致；`.git` 只提供附加诊断，不是通过条件。旧的本地路径安装会在同一 TUI 会话中先移除，再按发布标签安装。
 - CodeBuddy/WorkBuddy 只升级既有安装，不自动首装。CodeBuddy 仅探测全局 `codebuddy`/`cbc`，配置根固定为有效 `HOME` 下的 `.codebuddy`；WorkBuddy 仅在 macOS 探测应用内嵌 CLI，配置根固定为有效 `HOME` 下的 `.workbuddy`，两者不互作回退。Hub 目标先核对各自 `plugins/marketplaces/<hub>` 的远端和分支，再核对 `.codebuddy-plugin/marketplace.json` 条目。刷新市场后确认远端分支未漂移，才更新插件；最后核对列表中的版本、`gitCommitSha` 和 `plugins/cache/<hub>/<plugin>/<version>` 的完整载荷。旧 bundled-family 目标继续要求插件标签和市场分支均指向冻结提交。非 macOS 的 WorkBuddy 返回 `SKIPPED_UNSUPPORTED_PLATFORM`。
-- Qoder 首先通过 `qoder plugins marketplace list --json` 验证目标 Hub 的名称、仓库地址、分支信息及本机 checkout 状态，随后使用 `qoder plugins list --json` 核对唯一插件条目的市场归属、`scope=user`、版本号与 `installPath`。若目标市场或插件未安装，返回 `MANUAL_REQUIRED`，禁止自动添加市场或执行首次安装。对于旧版已安装情况，仅执行 `qoder plugins marketplace update <name>` 与 `qoder plugins update <plugin@marketplace> --scope user`。在市场刷新后、插件更新前，必须从 Hub 的 `marketplace.json` 中校验目标条目的 `source.url` 与 `source.sha`。
+- Qoder 首先通过 `qoder plugins marketplace list --json` 验证目标 Hub 的名称、仓库地址、分支信息及本机 checkout 状态，随后使用 `qoder plugins list --json` 核对唯一插件条目的市场归属、`scope=user`、版本号与 `installPath`。若目标市场或插件未安装，返回 `MANUAL_REQUIRED`，禁止自动添加市场或执行首次安装。对于旧版已安装情况，仅执行 `qoder plugins marketplace update <name>` 与 `qoder plugins update <plugin@marketplace> --scope user`。在市场刷新后、插件更新前，必须完成以下来源核验。在已核对的市场安装根内，分别读取 `marketplace.json` 的 `url` 来源与 `.claude-plugin/marketplace.json` 的 `github` 来源；至少一个存在，且所有存在候选都须有效并绑定同一冻结目标。根目录来源核对 `source.url/source.sha`；兼容来源沿现有 Claude 断言核对仓库、冻结标签、提交和版本。任一损坏或冲突均拒绝，不猜测优先级。
 
-  冻结快照与真实 `installPath` 均需比对 `.qoder-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 两个候选清单。仅当原生清单缺失时，方可启用兼容清单；原生清单存在但无效时不得回退。存在的清单均须可解析为有效对象，并满足插件身份与根内技能目录要求，双清单的 `name/version/skills` 必须完全一致，且以原生清单为优先。安装侧选择的相对清单路径及 `skills` 必须与冻结侧选择一致。安装侧额外出现的损坏或冲突清单不得忽略；允许宿主附加文件的 `external-marketplace-v1` 载荷完整比较，不可替代对清单的独立核验。
+  冻结快照与真实 `installPath` 均需比对 `.qoder-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 两个候选清单。仅当原生清单缺失时，方可启用兼容清单；原生清单存在但无效时不得回退。存在的清单均须可解析为有效对象，且以原生清单为优先。每个已存在候选（包括未选候选）都须核对目标 `name/version`；其 `skills` 必须为非空字符串，经 `Foundation 0.25.0` 的 `resolveContained` 解析为根内真实目录。跨候选只比较 `name/version`，允许各自合法 `skills` 不同；原生正常不能遮蔽兼容无效。安装侧选择的相对清单路径及 `skills` 必须与冻结侧选择一致。安装侧额外出现的损坏或冲突清单不得忽略；允许宿主附加文件的 `external-marketplace-v1` 载荷完整比较，不可替代对清单的独立核验。
 
   冻结快照摘要须在宿主写入前完成复验，安装后仍需复验完整声明载荷与冻结来源；即使版本已为目标版本，也必须完成全部复验后方可返回 `ALREADY_CURRENT`。市场在检查与更新之间可能发生变更，若事后身份校验失败，报告错误，不进行自动降级、卸载或覆盖。
 

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

@@ -29,7 +29,7 @@ description: "Discoverable entry point for release-skill: dependency and environ
 
 治理诊断只运行 release-skill 自己的只读检查程序，不运行目标 Skill、业务脚本、构建、hook 或发布动作，也不把 `prepare`、`verify`、`release-finish` 当作静态治理入口。用户要求实际接入或发布时，把已有授权带到对应原业务入口；各入口继续执行原有确认、副作用和状态机合同。
 
-## 0.9.35 能力与证据边界
+## 0.9.36 能力与证据边界
 
 四类工程材料接到现有 `release-project` 字段。公开正式材料写入 `publicFiles`（`sourceScope` / `from` / `to` / `mode`）。运行必需资源写入 `requiredPublicFiles`，必须被同一单元 `publicFiles[].to` 精确覆盖。私有正式材料与非正式运行材料不列入 `publicFiles`，需要挡住时使用 `forbiddenPaths` / `forbiddenContentPatterns`。正式不等于公开。是否进入公开快照由 `publicFiles` 是否列出决定。npm 是载荷渠道。`package.json` 的 `files` 与入口闭包和公开映射同时约束。`delivery.include` / `delivery.exclude` 只选择宿主，不是文件包含或排除。排除不得拿掉运行必需资源。互相冲突的配置必须失败关闭。
 

package/src/adapters/plugin-marketplace.mjs

@@ -823,6 +823,88 @@ export function normalizeCodeBuddySkillsRel(skillsRaw) {
   return rel;
 }
 
+/**
+ * Resolve a Codex entry skill using the plugin manifest at the actual plugin
+ * root. An omitted `skills` field keeps Codex's conventional `skills/` root;
+ * an explicit declaration is authoritative and must be valid and present.
+ *
+ * The short-name layout keeps priority over the plugin-prefixed layout, but
+ * fallback is allowed only when the short-name candidate is absent. Existing
+ * unsafe candidates are errors and cannot be hidden by a second layout.
+ *
+ * @param {string} pluginRoot - Real plugin root derived from source or install.
+ * @param {string} entrySkill - Frozen entry-skill id.
+ * @param {string} pluginName - Frozen plugin id used by the legacy prefix.
+ * @returns {Promise<string>} Absolute path to a regular, non-symlink SKILL.md.
+ */
+async function resolveCodexEntrySkillFile(pluginRoot, entrySkill, pluginName) {
+  const { normalizeGenericSkillsRel } = await import('../core/surface-host-bindings.mjs');
+  if (!entrySkill || typeof entrySkill !== 'string' || !SAFE_ID_RE.test(entrySkill)) {
+    throw new Error(`unsafe entrySkill: "${entrySkill}"`);
+  }
+
+  const platform = getPlatform('codex');
+  const manifestPath = await resolveContained(pluginRoot, platform.manifestPaths.plugin);
+  let manifest;
+  try {
+    manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
+  } catch (err) {
+    throw new Error(`Codex plugin manifest cannot be read: ${err.message}`);
+  }
+  if (!manifest || typeof manifest !== 'object' || Array.isArray(manifest)) {
+    throw new Error('Codex plugin manifest must be an object');
+  }
+
+  const skillsRel = Object.hasOwn(manifest, 'skills')
+    ? normalizeGenericSkillsRel(manifest.skills)
+    : 'skills';
+  const skillsRoot = await resolveContained(pluginRoot, skillsRel);
+  let skillsRootStat;
+  try {
+    skillsRootStat = await lstat(skillsRoot);
+  } catch {
+    throw new Error(`Codex manifest skills root does not exist: ${manifest.skills ?? skillsRel}`);
+  }
+  if (skillsRootStat.isSymbolicLink() || !skillsRootStat.isDirectory()) {
+    throw new Error(`Codex manifest skills root must be a real directory: ${manifest.skills ?? skillsRel}`);
+  }
+
+  const findCandidate = async (skillDirName) => {
+    const skillDir = await resolveContained(pluginRoot, `${skillsRel}/${skillDirName}`);
+    let skillDirStat;
+    try {
+      skillDirStat = await lstat(skillDir);
+    } catch (err) {
+      if (err?.code === 'ENOENT') return null;
+      throw err;
+    }
+    if (skillDirStat.isSymbolicLink() || !skillDirStat.isDirectory()) {
+      throw new Error(`Codex entry skill directory must be a real directory: ${skillsRel}/${skillDirName}`);
+    }
+
+    const skillFile = await resolveContained(pluginRoot, `${skillsRel}/${skillDirName}/SKILL.md`);
+    let skillStat;
+    try {
+      skillStat = await lstat(skillFile);
+    } catch (err) {
+      if (err?.code === 'ENOENT') return null;
+      throw err;
+    }
+    if (skillStat.isSymbolicLink() || !skillStat.isFile()) {
+      throw new Error(`Codex entry skill must be a regular non-symlink file: ${skillsRel}/${skillDirName}/SKILL.md`);
+    }
+    return skillFile;
+  };
+
+  const shortNameEntry = await findCandidate(entrySkill);
+  if (shortNameEntry) return shortNameEntry;
+  if (pluginName && SAFE_ID_RE.test(pluginName)) {
+    const prefixedEntry = await findCandidate(`${pluginName}-${entrySkill}`);
+    if (prefixedEntry) return prefixedEntry;
+  }
+  throw new Error(`Codex entry skill not found: ${skillsRel}/${entrySkill}/SKILL.md`);
+}
+
 /**
  * CodeBuddy equivalent of resolveKimiEntrySkillFile (parallel implementation,
  * codebuddy wording; the kimi helper above is intentionally left untouched).
@@ -2110,8 +2192,8 @@ export function createPluginMarketplaceAdapter(deps = {}) {
           // snapshot, so the snapshot marketplace-manifest section is skipped
           // entirely. The plugin manifest is read directly from the snapshot
           // root and the frozen external identity fields are validated. ref was
-          // already injection-checked above (step 2); the entry skill reuses the
-          // automatable fixed layout validated below.
+          // already injection-checked above (step 2); Codex entry lookup reads
+          // the plugin manifest from this snapshot root.
           if (
             typeof action.marketplaceCommitSha !== 'string'
             || !/^[0-9a-f]{40}$/.test(action.marketplaceCommitSha)
@@ -2315,13 +2397,10 @@ export function createPluginMarketplaceAdapter(deps = {}) {
           }
           }
 
-          // Verify the entry skill exists in the snapshot.
-          // Structured-cli platforms' manifests always declare ./skills/, so the
-          // fixed skills/<entrySkill>/SKILL.md layout is authoritative for
-          // them. A human-attestation platform (kimi, codebuddy) resolves the
-          // entry skill via the manifest-declared skills root (MAJOR-4): the
-          // root is validated + realpath-contained, and omitted `skills` means
-          // the official single-skill root SKILL.md.
+          // Verify the entry skill exists in the snapshot. Kimi/CodeBuddy use
+          // their existing manifest-specific rules; Codex resolves its own
+          // manifest-declared skills root below. Claude keeps its established
+          // conventional skills/ lookup and prefixed fallback.
           if (platformRoute.route === 'human-attestation') {
             const resolveEntrySkillFile = consumer === 'codebuddy'
               ? resolveCodeBuddyEntrySkillFile
@@ -2335,6 +2414,17 @@ export function createPluginMarketplaceAdapter(deps = {}) {
                 error: `entry skill not resolvable in snapshot: ${entryErr.message}`,
               });
             }
+          } else if (consumer === 'codex') {
+            const pluginRootForSkill = pluginRootForEntrySkill || snapshotDirReal;
+            try {
+              await resolveCodexEntrySkillFile(pluginRootForSkill, action.entrySkill, action.plugin);
+            } catch (entryErr) {
+              return createResult({
+                actionType,
+                status: ActionStatus.PREFLIGHT_FAILED,
+                error: `entry skill not resolvable in snapshot: ${entryErr.message}`,
+              });
+            }
           } else {
             // Entry skill 相对插件根解析（嵌套布局时 pluginRoot != snapshotRoot）。
             // pluginRootForEntrySkill 在非 external 结构化 CLI 路径中已确定；
@@ -3735,48 +3825,67 @@ export function createPluginMarketplaceAdapter(deps = {}) {
           }
 
           // Verify entry skill exists as a regular file in install dir.
-          // Prefixed skill-directory fallback (0.5.1 entry-skill-prefix fix):
-          // mirror the preflight resolution — `skills/<entrySkill>` first,
-          // then `skills/<plugin>-<entrySkill>` when the plugin is known.
-          let entrySkillPath = resolve(installPath, 'skills', action.entrySkill, 'SKILL.md');
-          let entrySkillFound = false;
-          try {
-            const skillStat = await lstat(entrySkillPath);
-            if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
-              entrySkillFound = true;
+          // Codex uses its actual installed plugin manifest for the skills
+          // root, keeping observation aligned with frozen-source preflight.
+          if (consumer === 'codex') {
+            try {
+              await resolveCodexEntrySkillFile(installPath, action.entrySkill, action.plugin);
+            } catch (entryErr) {
+              return createResult({
+                actionType,
+                status: ActionStatus.OBSERVED,
+                observation: {
+                  installed: true,
+                  installPath,
+                  entrySkillFound: false,
+                  error: `entry skill not resolvable in installed plugin: ${entryErr.message}`,
+                },
+              });
             }
-          } catch {
-            // entry skill not found in unprefixed layout
-          }
-          if (!entrySkillFound && action.plugin) {
-            const prefixedPath = resolve(
-              installPath,
-              'skills',
-              `${action.plugin}-${action.entrySkill}`,
-              'SKILL.md',
-            );
+          } else {
+            // Prefixed skill-directory fallback (0.5.1 entry-skill-prefix fix):
+            // mirror the preflight resolution — `skills/<entrySkill>` first,
+            // then `skills/<plugin>-<entrySkill>` when the plugin is known.
+            let entrySkillPath = resolve(installPath, 'skills', action.entrySkill, 'SKILL.md');
+            let entrySkillFound = false;
             try {
-              const skillStat = await lstat(prefixedPath);
+              const skillStat = await lstat(entrySkillPath);
               if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
-                entrySkillPath = prefixedPath;
                 entrySkillFound = true;
               }
             } catch {
-              // both layouts miss; report below
+              // entry skill not found in unprefixed layout
             }
-          }
-
-          if (!entrySkillFound) {
-            return createResult({
-              actionType,
-              status: ActionStatus.OBSERVED,
-              observation: {
-                installed: true,
+            if (!entrySkillFound && action.plugin) {
+              const prefixedPath = resolve(
                 installPath,
-                entrySkillFound: false,
-                error: `entry skill not found: skills/${action.entrySkill}/SKILL.md`,
-              },
-            });
+                'skills',
+                `${action.plugin}-${action.entrySkill}`,
+                'SKILL.md',
+              );
+              try {
+                const skillStat = await lstat(prefixedPath);
+                if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
+                  entrySkillPath = prefixedPath;
+                  entrySkillFound = true;
+                }
+              } catch {
+                // both layouts miss; report below
+              }
+            }
+
+            if (!entrySkillFound) {
+              return createResult({
+                actionType,
+                status: ActionStatus.OBSERVED,
+                observation: {
+                  installed: true,
+                  installPath,
+                  entrySkillFound: false,
+                  error: `entry skill not found: skills/${action.entrySkill}/SKILL.md`,
+                },
+              });
+            }
           }
 
           // Bind the installed payload back to the sealed authority while

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

@@ -846,7 +846,7 @@ async function observeQoderPlugin(target, command, env, run) {
   };
 }
 
-async function readQoderManifest(root, label) {
+async function readQoderManifest(root, label, target) {
   const candidates = [];
   for (const manifestPath of ['.qoder-plugin/plugin.json', '.claude-plugin/plugin.json']) {
     let text;
@@ -860,10 +860,11 @@ async function readQoderManifest(root, label) {
     if (!manifest || typeof manifest !== 'object' || Array.isArray(manifest)) {
       throw new Error(`${label} (${manifestPath}) did not return an object`);
     }
+    await assertQoderPluginManifest(target, manifest, `${label} (${manifestPath})`, root);
     candidates.push({ manifestPath, manifest });
   }
   if (candidates.length === 0) throw new Error(`${label} has no native or compatible plugin manifest`);
-  if (candidates.length === 2 && ['name', 'version', 'skills'].some((field) => (
+  if (candidates.length === 2 && ['name', 'version'].some((field) => (
     candidates[0].manifest[field] !== candidates[1].manifest[field]
   ))) {
     throw new Error(`${label} does not match the frozen Qoder plugin identity and projection path: conflicting native and compatible manifests`);
@@ -894,31 +895,49 @@ async function assertFrozenQoderManifest(target, root) {
     snapshotPath: target.snapshotPath,
     expectedDigest: target.manifestDigest,
   });
-  const { manifestPath, manifest } = await readQoderManifest(snapshotRoot, 'frozen Qoder plugin manifest');
+  const { manifestPath, manifest } = await readQoderManifest(snapshotRoot, 'frozen Qoder plugin manifest', target);
   const skills = await assertQoderPluginManifest(target, manifest, 'frozen Qoder plugin manifest', snapshotRoot);
   return { manifestPath, skills };
 }
 
 async function assertQoderHubEntry(target, marketplaceRoot) {
-  const marketplace = parseJson(
-    await readFileContained(marketplaceRoot, 'marketplace.json', { encoding: 'utf8' }),
-    'Qoder Hub marketplace manifest',
-  );
-  if (marketplace?.name !== target.marketplace || !Array.isArray(marketplace.plugins)) {
-    throw new Error('Qoder Hub marketplace manifest does not match the frozen marketplace');
-  }
-  const matches = marketplace.plugins.filter((entry) => entry?.name === target.plugin);
-  if (matches.length !== 1) {
-    throw new Error(`Qoder Hub marketplace manifest must contain exactly one ${target.plugin} entry`);
-  }
-  const source = matches[0]?.source;
-  if (
-    source?.source !== 'url'
-    || normalizeHubGitSource(source.url, target.hub.githubHost) !== target.pluginRepo
-    || source.sha !== target.pluginCommit
-  ) {
-    throw new Error('Qoder Hub entry does not match the frozen public source identity');
+  let found = false;
+  for (const indexPath of ['marketplace.json', '.claude-plugin/marketplace.json']) {
+    let text;
+    try {
+      text = await readFileContained(marketplaceRoot, indexPath, { encoding: 'utf8' });
+    } catch (error) {
+      if (error?.code === 'SFC2004' && error?.details?.kind === 'missing-resource') continue;
+      throw error;
+    }
+    found = true;
+    const marketplace = parseJson(text, `Qoder Hub marketplace manifest (${indexPath})`);
+    if (!marketplace || typeof marketplace !== 'object' || Array.isArray(marketplace)
+      || marketplace.name !== target.marketplace || !Array.isArray(marketplace.plugins)) {
+      throw new Error('Qoder Hub marketplace manifest does not match the frozen marketplace');
+    }
+    if (indexPath === '.claude-plugin/marketplace.json') {
+      if (target.hub.githubHost !== 'github.com' || typeof target.frozenTag !== 'string' || target.frozenTag.length === 0) {
+        throw new Error('Qoder compatible Hub entry requires a frozen GitHub tag identity');
+      }
+      await assertHubHostEntry({ ...target, host: 'claude', pluginTag: target.frozenTag, githubHost: target.hub.githubHost }, marketplaceRoot);
+      continue;
+    }
+    const matches = marketplace.plugins.filter((entry) => entry?.name === target.plugin);
+    if (matches.length !== 1) {
+      throw new Error(`Qoder Hub marketplace manifest must contain exactly one ${target.plugin} entry`);
+    }
+    const entry = matches[0];
+    const source = entry.source;
+    if (source?.source !== 'url'
+      || normalizeHubGitSource(source.url, target.hub.githubHost) !== target.pluginRepo
+      || source.sha !== target.pluginCommit
+      || (entry.version !== undefined && entry.version !== target.version)
+      || (source.ref !== undefined && (typeof target.frozenTag !== 'string' || source.ref !== target.frozenTag))) {
+      throw new Error('Qoder Hub entry does not match the frozen public source identity');
+    }
   }
+  if (!found) throw new Error('Qoder Hub has no native or compatible marketplace manifest');
 }
 
 async function verifyQoderInstalledPayload({
@@ -928,7 +947,7 @@ async function verifyQoderInstalledPayload({
   frozenManifest,
   verifyInstalledPayload,
 }) {
-  const { manifestPath, manifest } = await readQoderManifest(installPath, 'installed Qoder plugin manifest');
+  const { manifestPath, manifest } = await readQoderManifest(installPath, 'installed Qoder plugin manifest', target);
   if (manifestPath !== frozenManifest.manifestPath) {
     throw new Error('installed Qoder plugin manifest path differs from the frozen manifest selection');
   }