release-skill 0.9.15 → 0.9.16

package/adapters/codex/skills/release-finish/SKILL.md

@@ -77,6 +77,64 @@ node "$RELEASE_SKILL_LOCAL_FINISH_ENTRY" \
 
 完成后报告每个宿主的状态，并提醒用户重启已更新的宿主。本机结果只记录收尾事实，不改变发布状态。
 
+## 配置与目录
+
+从发布项目目录的 `.release-skill/project.yaml` 读取 `releaseFinish` 和 `project.defaultBranch`。
+文件缺失或无法解析时，报告具体配置问题，不猜默认分支或 setup，也不得把文件缺失当作字段合法缺省；
+已经取得的发布结果仍保留。只有配置文件有效时，整个 `releaseFinish` 或其中字段缺省才按各自合同默认。
+
+发布项目目录用于读取配置和执行源码 Git 检查。setup 使用用户明确指定的消费项目目录或已明确的使用
+上下文。只有用户明确把发布源码仓库作为消费项目时，才能在那里执行 setup；同时提供两个目录时不得混用。
+
+## 更新后 setup
+
+完成现有清单及已授权的宿主处理后，读取发布项目 `.release-skill/project.yaml` 的
+`releaseFinish.setupSkill`。未配置时不增加 setup 提示。配置的技能名只用于匹配入口，不作为 shell 命令执行，
+也不授权安装同名插件。
+
+只有本次所选宿主已经成功更新，或现有检查确认它已是目标版本时，才衔接 setup。通过宿主实际技能
+元数据核对目标插件身份、版本和入口；不能从开发仓库、旧会话缓存或同名技能推断新版已加载。当前宿主
+不满足时，可以使用同次更新中另一个已安装并加载目标版本和入口的宿主。
+
+目标目录来自用户本次明确指定的消费项目或已明确的使用上下文。目录不明确、宿主需要重启、当前环境
+不能调用可用宿主、入口不存在或归属有歧义时，标为“待执行”，并给出插件与版本、技能名、目标目录和
+已有授权的续接提示。发出提示不代表 setup 已完成。
+
+对同一插件版本、同一项目目录和相同共享运行环境，项目级依赖、项目配置和 Git hooks 由一个已加载
+新版插件的宿主检查一次。其余宿主分别核对自身安装、加载和宿主专属配置。不同运行环境不得无条件
+复用项目就绪结论；按目标 setup 的实际合同补查差异。release-finish 不保存去重键、收据或新的状态。
+
+调用 setup 前完整读取目标技能及其必读引用，并传入目标项目、插件版本、只读检查意图和已有授权范围。
+已有具体修复授权应传递给 setup；未覆盖的写入不能执行。只读检查、安装结果和配置修复结果分别报告。
+最终自然语言回复列出执行宿主、插件版本、消费项目路径、实际结果和未完成项。任何 setup 结果都不改变
+`VERIFIED`，也不影响其他宿主已经完成的结果。
+
+## 源码分支检查
+
+宿主更新和 setup 不影响本项检查。读取 `releaseFinish.sourceBranchCheck`；字段或整个
+`releaseFinish` 缺省时按 `remind` 处理。配置为 `skip` 时不运行 Git 命令，只说明项目已关闭
+源码分支检查。
+
+`remind` 时，在发布项目目录依次运行两条只读命令：
+
+```bash
+git branch --show-current
+git status --short --branch
+```
+
+第一条命令取得当前分支。第二条命令读取工作区改动和现有上游跟踪摘要；不得增加会写入或访问网络的
+参数。当前分支等于 `project.defaultBranch` 且没有文件改动时，说明本地已位于目标分支；输出含
+ahead 或 behind 等跟踪信息时，仍原样概括。分支不一致时说明两个准确名称，并询问用户是否需要处理。
+第一条命令输出为空时，说明处于 detached HEAD，不猜测目标操作。工作区存在改动时说明不建议直接
+切换或清理。任一命令失败时，报告命令、退出结果和无法完成检查的事实。
+
+最终自然语言回复至少列出提醒策略、目标分支、当前分支或无法取得的事实、工作区是否有改动、Git
+上游跟踪摘要，以及是否需要用户决定下一步。没有上游信息时，明确说明命令输出未显示上游信息。
+
+本项检查不从宿主更新推导出 Git 写入授权，不自动执行 fetch、switch、checkout、merge、rebase、stash、
+reset、clean 或 push。用户跳过宿主更新仍执行默认分支检查。用户已经明确授权同一仓库、分支和操作时，
+按项目 Git 纪律继续，不重复询问相同授权；检查本身不改变 `VERIFIED`，不保存结果，也不产生新的 run。
+
 ## 临时归属
 
 本能力目前只服务发布后的本机收尾，因此保留在 release-skill。第二个技能族需要复用宿主更新或 TUI 驱动，或 Foundation 发布等价公共入口时，再把通用机制上收 Foundation并删除这里的通用部分。release-skill 只保留发布计划到宿主更新输入的领域映射。

