release-skill 0.9.38 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/.codebuddy-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +2 -2
- package/.cursor-plugin/plugin.json +1 -1
- package/.kimi-plugin/plugin.json +1 -1
- package/.qoder-plugin/plugin.json +1 -1
- package/CHANGELOG.md +24 -0
- package/INSTALL.md +2 -2
- package/INSTALL.zh-CN.md +2 -2
- package/README.md +10 -18
- package/README.zh-CN.md +10 -21
- package/adapters/claude/.claude-plugin/plugin.json +1 -1
- package/adapters/claude/bin/release-skill.bundle.mjs +18 -16
- package/adapters/claude/skills/release-help/SKILL.md +2 -2
- package/adapters/claude/skills/release-prepare/SKILL.md +14 -2
- package/adapters/codex/.codex-plugin/plugin.json +2 -2
- package/adapters/codex/bin/release-skill.bundle.mjs +18 -16
- package/adapters/codex/skills/release-help/SKILL.md +2 -2
- package/adapters/codex/skills/release-prepare/SKILL.md +14 -2
- package/adapters/cursor/.cursor-plugin/plugin.json +1 -1
- package/adapters/cursor/bin/release-skill.bundle.mjs +18 -16
- package/adapters/cursor/skills/release-help/SKILL.md +2 -2
- package/adapters/cursor/skills/release-prepare/SKILL.md +14 -2
- package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
- package/adapters/kimi/bin/release-skill.bundle.mjs +18 -16
- package/adapters/kimi/skills/release-help/SKILL.md +2 -2
- package/adapters/kimi/skills/release-prepare/SKILL.md +14 -2
- package/adapters/qoder/.qoder-plugin/plugin.json +1 -1
- package/adapters/qoder/bin/release-skill.bundle.mjs +18 -16
- package/adapters/qoder/skills/release-help/SKILL.md +2 -2
- package/adapters/qoder/skills/release-prepare/SKILL.md +14 -2
- package/adapters/workbuddy/.codebuddy-plugin/plugin.json +1 -1
- package/adapters/workbuddy/bin/release-skill.bundle.mjs +18 -16
- package/adapters/workbuddy/skills/release-help/SKILL.md +2 -2
- package/adapters/workbuddy/skills/release-prepare/SKILL.md +14 -2
- package/bin/release-skill.bundle.mjs +18 -16
- package/package.json +3 -2
- package/platform-manifest.json +4 -4
- package/skills/release-help/SKILL.md +2 -2
- package/skills/release-prepare/SKILL.md +14 -2
- package/skills-src/release-help/SKILL.md +2 -2
- package/skills-src/release-prepare/SKILL.md +14 -2
- package/src/commands/post-release-finish.mjs +9 -0
- package/src/core/plan-replacement.mjs +1 -1
- package/src/core/pre-authority-failure.mjs +10 -9
- package/src/core/test-candidate.mjs +2 -6
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "release-skill",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "广州市风荷科技有限公司"
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
],
|
|
20
20
|
"defaultPrompt": [
|
|
21
21
|
"Assess this project for release readiness.",
|
|
22
|
-
"Prepare a release plan for version 0.
|
|
22
|
+
"Prepare a release plan for version 0.10.0.",
|
|
23
23
|
"Help me understand the release workflow."
|
|
24
24
|
]
|
|
25
25
|
}
|
package/.kimi-plugin/plugin.json
CHANGED
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,29 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.10.0 locale=en baseline=sha256:dfff93ef727de178ff140fc2de189fdab65205a99cc4c5734bc8c9889ef28e54 -->
|
|
4
|
+
## [0.10.0] - 2026-10-26
|
|
5
|
+
|
|
6
|
+
0.10.0 enables explicit testing provider selection via Agent Method Registry 0.2.0 on codex and claude-code, while maintaining TEST 0.2.0 as the default testing Skill family. Foundation dependencies remain pinned to 0.25.0. This description is not evidence of publication, real-host acceptance, consumer installation verification, or independent acceptance.
|
|
7
|
+
|
|
8
|
+
### Security
|
|
9
|
+
|
|
10
|
+
- Method selection does not alter result contracts, domain acceptance, business permissions, or release approval. Foundation dependencies remain pinned to 0.25.0. Full release gates, channel checks, and host verification remain separate requirements; these notes do not confirm their completion. The inherited Skill Family Hub remains the unified marketplace. Binding to observed branch heads is achieved via GitHub Git Data API and compare-and-swap (CAS). Partial publication is never rolled back or force-pushed.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- The preparation Skill resolves and verifies a single testing provider for testing/skill-family/plan and run using existing source selection and v1 overlay. Project Skills and explicitly selected external catalogs are supported on codex and claude-code; other hosts retain their original path. Disabled, missing, ambiguous, or invalid providers halt dependent calls without fallback or waiver of testIntake obligations.
|
|
15
|
+
|
|
16
|
+
### Fixed
|
|
17
|
+
|
|
18
|
+
- Candidate acceptance now compares both unit.id and targetVersion. Conflicts no longer occur between different units sharing the same version; acceptance remains denied for the same unit and version with differing acceptance bases, including partial overlaps in multi-unit plans. Existing checks for authority, history, replacement, and writer remain unchanged.
|
|
19
|
+
- When no frozen host targets are present, a plugin-qualified setup is skipped only if the current configuration has exactly one matching localHostUpdate.plugin owner and that unit is not selected. Unknown or ambiguous ownership, unqualified setups, or selected owners remain pending; selected hosts require actual loading and setup feedback.
|
|
20
|
+
|
|
21
|
+
### Upgrade Notes
|
|
22
|
+
|
|
23
|
+
Upgrading from writer version 0.9.38 to 0.10.0 requires a fresh prepare, candidate generation, and result file creation. Preserve all prior candidates, results, approvals, and run records; do not modify writerVersion. The documented local-checkout CLI is a development entry point and does not indicate that 0.10.0 is published or loaded by a host. The release-skill standalone marketplace is deprecated; use ifoohoo/skill-family-hub with plugin id release-skill@skill-family-hub instead.
|
|
24
|
+
<!-- release-skill:changelog:end version=0.10.0 locale=en -->
|
|
25
|
+
|
|
26
|
+
|
|
3
27
|
<!-- release-skill:changelog:start version=0.9.38 locale=en baseline=sha256:471af07096474e6d8585e3f246e041bf94452bb9ed91019087f759079dc7d13d -->
|
|
4
28
|
## [0.9.38] - 2026-10-25
|
|
5
29
|
|
package/INSTALL.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[简体中文](INSTALL.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
<!-- release-skill:release-version: 0.
|
|
5
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
6
6
|
## Prerequisites
|
|
7
7
|
|
|
8
8
|
- Node.js `>=22.22.2 <23` (22.22.2 or newer, and below 23)
|
|
@@ -125,7 +125,7 @@ tag pinned to the exact version (never the bare repository URL, which installs
|
|
|
125
125
|
the latest release or default branch), confirm the trust prompt, then reload:
|
|
126
126
|
|
|
127
127
|
```
|
|
128
|
-
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.
|
|
128
|
+
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.10.0
|
|
129
129
|
/plugins reload
|
|
130
130
|
```
|
|
131
131
|
|
package/INSTALL.zh-CN.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](INSTALL.md)
|
|
4
4
|
|
|
5
|
-
<!-- release-skill:release-version: 0.
|
|
5
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
6
6
|
## 前置条件
|
|
7
7
|
|
|
8
8
|
- Node.js `>=22.22.2 <23`(22.22.2 及以上,且低于 23)
|
|
@@ -113,7 +113,7 @@ release-skill 当前只采用并验证 Kimi Code 的交互式 TUI 路径,**无
|
|
|
113
113
|
(切勿使用裸仓库地址,它会安装最新 release 或默认分支),确认信任提示后重新加载:
|
|
114
114
|
|
|
115
115
|
```
|
|
116
|
-
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.
|
|
116
|
+
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.10.0
|
|
117
117
|
/plugins reload
|
|
118
118
|
```
|
|
119
119
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[简体中文](README.zh-CN.md) · Installation: [English](INSTALL.md) / [简体中文](INSTALL.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
<!-- release-skill:release-version: 0.
|
|
5
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
6
6
|
Release preparation for Claude Code, CodeBuddy, WorkBuddy, Codex, and Kimi Code, with human-edited files kept intact.
|
|
7
7
|
|
|
8
8
|
release-skill helps a maintainer answer three questions: what will be released,
|
|
@@ -18,38 +18,30 @@ report stays in a temporary session directory.
|
|
|
18
18
|
A release unit is a release object with independently configured version, public files, and distribution targets. A release plan is a record for review before approval, linking target versions, frozen artifacts, and proposed external actions; see the [human review and approval steps](#release-plan-review).
|
|
19
19
|
|
|
20
20
|
<!-- release-skill:managed:start id=latest-release -->
|
|
21
|
-
**0.
|
|
21
|
+
**0.10.0** (2026-10-26)
|
|
22
22
|
|
|
23
|
-
0.
|
|
23
|
+
0.10.0 enables explicit testing provider selection via Agent Method Registry 0.2.0 on codex and claude-code, while maintaining TEST 0.2.0 as the default testing Skill family. Foundation dependencies remain pinned to 0.25.0. This description is not evidence of publication, real-host acceptance, consumer installation verification, or independent acceptance.
|
|
24
24
|
|
|
25
25
|
**Security**
|
|
26
26
|
|
|
27
|
-
-
|
|
28
|
-
- The replacement operation does not relax the exact equality requirement between source submission and remote `main`, `TEST` state, remote conflicts, or approval gate restrictions. The Foundation 0.25.0 mechanism continues to be enforced precisely. Target assignment is determined by Release Skill domain responsibility and must not be inferred from directory names, timestamps, or error text. No product capability was removed or renamed in this round; replacement applies only to qualifying run plans. An unpublished candidate or local test does not constitute a successful release or independent acceptance. All operations are based on the 0.9.38-supported entry point and cannot revoke any legacy software or bypass existing protocols.
|
|
29
|
-
- The Skill Family Hub is inherited as the unified marketplace, with updates performed via GitHub Git Data API using compare-and-swap semantics to bind observed branch head; partial releases are never rolled back or force-pushed, and completed steps are not overwritten. All behaviors are based on 0.9.38’s supported entry points, without claiming to restrict arbitrary legacy binaries or manual bypasses. This release does not claim to introduce new market mechanisms or update behaviors.
|
|
27
|
+
- Method selection does not alter result contracts, domain acceptance, business permissions, or release approval. Foundation dependencies remain pinned to 0.25.0. Full release gates, channel checks, and host verification remain separate requirements; these notes do not confirm their completion. The inherited Skill Family Hub remains the unified marketplace. Binding to observed branch heads is achieved via GitHub Git Data API and compare-and-swap (CAS). Partial publication is never rolled back or force-pushed.
|
|
30
28
|
|
|
31
29
|
**Added**
|
|
32
30
|
|
|
33
|
-
- The
|
|
31
|
+
- The preparation Skill resolves and verifies a single testing provider for testing/skill-family/plan and run using existing source selection and v1 overlay. Project Skills and explicitly selected external catalogs are supported on codex and claude-code; other hosts retain their original path. Disabled, missing, ambiguous, or invalid providers halt dependent calls without fallback or waiver of testIntake obligations.
|
|
34
32
|
|
|
35
33
|
**Fixed**
|
|
36
34
|
|
|
37
|
-
-
|
|
35
|
+
- Candidate acceptance now compares both unit.id and targetVersion. Conflicts no longer occur between different units sharing the same version; acceptance remains denied for the same unit and version with differing acceptance bases, including partial overlaps in multi-unit plans. Existing checks for authority, history, replacement, and writer remain unchanged.
|
|
36
|
+
- When no frozen host targets are present, a plugin-qualified setup is skipped only if the current configuration has exactly one matching localHostUpdate.plugin owner and that unit is not selected. Unknown or ambiguous ownership, unqualified setups, or selected owners remain pending; selected hosts require actual loading and setup feedback.
|
|
38
37
|
|
|
39
38
|
**Upgrade Notes**
|
|
40
39
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
Release zero-external-write diagnosis must be independent of target attribution. A diagnosis may only be based on a single, complete, continuous event sequence with matching closure, full required gate sequence, and no `release-run.json`, any `state` authority, execution, or checkpoint activity—**provided** the producer version is verified as 0.9.3, 0.9.14, 0.9.17, 0.9.33, 0.9.37, or the current version 0.9.38. Under these full conditions, three failure patterns remain valid for diagnosis: source gate failure; 0.9.17 failing directly after read-only `global-preflight` arbitration; 0.9.33 failing after `approval-load` with `DIAGNOSE` and no independent `gate-failed` event. Diagnosis does not establish plan, recovery, replacement, release, or `TEST` authority. It does not infer attribution from directory structure, timestamps, error text, or non-authoritative states.
|
|
44
|
-
For reconcile failures, only two prior records from writers 0.9.22 and 0.9.27 may be used to verify true target attribution, each corresponding to targets 0.22.0 and 0.25.0 respectively. The `sourceRunId` and `sourceRunDigest` must match the original parent run of the current project. The child event stream must follow the full required prefix of the verified writer. Both `source-run-load passed` and `reconcile started` must reference the same parent run, and each `actionId`/`actionType` must map to the original action in the parent plan. Only after full verification may the true target be confirmed and replacement blocking be ruled out. The failure state itself does not constitute zero-external-write, nor does it grant recovery, replacement, or `TEST` authority.
|
|
45
|
-
For verify failures, only two records—0.9.7 and 0.9.12—may be used to confirm true target attribution. The sole parent reference must come from the genuine `source-run-load passed` `sourceRunId`; fabricated `sourceRunDigest` is not accepted. Only fully verified, limited prefix and suffix from the confirmed writer are allowed. Using the original parent file under the current project’s `runs` directory, reuse `loadRun`, the current plan schema, immutable plan path, full lineage, and checkpoint mapping to confirm the parent run is `PUBLISHED`. Then verify the parent plan is `foundation-adoption-review@0.1.0`, distinct from 0.28.0. Each action identity must correspond to the parent plan. Same target, incomplete parent authority, unknown stage, or conflicting relationships still result in rejection. Record 0.9.7 executed isolated consumer installation, including `execute` and local writes. It cannot be described as “zero execute” or “zero local write,” nor can it be used to grant publication external write authority. Verify failures do not constitute proof of publish zero-external-write and do not grant release, recovery, replacement, or `TEST` authority.
|
|
46
|
-
All unknown, corrupted, contradictory, discontinuous, mismatched closure, or relationship-conflicting historical records are invalid. Original records must not be deleted, moved, field-filled, or reconstructed. Self-reference, cycles, multiple valid successors, or invalid successors must not revive old plans.
|
|
47
|
-
|
|
48
|
-
The release-skill standalone marketplace is deprecated; use `ifoohoo/skill-family-hub` as the unified marketplace, with plugin name restricted to `release-skill@skill-family-hub`.
|
|
40
|
+
Upgrading from writer version 0.9.38 to 0.10.0 requires a fresh prepare, candidate generation, and result file creation. Preserve all prior candidates, results, approvals, and run records; do not modify writerVersion. The documented local-checkout CLI is a development entry point and does not indicate that 0.10.0 is published or loaded by a host. The release-skill standalone marketplace is deprecated; use ifoohoo/skill-family-hub with plugin id release-skill@skill-family-hub instead.
|
|
49
41
|
<!-- release-skill:managed:end id=latest-release -->
|
|
50
42
|
|
|
51
43
|
<!-- release-skill:capability:external-write-boundary -->
|
|
52
|
-
> **Current boundary:** v0.
|
|
44
|
+
> **Current boundary:** v0.10.0: this README records capabilities and verification boundaries;
|
|
53
45
|
> it is not evidence of
|
|
54
46
|
> publication, consumer-installation verification, or independent acceptance.
|
|
55
47
|
> Release availability must be established from the corresponding release records
|
|
@@ -73,7 +65,7 @@ The release-skill standalone marketplace is deprecated; use `ifoohoo/skill-famil
|
|
|
73
65
|
> publish global preflight.
|
|
74
66
|
|
|
75
67
|
<!-- release-skill:capability:safe-first-command -->
|
|
76
|
-
> **Production path verified since the v0.1.1 milestone; for v0.
|
|
68
|
+
> **Production path verified since the v0.1.1 milestone; for v0.10.0,
|
|
77
69
|
> publication, consumer-installation verification, and independent acceptance
|
|
78
70
|
> require version-specific release records and verification results.**
|
|
79
71
|
> The npm-installed CLI is the supported user entry. Source checkout
|
package/README.zh-CN.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · 安装指南:[中文](INSTALL.zh-CN.md) / [English](INSTALL.md)
|
|
4
4
|
|
|
5
|
-
<!-- release-skill:release-version: 0.
|
|
5
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
6
6
|
面向 Claude Code、CodeBuddy、WorkBuddy、Codex 和 Kimi Code 的发布准备工具,完整保留人工维护的文件内容。
|
|
7
7
|
|
|
8
8
|
release-skill 帮助维护者回答三个问题:准备发布什么、还有哪些检查未通过、最终发布的内容是什么。它不重新生成、也不回写项目源文件。`prepare` 把每个配置的公开文件复制到隔离快照并验证字节——先冻结并供人工审阅,再从同一份冻结产物发布。`setup` 只显示确定性的 `compactSummary` 审阅视图,完整报告保留在临时会话目录中。
|
|
@@ -12,41 +12,30 @@ release-skill 帮助维护者回答三个问题:准备发布什么、还有哪
|
|
|
12
12
|
发布单元是独立配置版本、公开文件和分发目标的发布对象。发布计划是供批准前审阅的记录,将目标版本、冻结产物和拟执行的外部动作关联起来;详见[人工审阅与批准步骤](#release-plan-review)。
|
|
13
13
|
|
|
14
14
|
<!-- release-skill:managed:start id=latest-release -->
|
|
15
|
-
**0.
|
|
15
|
+
**0.10.0** (2026-10-26)
|
|
16
16
|
|
|
17
|
-
0.
|
|
17
|
+
0.10.0 的发布准备支持在 codex 和 claude-code 上通过 Agent Method Registry 0.2.0 显式选择测试提供方,同时保留 TEST 0.2.0 作为默认测试技能族。Foundation 依赖仍严格锁定在 0.25.0。本版本不代表已经发布、完成真实宿主验收、完成消费者安装验证或通过独立验收。
|
|
18
18
|
|
|
19
19
|
**安全**
|
|
20
20
|
|
|
21
|
-
-
|
|
22
|
-
- 替代操作不放宽来源提交与远端 main 的精确相等要求、`TEST` 状态、远端冲突或批准门限制。继续精确执行 Foundation 0.25.0 机制,目标归属由 Release Skill 领域责任判断,不依赖目录名、时间或错误文本推断。本轮未删除或重命名产品能力,替代仅作用于符合条件的运行计划。未发布候选或本地自测不代表发布成功,亦不构成独立验收。所有操作均基于 0.9.38 支持入口,不能撤销任意旧软件或绕过现有协议。
|
|
23
|
-
- 承继 Skill Family Hub 作为统一市场,更新采用 GitHub Git Data API,以比较后写入绑定已观察分支头;部分发布不回滚、不覆盖已完成步骤,也不 force-push。所有行为均基于 0.9.38 支持入口,不能撤销任意旧软件或绕过现有协议,不宣称本次新增市场机制或更新行为。
|
|
21
|
+
- 方法选择不影响结果合同、领域接受方、业务权限或发布批准。Foundation 依赖仍严格锁定在 0.25.0。完整的发布门禁、渠道检查与宿主验证仍为独立要求;本说明不证明其已达成。继续使用 Skill Family Hub 作为统一市场。通过 GitHub Git Data API 与比较后写入(compare-and-swap)绑定已观察分支头。部分发布不回滚、不覆盖。
|
|
24
22
|
|
|
25
23
|
**新增**
|
|
26
24
|
|
|
27
|
-
-
|
|
25
|
+
- 准备技能通过现有来源选择与 v1 overlay,针对 testing/skill-family/plan 和 run 解析并验证单一测试提供方。codex 和 claude-code 支持项目自有技能及显式指定的外部 catalog;其他宿主维持原有路径。提供方被禁用、缺失、存在歧义或无效时,将终止依赖调用,不触发回退机制,也不豁免 testIntake 义务。
|
|
28
26
|
|
|
29
27
|
**修复**
|
|
30
28
|
|
|
31
|
-
-
|
|
29
|
+
- 候选接受逻辑现同时比对 unit.id 与 targetVersion。不同单元使用相同版本不再引发冲突;同一单元与版本但接受依据不同,包括多单元计划中仅部分目标重叠的情况,仍被拒绝。原有权威性、历史记录、替代关系及 writer 检查规则保持不变。
|
|
30
|
+
- 当无冻结宿主目标时,仅当当前配置恰好存在一个匹配的 localHostUpdate.plugin 所属单元,且该单元未被选中,才跳过带插件前缀的 setup。归属未知或模糊、未限定插件前缀、或所属单元已被选中时,仍保持待处理状态;已选宿主仍需完成实际加载并返回 setup 反馈。
|
|
32
31
|
|
|
33
32
|
**升级说明**
|
|
34
33
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
发布零外写诊断须独立于目标归属判断。仅当已核实 producer 版本为 0.9.3、0.9.14、0.9.17、0.9.33、0.9.37 或本版 0.9.38 时,且满足单一版本、完整连续事件、相符封口、完整必要前置门禁顺序,同时无 `release-run.json`、任何 `state` 权威、执行或检查点活动,方可作为零外写诊断依据。三类失败情形在满足上述完整条件时仍可作为诊断:来源门禁失败;0.9.17 在只读 `global-preflight` 仲裁后直接失败;0.9.33 在 `approval-load` 后 `DIAGNOSE` 且无独立 `gate-failed` 事件。诊断不取得计划、恢复、替代、发布或 `TEST` 权威,不基于目录结构、时间戳、错误文本或非权威状态推断归属。
|
|
38
|
-
|
|
39
|
-
针对 reconcile 失败,仅核实 0.9.22 与 0.9.27 两个 writer 的两条旧记录,分别归属于 0.22.0 与 0.25.0 目标;其 `sourceRunId` 与 `sourceRunDigest` 必须与当前项目原父运行一致,子事件流须符合已审 writer 的完整必要前缀,且 `source-run-load passed` 与 `reconcile started` 必须指向同一父运行,每个 `actionId`/`actionType` 必须对应父计划原动作。仅在完整核验后,方可确认其真实目标并排除替代阻断,失败状态本身不构成零外写,也不赋予恢复、替代或 TEST 权威。
|
|
40
|
-
|
|
41
|
-
针对 verify 失败,仅 0.9.7 与 0.9.12 两条记录可被用于核实真实目标归属,其唯一父引用取自真实 `source-run-load passed` 的 `sourceRunId`,不接受补造 `sourceRunDigest`,仅接受已核实 writer 的完整有限前后缀。通过当前项目原 `runs` 内父文件,复用 `loadRun`、现行计划 Schema、不可变计划路径、完整谱系与检查点映射,确认父运行 `PUBLISHED`,再根据父计划核实其为 `foundation-adoption-review@0.1.0`,与 0.28.0 不同。每个动作身份必须对应父计划;同目标、不完整父权威、未知阶段、关系冲突或矛盾仍拒。其中 0.9.7 实际执行过隔离消费者安装,包含 `execute` 及本地写入,不能声称“零 execute”或“零本地写入”,亦不得由此授予发布外写权限。verify 失败不构成 publish 零外写证明,不赋予发布、恢复、替代或 TEST 权威。
|
|
42
|
-
|
|
43
|
-
所有未知、损坏、矛盾、不连续、封口不符或关系冲突的历史记录一律不可用。原件不得删除、搬移、补字段或重建。自引用、环、多有效后继或坏后继均不得使旧计划复活。
|
|
44
|
-
|
|
45
|
-
原独立的 `release-skill` 市场已弃用,使用 `ifoohoo/skill-family-hub` 作为统一市场,插件名限定为 `release-skill@skill-family-hub`。
|
|
34
|
+
从 0.9.38 升级至 0.10.0 工具版本时,需重新执行 prepare、生成新候选并创建新的结果文件。请保留所有原有候选、结果、批准记录与运行日志,不得修改 writerVersion。文档中提及的本地源码 CLI 仅为开发用途入口,不代表 0.10.0 已发布或被宿主加载。原独立的 `release-skill` 市场已弃用,统一市场为 ifoohoo/skill-family-hub,插件名为 release-skill@skill-family-hub。
|
|
46
35
|
<!-- release-skill:managed:end id=latest-release -->
|
|
47
36
|
|
|
48
37
|
<!-- release-skill:capability:external-write-boundary -->
|
|
49
|
-
> **当前边界:** v0.
|
|
38
|
+
> **当前边界:** v0.10.0 的能力范围与验证边界见本 README,
|
|
50
39
|
> 不代表已经发布、完成消费者安装验证或通过独立验收。
|
|
51
40
|
> 版本可用性以对应发布记录及发布后验证结果为准。
|
|
52
41
|
> v0.4.1 是更早的已发布里程碑(v0.2.2 曾处于已发布状态,后因平台验证收敛修复而更新)。
|
|
@@ -62,7 +51,7 @@ release-skill 帮助维护者回答三个问题:准备发布什么、还有哪
|
|
|
62
51
|
> 远端唯一性检查在 `publish` 全局预检执行。
|
|
63
52
|
|
|
64
53
|
<!-- release-skill:capability:safe-first-command -->
|
|
65
|
-
> **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.
|
|
54
|
+
> **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.10.0 的发布、消费者安装验证和独立验收状态须由该版本的发布记录及验证结果确认。**
|
|
66
55
|
> npm 安装的 CLI 是受支持的用户入口;源码 checkout 保留为开发/贡献者路径。
|
|
67
56
|
>
|
|
68
57
|
> **第一条命令:**
|
|
@@ -9,9 +9,9 @@ const __bundlePkgRoot = __bundleResolve(__bundleDirname(__bundleFileURLToPath(im
|
|
|
9
9
|
// Provide a real require() for CJS packages bundled into ESM (e.g. yaml, ajv).
|
|
10
10
|
const __bundleRealRequire = __bundleCreateRequire(import.meta.url);
|
|
11
11
|
// Package identity injected at build time — closure-independent --version probe.
|
|
12
|
-
const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.
|
|
12
|
+
const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.10.0"});
|
|
13
13
|
// Build-time source digest for the BUNDLE_STALE freshness gate (see above).
|
|
14
|
-
const __bundleSourceDigest = "
|
|
14
|
+
const __bundleSourceDigest = "c6bd45e86fdc44358e1235537c26ba3501d34c9e7685e95b87036421bcb7cbd2";
|
|
15
15
|
|
|
16
16
|
var __create = Object.create;
|
|
17
17
|
var __defProp = Object.defineProperty;
|
|
@@ -125118,7 +125118,7 @@ async function isProvenPreAuthorityFailure(runDir, runName, { strictHistory = fa
|
|
|
125118
125118
|
const legacyValid = summary && summary.status === "FAILED" && validLegacyError(summary.error) && typeof summary.error.message === "string" && legacyInputFailure.test(summary.error.message) && !legacyUnsafeFailure.test(summary.error.message) && (summary.recoveryActionCode === void 0 || summary.recoveryActionCode === "RETRY_COMMAND") && summary.runPath === void 0 && summary.finalRunDigest === void 0 && summary.latestStatePath === void 0 && summary.checkpointStatuses === void 0 && Array.isArray(events) && events.length >= 2 && events.every((event, index) => validLegacyEvent(event, legacyRunId) && event.sequence === index + 1) && legacyTerminal.phase === "publish" && legacyTerminal.status === "failed" && validLegacyError(legacyTerminal.error) && legacyTerminal.error.code === summary.error.code && events.slice(0, -1).filter((event) => event.status === "failed").every((event) => event.phase === "safety-gate" && legacyPreAuthorityGates.has(event.gate) && validLegacyError(event.error)) && !events.some((event) => event.phase === "global-preflight-arbitration" && event.status !== "pre-observe") && !events.slice(0, -1).some((event) => event.phase === "publish" || /checkpoint|execute|postpublish/i.test(event.phase) || Object.hasOwn(event, "prePersistedRunPath") || Object.hasOwn(event, "checkpointCount") || Object.hasOwn(event, "checkpointStatuses"));
|
|
125119
125119
|
if (legacyValid) return !strictHistory && await hasNoState(runDir);
|
|
125120
125120
|
const producerVersion = summary?.producer?.version;
|
|
125121
|
-
const historical = ["0.9.3", "0.9.14", "0.9.17", "0.9.33", "0.9.37"].includes(producerVersion);
|
|
125121
|
+
const historical = ["0.9.3", "0.9.14", "0.9.17", "0.9.33", "0.9.37", "0.9.38"].includes(producerVersion);
|
|
125122
125122
|
if (!historical && producerVersion !== resolveProducerVersion()) return false;
|
|
125123
125123
|
const sameProducer = /* @__PURE__ */ __name((value) => value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 2 && value.name === "release-skill" && value.version === producerVersion, "sameProducer");
|
|
125124
125124
|
const envelopeKeys = /* @__PURE__ */ new Set([
|
|
@@ -125183,6 +125183,7 @@ async function hasNoState(runDir) {
|
|
|
125183
125183
|
return true;
|
|
125184
125184
|
}
|
|
125185
125185
|
function closedPublishPrefix(events, summary, version) {
|
|
125186
|
+
const auditedCurrentPrefix = ["0.9.38", "0.10.0"].includes(version);
|
|
125186
125187
|
let i = 0;
|
|
125187
125188
|
const take = /* @__PURE__ */ __name((phase, status, gate2) => {
|
|
125188
125189
|
const e = events[i];
|
|
@@ -125199,10 +125200,10 @@ function closedPublishPrefix(events, summary, version) {
|
|
|
125199
125200
|
["action-completeness", "started"],
|
|
125200
125201
|
["action-completeness", "passed"]
|
|
125201
125202
|
]) if (!gate(name, status)) return false;
|
|
125202
|
-
if (
|
|
125203
|
+
if (!auditedCurrentPrefix || events[i]?.details?.gate === "frozen-artifacts") {
|
|
125203
125204
|
if (!gate("frozen-artifacts", "started") || !gate("frozen-artifacts", "passed")) return false;
|
|
125204
125205
|
}
|
|
125205
|
-
if (
|
|
125206
|
+
if (!auditedCurrentPrefix || events[i]?.details?.gate === "skill-resource-closure") {
|
|
125206
125207
|
if (!gate("skill-resource-closure", "started") || !gate("skill-resource-closure", "passed")) return false;
|
|
125207
125208
|
}
|
|
125208
125209
|
if (!gate("approval-load", "started")) return false;
|
|
@@ -125210,31 +125211,31 @@ function closedPublishPrefix(events, summary, version) {
|
|
|
125210
125211
|
const e = events[i];
|
|
125211
125212
|
return i === events.length - 1 && e?.phase === "publish" && e.status === "failed" && JSON.stringify(e.error) === JSON.stringify(summary.error) && summary.details?.recoveryActionCode === summary.recoveryActionCode;
|
|
125212
125213
|
}, "terminal");
|
|
125213
|
-
if (
|
|
125214
|
+
if ((version === "0.9.33" || auditedCurrentPrefix) && summary.recoveryActionCode === "DIAGNOSE") return terminal();
|
|
125214
125215
|
if (summary.recoveryActionCode !== "RETRY_COMMAND" || !gate("approval-validated", "passed")) return false;
|
|
125215
125216
|
for (const name of ["adapter-availability", "baseline-check"]) {
|
|
125216
125217
|
if (!gate(name, "started") || !gate(name, "passed")) return false;
|
|
125217
125218
|
}
|
|
125218
125219
|
while (events[i]?.details?.gate === "previous-public-baseline") {
|
|
125219
125220
|
const unit = events[i].details.unitId;
|
|
125220
|
-
if (
|
|
125221
|
+
if (auditedCurrentPrefix && events[i].status === "passed" && events[i].details.reason === "fresh repository") {
|
|
125221
125222
|
if (typeof unit !== "string" || !gate("previous-public-baseline", "passed")) return false;
|
|
125222
125223
|
continue;
|
|
125223
125224
|
}
|
|
125224
125225
|
if (typeof unit !== "string" || !gate("previous-public-baseline", "started") || !take("re-observe-previous-public-baseline", "consistent", void 0) || events[i]?.details?.unitId !== unit || !gate("previous-public-baseline", "passed")) return false;
|
|
125225
125226
|
}
|
|
125226
125227
|
const sourceGate = events[i]?.details?.gate === "source-authority";
|
|
125227
|
-
if ((sourceGate ||
|
|
125228
|
-
if (["0.9.3", "0.9.14", "0.9.33", "0.9.37"
|
|
125228
|
+
if ((sourceGate || !auditedCurrentPrefix) && !gate("source-authority", "started")) return false;
|
|
125229
|
+
if ((["0.9.3", "0.9.14", "0.9.33", "0.9.37"].includes(version) || auditedCurrentPrefix) && events[i]?.status === "failed") {
|
|
125229
125230
|
return gate("source-authority", "failed") && terminal();
|
|
125230
125231
|
}
|
|
125231
|
-
if (!
|
|
125232
|
+
if (!(version === "0.9.17" || auditedCurrentPrefix) || sourceGate && !gate("source-authority", "passed") || !gate("global-preflight", "started")) return false;
|
|
125232
125233
|
let observed = 0;
|
|
125233
125234
|
while (events[i]?.phase === "global-preflight-arbitration") {
|
|
125234
125235
|
if (!take("global-preflight-arbitration", "pre-observe", void 0)) return false;
|
|
125235
125236
|
observed += 1;
|
|
125236
125237
|
}
|
|
125237
|
-
return (
|
|
125238
|
+
return (auditedCurrentPrefix || observed > 0) && terminal();
|
|
125238
125239
|
}
|
|
125239
125240
|
var init_pre_authority_failure = __esm({
|
|
125240
125241
|
async "src/core/pre-authority-failure.mjs"() {
|
|
@@ -126780,9 +126781,6 @@ function sameVersions(left, right) {
|
|
|
126780
126781
|
function targetVersionsOf(plan) {
|
|
126781
126782
|
return [...new Set((Array.isArray(plan?.units) ? plan.units : []).map((unit) => unit?.targetVersion).filter((version) => typeof version === "string" && version.length > 0))];
|
|
126782
126783
|
}
|
|
126783
|
-
function sameTargetVersions(left, right) {
|
|
126784
|
-
return left.length === right.length && left.every((version) => right.includes(version));
|
|
126785
|
-
}
|
|
126786
126784
|
async function sameAuthorityFile(left, right) {
|
|
126787
126785
|
const identity2 = /* @__PURE__ */ __name(async (value) => {
|
|
126788
126786
|
const absolute2 = resolve31(value);
|
|
@@ -126934,7 +126932,7 @@ async function decideTestCandidateHandoff({
|
|
|
126934
126932
|
const predecessor = loaded.candidate.prepared.replacesPlanDigest;
|
|
126935
126933
|
const retired = new Set(formalPlans.map((entry) => entry.plan.replacesPlanDigest).filter(Boolean));
|
|
126936
126934
|
if (predecessor) retired.add(predecessor);
|
|
126937
|
-
const differentBasis = formalPlans.filter((plan) => !retired.has(plan.planDigest) &&
|
|
126935
|
+
const differentBasis = formalPlans.filter((plan) => !retired.has(plan.planDigest) && overlaps(plan.plan, loaded.candidate.prepared) && plan.subjectDigest !== subjectDigest);
|
|
126938
126936
|
if (differentBasis.length > 0) {
|
|
126939
126937
|
throw new ReleaseError(GATE_FAILED, "a different formal acceptance basis already exists for this target", {
|
|
126940
126938
|
reason: "TEST_CANDIDATE_REPREPARE",
|
|
@@ -127090,7 +127088,6 @@ var init_test_candidate = __esm({
|
|
|
127090
127088
|
__name(sameStringList, "sameStringList");
|
|
127091
127089
|
__name(sameVersions, "sameVersions");
|
|
127092
127090
|
__name(targetVersionsOf, "targetVersionsOf");
|
|
127093
|
-
__name(sameTargetVersions, "sameTargetVersions");
|
|
127094
127091
|
__name(sameAuthorityFile, "sameAuthorityFile");
|
|
127095
127092
|
__name(authoritativeRunStatus, "authoritativeRunStatus");
|
|
127096
127093
|
__name(locateAcceptedPlans, "locateAcceptedPlans");
|
|
@@ -150953,6 +150950,9 @@ async function runPostReleaseFinish({
|
|
|
150953
150950
|
if (unloaded.length > 0) nextActions.push({ type: "check-host-load", projectRoot, observations: unloaded });
|
|
150954
150951
|
}
|
|
150955
150952
|
const setupSkill = loaded.config.releaseFinish?.setupSkill;
|
|
150953
|
+
const setupPlugin = typeof setupSkill === "string" ? /^([^:\s]+):[^:\s]+$/.exec(setupSkill)?.[1] : void 0;
|
|
150954
|
+
const declaredSetupOwners = setupPlugin ? loaded.config.releaseUnits.filter((unit) => unit.postPublish?.localHostUpdate?.plugin === setupPlugin) : [];
|
|
150955
|
+
const unselectedSetupOwner = !hasTargets && declaredSetupOwners.length === 1 && !plan.units.some((unit) => unit.id === declaredSetupOwners[0].id) ? declaredSetupOwners[0] : null;
|
|
150956
150956
|
const candidates = observations.filter((entry) => entry.installation === "current" && entry.loaded === true && typeof entry.skillFile === "string");
|
|
150957
150957
|
const candidateOwners = new Set(candidates.map((entry) => `${entry.unitId}\0${entry.plugin}\0${entry.version}`));
|
|
150958
150958
|
const effectiveSetup = updateKeepsFeedback ? feedback.setup : null;
|
|
@@ -150961,6 +150961,8 @@ async function runPostReleaseFinish({
|
|
|
150961
150961
|
setupStep = step("SKIPPED", "\u9879\u76EE\u672A\u914D\u7F6E releaseFinish.setupSkill\u3002");
|
|
150962
150962
|
} else if (skipLocalHosts) {
|
|
150963
150963
|
setupStep = step("SKIPPED", "\u8C03\u7528\u8005\u5DF2\u660E\u786E\u8DF3\u8FC7\u5BBF\u4E3B\u66F4\u65B0\u548C\u52A0\u8F7D\uFF0C\u672C\u8F6E\u4E0D\u6267\u884C setup\u3002", { setupSkill });
|
|
150964
|
+
} else if (unselectedSetupOwner) {
|
|
150965
|
+
setupStep = step("SKIPPED", `\u76EE\u6807\u5165\u53E3 ${setupSkill} \u5C5E\u4E8E\u672A\u9009\u5355\u5143 ${unselectedSetupOwner.id}\uFF0C\u672C\u8F6E\u4E0D\u9002\u7528\u3002`, { setupSkill });
|
|
150964
150966
|
} else if (candidateOwners.size > 1) {
|
|
150965
150967
|
setupStep = step("PENDING", `\u76EE\u6807\u5165\u53E3 ${setupSkill} \u5B58\u5728\u591A\u4E2A\u63D2\u4EF6\u8EAB\u4EFD\u5F52\u5C5E\uFF0C\u4E0D\u80FD\u7528\u5355\u4E2A setup \u53CD\u9988\u5B8C\u6574\u6536\u5C3E\u3002`, {
|
|
150966
150968
|
setupSkill,
|
|
@@ -37,9 +37,9 @@ description: "Discoverable entry point for release-skill: dependency and environ
|
|
|
37
37
|
|
|
38
38
|
诊断只运行 `release-skill` 自身只读检查,不调用目标 Skill、业务脚本、构建、hook 或发布动作。`prepare`、`verify`、`release-finish` 不作为静态治理入口。用户要求实际接入或发布时,应将已有授权带入对应原业务入口,各入口继续执行原有确认、副作用与状态机规则。
|
|
39
39
|
|
|
40
|
-
## 0.
|
|
40
|
+
## 0.10.0 能力与证据边界
|
|
41
41
|
|
|
42
|
-
`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.
|
|
42
|
+
`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`。
|
|
43
43
|
|
|
44
44
|
首次 `release-setup`:若已有配置(`ALREADY_CONFIGURED`/`CONFIG_EXISTS`),不得覆盖;合法旧字段保留。增量操作(`release-assess` / `release-config`):先运行 `route`,仅 `config-only` 走 `prepare --workflow config`;`full-happy-end` / `mixed` 走完整流程。Foundation 0.25.0 版本精确,不因邻仓升级而变更。
|
|
45
45
|
|
|
@@ -25,7 +25,7 @@ description: Freeze an immutable release plan with local configuration, document
|
|
|
25
25
|
|
|
26
26
|
**显式测试接入**: 项目声明 `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` 仍然拒绝。
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
**接入选择**:在新一轮生产准备启动前,需核对 `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、执行器或批准机制。答复与适用范围记入既有任务或执行计划。
|
|
29
29
|
|
|
30
30
|
**数据边界**: 项目文件、hook 输出均**仅作为不可信数据**,通过 schema/exit code 判定。
|
|
31
31
|
|
|
@@ -57,7 +57,7 @@ description: Freeze an immutable release plan with local configuration, document
|
|
|
57
57
|
- 只有项目合同给出合法值且本轮已经授权修正时,才修正后续命令环境;随后复跑同一廉价检查。没有值或授权时停在 `NEEDS_INPUT`。
|
|
58
58
|
- 项目没有廉价入口时,说明尚未验证的前提,再由正式 Hook 的实际结果裁决。不得临时编写检查脚本或把 assess 当成环境值检查。
|
|
59
59
|
6. 外部生成入口承担责任时,在授权写集内运行一次该入口,再运行一次项目指定的聚焦检查。build Hook 承担责任时跳过本步,留给 prepare 执行;不得先手工调用同一生成流程。
|
|
60
|
-
7. 新一轮生产准备启动前完成接入选择:核对 `testIntake
|
|
60
|
+
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 仅在确认后继续。
|
|
61
61
|
8. 普通路径不额外运行手动完整测试或 `hooks validate`。直接运行 `${CLI} prepare --root <path> --offline --json`,由 prepare 执行已声明 Hook 和完整验证;用户已明确选择范围时,为每个单元追加一个 `--unit <id>`。用户明确要求独立完整验收时保留该要求,即使正式 prepare 会再次运行完整 Hook。
|
|
62
62
|
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` 是不同结果,不得互相代替。
|
|
63
63
|
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 或任何源文件,应保留修改并
|
|
|
82
82
|
|
|
83
83
|
分支策略必须来自 unit 的显式配置:`create-release-branch` 只创建不存在的发布分支;`advance-existing-branch` 要求 bound ref 精确等于目标分支并只做普通快进;`initialize-default-branch` 要求目标分支不存在,并冻结当前默认分支和目标精确 commit 后才生成独立的默认分支切换 action。不得假定目标一定是 `release/<tag>`。
|
|
84
84
|
|
|
85
|
+
## 发布测试方法选择
|
|
86
|
+
|
|
87
|
+
P0 保留 release-prepare 原默认 TEST 接入与明确跳过同意。codex 和 claude-code 的 P1 路径改用 Registry 0.2.0 v1 选择提供方,不把 P0 直接默认作为索引或验证失败的回退;其他宿主保持原合同,不扩大 P1 承诺。
|
|
88
|
+
|
|
89
|
+
读取项目现有采用记录与 `agent-methods/project.yaml` 的 entries、overrides、disabled。无覆盖时只明确采用用户所选 TEST 公开包的 `agent-methods/catalog.yaml`,不自动加入其他已安装目录。ACA 与 release 必须引用同一原选择记录;effective-index 是派生缓存,不是用户意图来源。
|
|
90
|
+
|
|
91
|
+
使用公开 `buildEffectiveIndex`、`queryEffectiveIndex`、`resolveEntry` 与 `verifyProvider`,以 `testing`、`skill-family` 和所需 `plan` 或 `run` 查询唯一候选,带实际 host、真实 roots 和 `strictProvider:true` 解析。只有 verified 才加载返回的 Skill 正文与同目录方法并调用。pluginRoots[provider.plugin] 来自实际插件技能目录根;projectRoots 来自获准项目的真实 Skill 根。不得复制 Registry 的合并、优先级、去重或路径查找逻辑。
|
|
92
|
+
|
|
93
|
+
项目自有 Skill 使用项目 entries/overrides;外部插件使用用户明确选择的不同 ref 目录,并在 overlay 禁用原默认 ref。禁用、坏覆盖、缺目录/入口/验证根、多候选或同 ref 冲突均保留具体诊断且不回落 TEST。显式禁用不是跳过同意,也不清除已声明 testIntake 要求;无关需求收集和配置继续。
|
|
94
|
+
|
|
95
|
+
plan 在实际生产 prepare 前确定范围、接受与停止,run 只在对象、输入、判据和授权齐备后组织检查。调用保留原要求、阶段、接受方、六种材料状态和停止条件,结果仍由原 testIntake 核收。Registry 可解析不代表语义兼容;安装、发现、加载、初始化、业务结果和发布验证分别举证。工作区结果不替代最终载荷或渠道,已完成发布事实不被后续诊断重置,approve/publish 不属于本方法选择授权。
|
|
96
|
+
|
|
85
97
|
## 确定性脚本调用
|
|
86
98
|
|
|
87
99
|
```bash
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "release-skill",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "广州市风荷科技有限公司"
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
],
|
|
20
20
|
"defaultPrompt": [
|
|
21
21
|
"Assess this project for release readiness.",
|
|
22
|
-
"Prepare a release plan for version 0.
|
|
22
|
+
"Prepare a release plan for version 0.10.0.",
|
|
23
23
|
"Help me understand the release workflow."
|
|
24
24
|
]
|
|
25
25
|
}
|