package/adapters/kimi/.kimi-plugin/plugin.json

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

package/adapters/kimi/bin/release-skill.bundle.mjs

@@ -9,9 +9,9 @@ const __bundlePkgRoot = __bundleResolve(__bundleDirname(__bundleFileURLToPath(im
 // Provide a real require() for CJS packages bundled into ESM (e.g. yaml, ajv).
 const __bundleRealRequire = __bundleCreateRequire(import.meta.url);
 // Package identity injected at build time — closure-independent --version probe.
-const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.15"});
+const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.16"});
 // Build-time source digest for the BUNDLE_STALE freshness gate (see above).
-const __bundleSourceDigest = "e47969ed810fa0edbed7073f13df855be95feed7ffecc40f72dd887cab52ff97";
+const __bundleSourceDigest = "ba44ad70cebc1cc077887bdf71bf36d78b9073c8aeabd0074aac2eb0d5caffea";
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -148166,6 +148166,23 @@ This command creates an independent postVerify run and never reads or writes shi
       root,
       ...postpublishApprovalPaths.length > 0 ? { postpublishApprovalPaths } : {}
     });
+    if (result2.status === "DISTRIBUTED") {
+      const {
+        derivePostReleaseChecklist: derivePostReleaseChecklist2,
+        unavailablePostReleaseChecklist: unavailablePostReleaseChecklist2
+      } = await init_post_release_local().then(() => post_release_local_exports);
+      let plan;
+      try {
+        plan = JSON.parse(await readFile57(resolve42(planPath), "utf8"));
+        result2.postRelease = derivePostReleaseChecklist2(plan, {
+          root,
+          runPath: result2.runPath,
+          postVerifyComplete: true
+        });
+      } catch (error) {
+        result2.postRelease = unavailablePostReleaseChecklist2(plan, error);
+      }
+    }
     if (hasJson) {
       console.log(JSON.stringify(result2, null, 2));
     } else {
@@ -148174,6 +148191,17 @@ This command creates an independent postVerify run and never reads or writes shi
         console.log(`  ${cp4.actionId}: ${cp4.status}`);
       }
       if (result2.runPath) console.log(`PostVerify run: ${result2.runPath}`);
+      if (result2.postRelease?.status === "UNAVAILABLE") {
+        console.warn(`Post-release checklist unavailable: ${result2.postRelease.diagnostic?.message ?? "unknown error"}`);
+      } else if (result2.postRelease?.localHostUpdate?.promptRequired === true) {
+        const localHostUpdate = result2.postRelease.localHostUpdate;
+        console.log(`Post-release: ask whether to update local host plugins (${localHostUpdate.hosts.join(", ")}).`);
+        if (localHostUpdate.available === true && typeof localHostUpdate.runPath === "string") {
+          console.log(`Post-release command: release-skill post-release --plan ${resolve42(planPath)} --run ${localHostUpdate.runPath}`);
+          console.log("Choose --hosts before adding --update-local-hosts to perform a local update.");
+        }
+        printHubManualTargets(localHostUpdate.targets);
+      }
     }
     await exitAfterFlush(result2.status === "DISTRIBUTED" ? 0 : 1);
   } catch (err) {

package/adapters/kimi/schemas/release-project.schema.json

@@ -44,6 +44,24 @@
         }
       }
     },
+    "releaseFinish": {
+      "type": "object",
+      "description": "Optional local post-release finish settings. Omitted sourceBranchCheck defaults to remind.",
+      "additionalProperties": false,
+      "properties": {
+        "sourceBranchCheck": {
+          "type": "string",
+          "enum": [
+            "remind",
+            "skip"
+          ]
+        },
+        "setupSkill": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*(?::[a-z0-9][a-z0-9-]*)?$"
+        }
+      }
+    },
     "publicSourceAuthorityReceipt": {
       "type": "object",
       "description": "Optional public source-authority receipt uploaded to one coordinator GitHub Release after all subject npm tarballs are frozen.",

package/adapters/kimi/skills/release-finish/SKILL.md

@@ -77,6 +77,64 @@ node "$RELEASE_SKILL_LOCAL_FINISH_ENTRY" \
 
 完成后报告每个宿主的状态，并提醒用户重启已更新的宿主。本机结果只记录收尾事实，不改变发布状态。
 
+## 配置与目录
+
+从发布项目目录的 `.release-skill/project.yaml` 读取 `releaseFinish` 和 `project.defaultBranch`。
+文件缺失或无法解析时，报告具体配置问题，不猜默认分支或 setup，也不得把文件缺失当作字段合法缺省；
+已经取得的发布结果仍保留。只有配置文件有效时，整个 `releaseFinish` 或其中字段缺省才按各自合同默认。
+
+发布项目目录用于读取配置和执行源码 Git 检查。setup 使用用户明确指定的消费项目目录或已明确的使用
+上下文。只有用户明确把发布源码仓库作为消费项目时，才能在那里执行 setup；同时提供两个目录时不得混用。
+
+## 更新后 setup
+
+完成现有清单及已授权的宿主处理后，读取发布项目 `.release-skill/project.yaml` 的
+`releaseFinish.setupSkill`。未配置时不增加 setup 提示。配置的技能名只用于匹配入口，不作为 shell 命令执行，
+也不授权安装同名插件。
+
+只有本次所选宿主已经成功更新，或现有检查确认它已是目标版本时，才衔接 setup。通过宿主实际技能
+元数据核对目标插件身份、版本和入口；不能从开发仓库、旧会话缓存或同名技能推断新版已加载。当前宿主
+不满足时，可以使用同次更新中另一个已安装并加载目标版本和入口的宿主。
+
+目标目录来自用户本次明确指定的消费项目或已明确的使用上下文。目录不明确、宿主需要重启、当前环境
+不能调用可用宿主、入口不存在或归属有歧义时，标为“待执行”，并给出插件与版本、技能名、目标目录和
+已有授权的续接提示。发出提示不代表 setup 已完成。
+
+对同一插件版本、同一项目目录和相同共享运行环境，项目级依赖、项目配置和 Git hooks 由一个已加载
+新版插件的宿主检查一次。其余宿主分别核对自身安装、加载和宿主专属配置。不同运行环境不得无条件
+复用项目就绪结论；按目标 setup 的实际合同补查差异。release-finish 不保存去重键、收据或新的状态。
+
+调用 setup 前完整读取目标技能及其必读引用，并传入目标项目、插件版本、只读检查意图和已有授权范围。
+已有具体修复授权应传递给 setup；未覆盖的写入不能执行。只读检查、安装结果和配置修复结果分别报告。
+最终自然语言回复列出执行宿主、插件版本、消费项目路径、实际结果和未完成项。任何 setup 结果都不改变
+`VERIFIED`，也不影响其他宿主已经完成的结果。
+
+## 源码分支检查
+
+宿主更新和 setup 不影响本项检查。读取 `releaseFinish.sourceBranchCheck`；字段或整个
+`releaseFinish` 缺省时按 `remind` 处理。配置为 `skip` 时不运行 Git 命令，只说明项目已关闭
+源码分支检查。
+
+`remind` 时，在发布项目目录依次运行两条只读命令：
+
+```bash
+git branch --show-current
+git status --short --branch
+```
+
+第一条命令取得当前分支。第二条命令读取工作区改动和现有上游跟踪摘要；不得增加会写入或访问网络的
+参数。当前分支等于 `project.defaultBranch` 且没有文件改动时，说明本地已位于目标分支；输出含
+ahead 或 behind 等跟踪信息时，仍原样概括。分支不一致时说明两个准确名称，并询问用户是否需要处理。
+第一条命令输出为空时，说明处于 detached HEAD，不猜测目标操作。工作区存在改动时说明不建议直接
+切换或清理。任一命令失败时，报告命令、退出结果和无法完成检查的事实。
+
+最终自然语言回复至少列出提醒策略、目标分支、当前分支或无法取得的事实、工作区是否有改动、Git
+上游跟踪摘要，以及是否需要用户决定下一步。没有上游信息时，明确说明命令输出未显示上游信息。
+
+本项检查不从宿主更新推导出 Git 写入授权，不自动执行 fetch、switch、checkout、merge、rebase、stash、
+reset、clean 或 push。用户跳过宿主更新仍执行默认分支检查。用户已经明确授权同一仓库、分支和操作时，
+按项目 Git 纪律继续，不重复询问相同授权；检查本身不改变 `VERIFIED`，不保存结果，也不产生新的 run。
+
 ## 临时归属
 
 本能力目前只服务发布后的本机收尾，因此保留在 release-skill。第二个技能族需要复用宿主更新或 TUI 驱动，或 Foundation 发布等价公共入口时，再把通用机制上收 Foundation并删除这里的通用部分。release-skill 只保留发布计划到宿主更新输入的领域映射。

package/adapters/workbuddy/.codebuddy-plugin/plugin.json

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

package/adapters/workbuddy/bin/release-skill.bundle.mjs

@@ -9,9 +9,9 @@ const __bundlePkgRoot = __bundleResolve(__bundleDirname(__bundleFileURLToPath(im
 // Provide a real require() for CJS packages bundled into ESM (e.g. yaml, ajv).
 const __bundleRealRequire = __bundleCreateRequire(import.meta.url);
 // Package identity injected at build time — closure-independent --version probe.
-const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.15"});
+const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.16"});
 // Build-time source digest for the BUNDLE_STALE freshness gate (see above).
-const __bundleSourceDigest = "e47969ed810fa0edbed7073f13df855be95feed7ffecc40f72dd887cab52ff97";
+const __bundleSourceDigest = "ba44ad70cebc1cc077887bdf71bf36d78b9073c8aeabd0074aac2eb0d5caffea";
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -148166,6 +148166,23 @@ This command creates an independent postVerify run and never reads or writes shi
       root,
       ...postpublishApprovalPaths.length > 0 ? { postpublishApprovalPaths } : {}
     });
+    if (result2.status === "DISTRIBUTED") {
+      const {
+        derivePostReleaseChecklist: derivePostReleaseChecklist2,
+        unavailablePostReleaseChecklist: unavailablePostReleaseChecklist2
+      } = await init_post_release_local().then(() => post_release_local_exports);
+      let plan;
+      try {
+        plan = JSON.parse(await readFile57(resolve42(planPath), "utf8"));
+        result2.postRelease = derivePostReleaseChecklist2(plan, {
+          root,
+          runPath: result2.runPath,
+          postVerifyComplete: true
+        });
+      } catch (error) {
+        result2.postRelease = unavailablePostReleaseChecklist2(plan, error);
+      }
+    }
     if (hasJson) {
       console.log(JSON.stringify(result2, null, 2));
     } else {
@@ -148174,6 +148191,17 @@ This command creates an independent postVerify run and never reads or writes shi
         console.log(`  ${cp4.actionId}: ${cp4.status}`);
       }
       if (result2.runPath) console.log(`PostVerify run: ${result2.runPath}`);
+      if (result2.postRelease?.status === "UNAVAILABLE") {
+        console.warn(`Post-release checklist unavailable: ${result2.postRelease.diagnostic?.message ?? "unknown error"}`);
+      } else if (result2.postRelease?.localHostUpdate?.promptRequired === true) {
+        const localHostUpdate = result2.postRelease.localHostUpdate;
+        console.log(`Post-release: ask whether to update local host plugins (${localHostUpdate.hosts.join(", ")}).`);
+        if (localHostUpdate.available === true && typeof localHostUpdate.runPath === "string") {
+          console.log(`Post-release command: release-skill post-release --plan ${resolve42(planPath)} --run ${localHostUpdate.runPath}`);
+          console.log("Choose --hosts before adding --update-local-hosts to perform a local update.");
+        }
+        printHubManualTargets(localHostUpdate.targets);
+      }
     }
     await exitAfterFlush(result2.status === "DISTRIBUTED" ? 0 : 1);
   } catch (err) {

package/adapters/workbuddy/schemas/release-project.schema.json

@@ -44,6 +44,24 @@
         }
       }
     },
+    "releaseFinish": {
+      "type": "object",
+      "description": "Optional local post-release finish settings. Omitted sourceBranchCheck defaults to remind.",
+      "additionalProperties": false,
+      "properties": {
+        "sourceBranchCheck": {
+          "type": "string",
+          "enum": [
+            "remind",
+            "skip"
+          ]
+        },
+        "setupSkill": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*(?::[a-z0-9][a-z0-9-]*)?$"
+        }
+      }
+    },
     "publicSourceAuthorityReceipt": {
       "type": "object",
       "description": "Optional public source-authority receipt uploaded to one coordinator GitHub Release after all subject npm tarballs are frozen.",

package/adapters/workbuddy/skills/release-finish/SKILL.md

@@ -70,6 +70,64 @@ node "${CODEBUDDY_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 
 完成后报告每个宿主的状态，并提醒用户重启已更新的宿主。本机结果只记录收尾事实，不改变发布状态。
 
+## 配置与目录
+
+从发布项目目录的 `.release-skill/project.yaml` 读取 `releaseFinish` 和 `project.defaultBranch`。
+文件缺失或无法解析时，报告具体配置问题，不猜默认分支或 setup，也不得把文件缺失当作字段合法缺省；
+已经取得的发布结果仍保留。只有配置文件有效时，整个 `releaseFinish` 或其中字段缺省才按各自合同默认。
+
+发布项目目录用于读取配置和执行源码 Git 检查。setup 使用用户明确指定的消费项目目录或已明确的使用
+上下文。只有用户明确把发布源码仓库作为消费项目时，才能在那里执行 setup；同时提供两个目录时不得混用。
+
+## 更新后 setup
+
+完成现有清单及已授权的宿主处理后，读取发布项目 `.release-skill/project.yaml` 的
+`releaseFinish.setupSkill`。未配置时不增加 setup 提示。配置的技能名只用于匹配入口，不作为 shell 命令执行，
+也不授权安装同名插件。
+
+只有本次所选宿主已经成功更新，或现有检查确认它已是目标版本时，才衔接 setup。通过宿主实际技能
+元数据核对目标插件身份、版本和入口；不能从开发仓库、旧会话缓存或同名技能推断新版已加载。当前宿主
+不满足时，可以使用同次更新中另一个已安装并加载目标版本和入口的宿主。
+
+目标目录来自用户本次明确指定的消费项目或已明确的使用上下文。目录不明确、宿主需要重启、当前环境
+不能调用可用宿主、入口不存在或归属有歧义时，标为“待执行”，并给出插件与版本、技能名、目标目录和
+已有授权的续接提示。发出提示不代表 setup 已完成。
+
+对同一插件版本、同一项目目录和相同共享运行环境，项目级依赖、项目配置和 Git hooks 由一个已加载
+新版插件的宿主检查一次。其余宿主分别核对自身安装、加载和宿主专属配置。不同运行环境不得无条件
+复用项目就绪结论；按目标 setup 的实际合同补查差异。release-finish 不保存去重键、收据或新的状态。
+
+调用 setup 前完整读取目标技能及其必读引用，并传入目标项目、插件版本、只读检查意图和已有授权范围。
+已有具体修复授权应传递给 setup；未覆盖的写入不能执行。只读检查、安装结果和配置修复结果分别报告。
+最终自然语言回复列出执行宿主、插件版本、消费项目路径、实际结果和未完成项。任何 setup 结果都不改变
+`VERIFIED`，也不影响其他宿主已经完成的结果。
+
+## 源码分支检查
+
+宿主更新和 setup 不影响本项检查。读取 `releaseFinish.sourceBranchCheck`；字段或整个
+`releaseFinish` 缺省时按 `remind` 处理。配置为 `skip` 时不运行 Git 命令，只说明项目已关闭
+源码分支检查。
+
+`remind` 时，在发布项目目录依次运行两条只读命令：
+
+```bash
+git branch --show-current
+git status --short --branch
+```
+
+第一条命令取得当前分支。第二条命令读取工作区改动和现有上游跟踪摘要；不得增加会写入或访问网络的
+参数。当前分支等于 `project.defaultBranch` 且没有文件改动时，说明本地已位于目标分支；输出含
+ahead 或 behind 等跟踪信息时，仍原样概括。分支不一致时说明两个准确名称，并询问用户是否需要处理。
+第一条命令输出为空时，说明处于 detached HEAD，不猜测目标操作。工作区存在改动时说明不建议直接
+切换或清理。任一命令失败时，报告命令、退出结果和无法完成检查的事实。
+
+最终自然语言回复至少列出提醒策略、目标分支、当前分支或无法取得的事实、工作区是否有改动、Git
+上游跟踪摘要，以及是否需要用户决定下一步。没有上游信息时，明确说明命令输出未显示上游信息。
+
+本项检查不从宿主更新推导出 Git 写入授权，不自动执行 fetch、switch、checkout、merge、rebase、stash、
+reset、clean 或 push。用户跳过宿主更新仍执行默认分支检查。用户已经明确授权同一仓库、分支和操作时，
+按项目 Git 纪律继续，不重复询问相同授权；检查本身不改变 `VERIFIED`，不保存结果，也不产生新的 run。
+
 ## 临时归属
 
 本能力目前只服务发布后的本机收尾，因此保留在 release-skill。第二个技能族需要复用宿主更新或 TUI 驱动，或 Foundation 发布等价公共入口时，再把通用机制上收 Foundation并删除这里的通用部分。release-skill 只保留发布计划到宿主更新输入的领域映射。

package/bin/release-skill-cli.mjs

@@ -1711,6 +1711,23 @@ This command creates an independent postVerify run and never reads or writes shi
       root,
       ...(postpublishApprovalPaths.length > 0 ? { postpublishApprovalPaths } : {}),
     });
+    if (result.status === 'DISTRIBUTED') {
+      const {
+        derivePostReleaseChecklist,
+        unavailablePostReleaseChecklist,
+      } = await import('../src/commands/post-release-local.mjs');
+      let plan;
+      try {
+        plan = JSON.parse(await readFile(resolve(planPath), 'utf8'));
+        result.postRelease = derivePostReleaseChecklist(plan, {
+          root,
+          runPath: result.runPath,
+          postVerifyComplete: true,
+        });
+      } catch (error) {
+        result.postRelease = unavailablePostReleaseChecklist(plan, error);
+      }
+    }
 
     if (hasJson) {
       console.log(JSON.stringify(result, null, 2));
@@ -1720,6 +1737,17 @@ This command creates an independent postVerify run and never reads or writes shi
         console.log(`  ${cp.actionId}: ${cp.status}`);
       }
       if (result.runPath) console.log(`PostVerify run: ${result.runPath}`);
+      if (result.postRelease?.status === 'UNAVAILABLE') {
+        console.warn(`Post-release checklist unavailable: ${result.postRelease.diagnostic?.message ?? 'unknown error'}`);
+      } else if (result.postRelease?.localHostUpdate?.promptRequired === true) {
+        const localHostUpdate = result.postRelease.localHostUpdate;
+        console.log(`Post-release: ask whether to update local host plugins (${localHostUpdate.hosts.join(', ')}).`);
+        if (localHostUpdate.available === true && typeof localHostUpdate.runPath === 'string') {
+          console.log(`Post-release command: release-skill post-release --plan ${resolve(planPath)} --run ${localHostUpdate.runPath}`);
+          console.log('Choose --hosts before adding --update-local-hosts to perform a local update.');
+        }
+        printHubManualTargets(localHostUpdate.targets);
+      }
     }
 
     await exitAfterFlush(result.status === 'DISTRIBUTED' ? 0 : 1);

package/bin/release-skill.bundle.mjs

@@ -9,9 +9,9 @@ const __bundlePkgRoot = __bundleResolve(__bundleDirname(__bundleFileURLToPath(im
 // Provide a real require() for CJS packages bundled into ESM (e.g. yaml, ajv).
 const __bundleRealRequire = __bundleCreateRequire(import.meta.url);
 // Package identity injected at build time — closure-independent --version probe.
-const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.15"});
+const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.16"});
 // Build-time source digest for the BUNDLE_STALE freshness gate (see above).
-const __bundleSourceDigest = "e47969ed810fa0edbed7073f13df855be95feed7ffecc40f72dd887cab52ff97";
+const __bundleSourceDigest = "ba44ad70cebc1cc077887bdf71bf36d78b9073c8aeabd0074aac2eb0d5caffea";
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -148166,6 +148166,23 @@ This command creates an independent postVerify run and never reads or writes shi
       root,
       ...postpublishApprovalPaths.length > 0 ? { postpublishApprovalPaths } : {}
     });
+    if (result2.status === "DISTRIBUTED") {
+      const {
+        derivePostReleaseChecklist: derivePostReleaseChecklist2,
+        unavailablePostReleaseChecklist: unavailablePostReleaseChecklist2
+      } = await init_post_release_local().then(() => post_release_local_exports);
+      let plan;
+      try {
+        plan = JSON.parse(await readFile57(resolve42(planPath), "utf8"));
+        result2.postRelease = derivePostReleaseChecklist2(plan, {
+          root,
+          runPath: result2.runPath,
+          postVerifyComplete: true
+        });
+      } catch (error) {
+        result2.postRelease = unavailablePostReleaseChecklist2(plan, error);
+      }
+    }
     if (hasJson) {
       console.log(JSON.stringify(result2, null, 2));
     } else {
@@ -148174,6 +148191,17 @@ This command creates an independent postVerify run and never reads or writes shi
         console.log(`  ${cp4.actionId}: ${cp4.status}`);
       }
       if (result2.runPath) console.log(`PostVerify run: ${result2.runPath}`);
+      if (result2.postRelease?.status === "UNAVAILABLE") {
+        console.warn(`Post-release checklist unavailable: ${result2.postRelease.diagnostic?.message ?? "unknown error"}`);
+      } else if (result2.postRelease?.localHostUpdate?.promptRequired === true) {
+        const localHostUpdate = result2.postRelease.localHostUpdate;
+        console.log(`Post-release: ask whether to update local host plugins (${localHostUpdate.hosts.join(", ")}).`);
+        if (localHostUpdate.available === true && typeof localHostUpdate.runPath === "string") {
+          console.log(`Post-release command: release-skill post-release --plan ${resolve42(planPath)} --run ${localHostUpdate.runPath}`);
+          console.log("Choose --hosts before adding --update-local-hosts to perform a local update.");
+        }
+        printHubManualTargets(localHostUpdate.targets);
+      }
     }
     await exitAfterFlush(result2.status === "DISTRIBUTED" ? 0 : 1);
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "release-skill",
-  "version": "0.9.15",
+  "version": "0.9.16",
   "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.15",
+  "version": "0.9.16",
   "logicalRoot": "skills-src/",
-  "logicalRootDigest": "6f87c1a4299db9bc2651df6e7e526e927bd665b331cfc324cc94bee270ee994a",
-  "projectionDigest": "36d093b84544cea31cdf7c91b19a08a649b8889566793b4ba324669ab59a0982",
-  "projectionId": "release-skill:platform:0.9.15",
+  "logicalRootDigest": "751140ca01cdd95484041547885e6f07fe9c0c496f6eb62f94710105a9f46e50",
+  "projectionDigest": "b62f3e4eca6586d899a328debc515a8cd49bf0cf456ac343539c63fb20b14f3c",
+  "projectionId": "release-skill:platform:0.9.16",
   "manifestRequired": true,
   "projectionSources": {
     "skills-src-root": {

package/references/02-project-config.md

@@ -27,6 +27,10 @@ project:
   defaultBranch: <string>        # workspace 远端默认分支，必填；不限定为 main
   sourceRepository: <owner/repo> # workspace 源仓库；生产发布必填
 
+releaseFinish:                   # 可选；仅控制本地发布收尾
+  sourceBranchCheck: remind      # remind（缺省）或 skip
+  setupSkill: <plugin:skill>     # 可选；已加载目标插件提供的 setup 入口
+
 publicSourceAuthorityReceipt:    # 可选；把源码坐标与多个 npm tarball 绑定为公开 Release asset
   coordinatorUnitId: <release-unit-id>
   subjectUnitIds: [<release-unit-id>]
@@ -113,6 +117,18 @@ policy:                     # 可选，安全策略
 ```
 
 `distributions: []` 表示该发布单元不生成 npm 或插件市场动作，不表示跳过公开发布。
+
+### 2.1 本地发布收尾
+
+`releaseFinish` 只控制 `release-finish` 的本地收尾，不改写冻结计划、发布状态或宿主范围。
+`sourceBranchCheck` 缺省为 `remind`。该值要求收尾时读取当前分支和工作区摘要；设为 `skip`
+时关闭这项提醒。`setupSkill` 可省略；填写时必须是技能入口名，例如 `release-setup` 或
+`skill-family-docs:skill-family-docs-setup`。它只用于匹配已安装并加载的目标插件入口，不能作为
+shell 命令执行。
+
+`releaseFinish` 保持闭合。未知字段、`sourceBranchCheck` 的其他值，以及空值、路径、带参数或
+shell 语法的 `setupSkill` 都是配置错误。两个字段彼此独立：关闭分支提醒不会关闭已配置的 setup。
+
 生产模式的 `prepare` 仍会冻结 GitHub 快照，并生成 `push-snapshot`、`create-tag` 和
 `github-release`。该单元的 `postPublish` 声明保持独立生效，其中 phase 为
 `postVerify` 的 hook 也不受影响。因此纯插件可以先验证公开 GitHub Release，再向中央

package/schemas/release-project.schema.json

@@ -44,6 +44,24 @@
         }
       }
     },
+    "releaseFinish": {
+      "type": "object",
+      "description": "Optional local post-release finish settings. Omitted sourceBranchCheck defaults to remind.",
+      "additionalProperties": false,
+      "properties": {
+        "sourceBranchCheck": {
+          "type": "string",
+          "enum": [
+            "remind",
+            "skip"
+          ]
+        },
+        "setupSkill": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*(?::[a-z0-9][a-z0-9-]*)?$"
+        }
+      }
+    },
     "publicSourceAuthorityReceipt": {
       "type": "object",
       "description": "Optional public source-authority receipt uploaded to one coordinator GitHub Release after all subject npm tarballs are frozen.",

package/skills/release-finish/SKILL.md

@@ -70,6 +70,64 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 
 完成后报告每个宿主的状态，并提醒用户重启已更新的宿主。本机结果只记录收尾事实，不改变发布状态。
 
+## 配置与目录
+
+从发布项目目录的 `.release-skill/project.yaml` 读取 `releaseFinish` 和 `project.defaultBranch`。
+文件缺失或无法解析时，报告具体配置问题，不猜默认分支或 setup，也不得把文件缺失当作字段合法缺省；
+已经取得的发布结果仍保留。只有配置文件有效时，整个 `releaseFinish` 或其中字段缺省才按各自合同默认。
+
+发布项目目录用于读取配置和执行源码 Git 检查。setup 使用用户明确指定的消费项目目录或已明确的使用
+上下文。只有用户明确把发布源码仓库作为消费项目时，才能在那里执行 setup；同时提供两个目录时不得混用。
+
+## 更新后 setup
+
+完成现有清单及已授权的宿主处理后，读取发布项目 `.release-skill/project.yaml` 的
+`releaseFinish.setupSkill`。未配置时不增加 setup 提示。配置的技能名只用于匹配入口，不作为 shell 命令执行，
+也不授权安装同名插件。
+
+只有本次所选宿主已经成功更新，或现有检查确认它已是目标版本时，才衔接 setup。通过宿主实际技能
+元数据核对目标插件身份、版本和入口；不能从开发仓库、旧会话缓存或同名技能推断新版已加载。当前宿主
+不满足时，可以使用同次更新中另一个已安装并加载目标版本和入口的宿主。
+
+目标目录来自用户本次明确指定的消费项目或已明确的使用上下文。目录不明确、宿主需要重启、当前环境
+不能调用可用宿主、入口不存在或归属有歧义时，标为“待执行”，并给出插件与版本、技能名、目标目录和
+已有授权的续接提示。发出提示不代表 setup 已完成。
+
+对同一插件版本、同一项目目录和相同共享运行环境，项目级依赖、项目配置和 Git hooks 由一个已加载
+新版插件的宿主检查一次。其余宿主分别核对自身安装、加载和宿主专属配置。不同运行环境不得无条件
+复用项目就绪结论；按目标 setup 的实际合同补查差异。release-finish 不保存去重键、收据或新的状态。
+
+调用 setup 前完整读取目标技能及其必读引用，并传入目标项目、插件版本、只读检查意图和已有授权范围。
+已有具体修复授权应传递给 setup；未覆盖的写入不能执行。只读检查、安装结果和配置修复结果分别报告。
+最终自然语言回复列出执行宿主、插件版本、消费项目路径、实际结果和未完成项。任何 setup 结果都不改变
+`VERIFIED`，也不影响其他宿主已经完成的结果。
+
+## 源码分支检查
+
+宿主更新和 setup 不影响本项检查。读取 `releaseFinish.sourceBranchCheck`；字段或整个
+`releaseFinish` 缺省时按 `remind` 处理。配置为 `skip` 时不运行 Git 命令，只说明项目已关闭
+源码分支检查。
+
+`remind` 时，在发布项目目录依次运行两条只读命令：
+
+```bash
+git branch --show-current
+git status --short --branch
+```
+
+第一条命令取得当前分支。第二条命令读取工作区改动和现有上游跟踪摘要；不得增加会写入或访问网络的
+参数。当前分支等于 `project.defaultBranch` 且没有文件改动时，说明本地已位于目标分支；输出含
+ahead 或 behind 等跟踪信息时，仍原样概括。分支不一致时说明两个准确名称，并询问用户是否需要处理。
+第一条命令输出为空时，说明处于 detached HEAD，不猜测目标操作。工作区存在改动时说明不建议直接
+切换或清理。任一命令失败时，报告命令、退出结果和无法完成检查的事实。
+
+最终自然语言回复至少列出提醒策略、目标分支、当前分支或无法取得的事实、工作区是否有改动、Git
+上游跟踪摘要，以及是否需要用户决定下一步。没有上游信息时，明确说明命令输出未显示上游信息。
+
+本项检查不从宿主更新推导出 Git 写入授权，不自动执行 fetch、switch、checkout、merge、rebase、stash、
+reset、clean 或 push。用户跳过宿主更新仍执行默认分支检查。用户已经明确授权同一仓库、分支和操作时，
+按项目 Git 纪律继续，不重复询问相同授权；检查本身不改变 `VERIFIED`，不保存结果，也不产生新的 run。
+
 ## 临时归属
 
 本能力目前只服务发布后的本机收尾，因此保留在 release-skill。第二个技能族需要复用宿主更新或 TUI 驱动，或 Foundation 发布等价公共入口时，再把通用机制上收 Foundation并删除这里的通用部分。release-skill 只保留发布计划到宿主更新输入的领域映射。