release-skill 0.8.1 → 0.9.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/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codebuddy-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +2 -2
- package/.kimi-plugin/plugin.json +1 -1
- package/CHANGELOG.md +31 -0
- package/INSTALL.md +14 -2
- package/INSTALL.zh-CN.md +12 -2
- package/README.md +28 -16
- package/README.zh-CN.md +23 -14
- package/adapters/claude/.claude-plugin/marketplace.json +1 -1
- package/adapters/claude/.claude-plugin/plugin.json +1 -1
- package/adapters/claude/bin/release-skill-local-finish.mjs +4 -0
- package/adapters/claude/bin/release-skill.bundle.mjs +2416 -1320
- package/adapters/claude/schemas/release-plan.schema.json +40 -3
- package/adapters/claude/skills/release-finish/SKILL.md +65 -0
- package/adapters/claude/skills/release-verify/SKILL.md +6 -1
- package/adapters/codex/.codex-plugin/plugin.json +2 -2
- package/adapters/codex/bin/release-skill-local-finish.mjs +4 -0
- package/adapters/codex/bin/release-skill.bundle.mjs +2416 -1320
- package/adapters/codex/schemas/release-plan.schema.json +40 -3
- package/adapters/codex/skills/release-finish/SKILL.md +72 -0
- package/adapters/codex/skills/release-verify/SKILL.md +6 -1
- package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
- package/adapters/kimi/bin/release-skill-local-finish.mjs +4 -0
- package/adapters/kimi/bin/release-skill.bundle.mjs +2416 -1320
- package/adapters/kimi/schemas/release-plan.schema.json +40 -3
- package/adapters/kimi/skills/release-finish/SKILL.md +72 -0
- package/adapters/kimi/skills/release-verify/SKILL.md +6 -1
- package/adapters/workbuddy/.codebuddy-plugin/plugin.json +1 -1
- package/adapters/workbuddy/bin/release-skill-local-finish.mjs +4 -0
- package/adapters/workbuddy/bin/release-skill.bundle.mjs +2416 -1320
- package/adapters/workbuddy/schemas/release-plan.schema.json +40 -3
- package/adapters/workbuddy/skills/release-finish/SKILL.md +65 -0
- package/adapters/workbuddy/skills/release-verify/SKILL.md +6 -1
- package/bin/release-skill-cli.mjs +126 -1
- package/bin/release-skill-local-finish.mjs +4 -0
- package/bin/release-skill.bundle.mjs +2416 -1320
- package/package.json +1 -1
- package/platform-manifest.json +30 -4
- package/schemas/release-plan.schema.json +40 -3
- package/skills/release-finish/SKILL.md +65 -0
- package/skills/release-verify/SKILL.md +6 -1
- package/skills-src/release-finish/SKILL.md +65 -0
- package/skills-src/release-verify/SKILL.md +6 -1
- package/src/commands/approve.mjs +14 -2
- package/src/commands/distribute.mjs +562 -321
- package/src/commands/post-release-local.mjs +611 -0
- package/src/commands/postverify.mjs +262 -155
- package/src/commands/prepare.mjs +67 -52
- package/src/commands/publish.mjs +11 -10
- package/src/commands/reconcile.mjs +11 -10
- package/src/commands/setup.mjs +26 -13
- package/src/commands/ship.mjs +45 -12
- package/src/commands/verify.mjs +19 -8
- package/src/core/adoption-assessment.mjs +0 -3
- package/src/core/approval.mjs +11 -8
- package/src/core/hooks.mjs +0 -16
- package/src/core/plan.mjs +19 -11
- package/src/core/postpublish-approval.mjs +12 -2
- package/src/core/postpublish-bundle.mjs +51 -13
- package/src/core/postpublish.mjs +146 -6
- package/src/core/preset-executor.mjs +53 -0
- package/src/core/proposal-inbox.mjs +91 -27
- package/src/core/recovery.mjs +27 -12
- package/src/producers/build-adapters.mjs +10 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "release-skill",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.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.9.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,36 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.9.0 locale=en baseline=sha256:80f51046ce63386f75ed1a2b869cf3245732e9a1b040e11eb8942dba5f7c8fed -->
|
|
4
|
+
## [0.9.0] - 2026-08-28
|
|
5
|
+
|
|
6
|
+
0.9.0 is a local source candidate for multi-unit postPublish plans and optional post-release local finishing. This note records the intended scope and verification boundaries; it is not evidence of publication, consumer-installation verification, or independent acceptance. Release availability must be established from the corresponding release records and post-publish verification results.
|
|
7
|
+
|
|
8
|
+
### Security
|
|
9
|
+
|
|
10
|
+
- release-finish requires a plan-digest confirmation and a VERIFIED run from the same release lineage before any host command. Host updates use a restricted environment; Claude/Codex exact results are bound to the real installed payload, and every host fails closed when the identity evidence its protocol can provide is insufficient.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Plan version 3 freezes postPublish declarations per release unit as an ordered array. Each declaration carries its own targets, hooks, approval binding, execution bundle, checkpoints, and postVerify continuation while explicit plan versions 1 and 2 retain their established single-declaration behavior.
|
|
15
|
+
- A new release-finish workflow derives a read-only local checklist from the frozen plan and VERIFIED run. After explicit user confirmation it can update Claude and Codex, drive the Kimi TUI and verify the resulting installation, or confirm that CodeBuddy/WorkBuddy already matches the frozen identity; CodeBuddy/WorkBuddy updates that cannot pin the frozen ref remain manual. None of these local actions changes the published release terminal state.
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
|
|
19
|
+
- The distribute and postVerify phases preflight every declaration before the first external write, then re-observe mutable remote proposal state during execution. Checkpoint identifiers are namespaced by release unit, and an earlier hook failure skips all later-unit work.
|
|
20
|
+
- PostPublish hook identifiers are unique across the complete plan. Prepare, setup, approval, distribute, and postVerify consume the same validation rule before side effects.
|
|
21
|
+
|
|
22
|
+
### Fixed
|
|
23
|
+
|
|
24
|
+
- Prevent a later unit's missing bundle or deterministic proposal conflict from being discovered only after an earlier unit has already written remotely.
|
|
25
|
+
- Preserve PARTIAL when a checkpoint has succeeded before a later failure, and preserve BLOCKED when no external checkpoint succeeded.
|
|
26
|
+
- Prevent duplicate target names and duplicate hook identifiers from collapsing evidence or approval identity across release units.
|
|
27
|
+
|
|
28
|
+
### Upgrade Notes
|
|
29
|
+
|
|
30
|
+
Prepare a new 0.9.0 plan to use plan version 3; do not edit or upgrade frozen older plans. Plan versions 1 and 2 remain readable only through their explicit compatibility path. release-finish is optional local follow-up, not publication evidence: branch merges, Kimi trust prompts, and local host changes still require explicit user consent, and unsupported exact-ref updates remain manual. Hook cache v2, safe full-tree inventory, the Audit offline release-record verifier, and mandatory public-marketplace host invocation gates remain outside this version.
|
|
31
|
+
<!-- release-skill:changelog:end version=0.9.0 locale=en -->
|
|
32
|
+
|
|
33
|
+
|
|
3
34
|
<!-- release-skill:changelog:start version=0.8.1 locale=en baseline=sha256:c1dcef984b85d6da26cba7f15225d03f1cbaedc510a7c63149306d49a2c5532e -->
|
|
4
35
|
## [0.8.1] - 2026-08-27
|
|
5
36
|
|
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.9.0 -->
|
|
6
6
|
## Prerequisites
|
|
7
7
|
|
|
8
8
|
- Node.js 22.0.0 or later
|
|
@@ -114,10 +114,16 @@ tag pinned to the exact version (never the bare repository URL, which installs
|
|
|
114
114
|
the latest release or default branch), confirm the trust prompt, then reload:
|
|
115
115
|
|
|
116
116
|
```
|
|
117
|
-
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.
|
|
117
|
+
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.0
|
|
118
118
|
/plugins reload
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
+
After the release has reached `VERIFIED`, the optional `release-finish` workflow
|
|
122
|
+
can perform the same TUI interaction only after explicit user confirmation. It
|
|
123
|
+
then re-reads Kimi's managed installation root and requires the version, tag,
|
|
124
|
+
revision, and Git commit to match the frozen plan. This local check is not part
|
|
125
|
+
of `verify` and does not alter the `VERIFIED` release state.
|
|
126
|
+
|
|
121
127
|
No receipt or attestation is required. The `attest` command remains available
|
|
122
128
|
only for frozen plans created by older versions that lack the
|
|
123
129
|
`humanConsumersStrategy: manualFollowUps` marker.
|
|
@@ -145,6 +151,12 @@ reports `verifiedBySystem: false`. Install from the bundled-family marketplace
|
|
|
145
151
|
`ifoohoo/release-skill` after publishing. No receipt or attestation is required
|
|
146
152
|
for new plans; `attest` exists only for old frozen-plan compatibility.
|
|
147
153
|
|
|
154
|
+
The optional `release-finish` workflow can inspect the CodeBuddy/WorkBuddy list
|
|
155
|
+
after explicit confirmation. It reports `ALREADY_CURRENT` only when the listed
|
|
156
|
+
marketplace, version, and frozen commit all match. Because the CLI cannot pin a
|
|
157
|
+
ref, a mismatch remains `MANUAL_REQUIRED`; release-finish does not update to an
|
|
158
|
+
unbound latest version.
|
|
159
|
+
|
|
148
160
|
For a single session from a source checkout you can also point CodeBuddy at the
|
|
149
161
|
generated plugin directory with `--plugin-dir <path>/adapters/workbuddy`; the
|
|
150
162
|
adapter never references files outside its own directory.
|
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.9.0 -->
|
|
6
6
|
## 前置条件
|
|
7
7
|
|
|
8
8
|
- Node.js 22.0.0 或更高版本
|
|
@@ -104,10 +104,15 @@ Kimi Code 有交互式插件市场,但**没有可脚本化的非交互安装
|
|
|
104
104
|
(切勿使用裸仓库地址,它会安装最新 release 或默认分支),确认信任提示后重新加载:
|
|
105
105
|
|
|
106
106
|
```
|
|
107
|
-
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.
|
|
107
|
+
/plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.0
|
|
108
108
|
/plugins reload
|
|
109
109
|
```
|
|
110
110
|
|
|
111
|
+
发布达到 `VERIFIED` 后,可选的 `release-finish` 工作流可以在用户明确同意后执行
|
|
112
|
+
同一套 TUI 操作。随后它会重新读取 Kimi 的受管安装根,并要求版本、标签、修订号和
|
|
113
|
+
Git 提交与冻结计划一致。这个本机检查不属于 `verify`,也不会改变已经完成的
|
|
114
|
+
`VERIFIED` 发布状态。
|
|
115
|
+
|
|
111
116
|
新计划无需收据或人工证明。`attest` 命令仅兼容缺少
|
|
112
117
|
`humanConsumersStrategy: manualFollowUps` 标记的旧冻结计划。
|
|
113
118
|
|
|
@@ -129,6 +134,11 @@ codebuddy CLI 可以添加市场并安装插件,但 **`plugin marketplace add`
|
|
|
129
134
|
不检查安装并返回 `verifiedBySystem: false`。发布后从 bundled-family 市场
|
|
130
135
|
`ifoohoo/release-skill` 安装即可。新计划无需收据或人工证明;`attest` 只兼容旧冻结计划。
|
|
131
136
|
|
|
137
|
+
可选的 `release-finish` 工作流会在用户明确同意后读取 CodeBuddy/WorkBuddy 的安装
|
|
138
|
+
列表。只有市场、版本和冻结提交全部一致时才报告 `ALREADY_CURRENT`。由于 CLI 无法
|
|
139
|
+
钉死 ref,不匹配时仍返回 `MANUAL_REQUIRED`;release-finish 不会改装到一个未绑定的
|
|
140
|
+
latest 版本。
|
|
141
|
+
|
|
132
142
|
源码检出后也可以用 `--plugin-dir <path>/adapters/workbuddy` 把 CodeBuddy 指向
|
|
133
143
|
生成的插件目录做单会话使用;适配器不引用自身目录之外的任何文件。
|
|
134
144
|
|
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.9.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,
|
|
@@ -14,33 +14,37 @@ Setup surfaces only the deterministic `compactSummary` review view; the full
|
|
|
14
14
|
report stays in a temporary session directory.
|
|
15
15
|
|
|
16
16
|
<!-- release-skill:managed:start id=latest-release -->
|
|
17
|
-
**0.
|
|
17
|
+
**0.9.0** (2026-08-28)
|
|
18
18
|
|
|
19
|
-
0.
|
|
19
|
+
0.9.0 is a local source candidate for multi-unit postPublish plans and optional post-release local finishing. This note records the intended scope and verification boundaries; it is not evidence of publication, consumer-installation verification, or independent acceptance. Release availability must be established from the corresponding release records and post-publish verification results.
|
|
20
20
|
|
|
21
21
|
**Security**
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- release-finish requires a plan-digest confirmation and a VERIFIED run from the same release lineage before any host command. Host updates use a restricted environment; Claude/Codex exact results are bound to the real installed payload, and every host fails closed when the identity evidence its protocol can provide is insufficient.
|
|
24
|
+
|
|
25
|
+
**Added**
|
|
26
|
+
|
|
27
|
+
- Plan version 3 freezes postPublish declarations per release unit as an ordered array. Each declaration carries its own targets, hooks, approval binding, execution bundle, checkpoints, and postVerify continuation while explicit plan versions 1 and 2 retain their established single-declaration behavior.
|
|
28
|
+
- A new release-finish workflow derives a read-only local checklist from the frozen plan and VERIFIED run. After explicit user confirmation it can update Claude and Codex, drive the Kimi TUI and verify the resulting installation, or confirm that CodeBuddy/WorkBuddy already matches the frozen identity; CodeBuddy/WorkBuddy updates that cannot pin the frozen ref remain manual. None of these local actions changes the published release terminal state.
|
|
24
29
|
|
|
25
30
|
**Changed**
|
|
26
31
|
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
- Evidence v2 closes the top level and stores phase extensions in typed details. Evidence v1 remains read-only. Summaries, producer versions, and recovery suggestions are diagnostic, never publication authority.
|
|
32
|
+
- The distribute and postVerify phases preflight every declaration before the first external write, then re-observe mutable remote proposal state during execution. Checkpoint identifiers are namespaced by release unit, and an earlier hook failure skips all later-unit work.
|
|
33
|
+
- PostPublish hook identifiers are unique across the complete plan. Prepare, setup, approval, distribute, and postVerify consume the same validation rule before side effects.
|
|
30
34
|
|
|
31
35
|
**Fixed**
|
|
32
36
|
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
37
|
+
- Prevent a later unit's missing bundle or deterministic proposal conflict from being discovered only after an earlier unit has already written remotely.
|
|
38
|
+
- Preserve PARTIAL when a checkpoint has succeeded before a later failure, and preserve BLOCKED when no external checkpoint succeeded.
|
|
39
|
+
- Prevent duplicate target names and duplicate hook identifiers from collapsing evidence or approval identity across release units.
|
|
36
40
|
|
|
37
41
|
**Upgrade Notes**
|
|
38
42
|
|
|
39
|
-
|
|
43
|
+
Prepare a new 0.9.0 plan to use plan version 3; do not edit or upgrade frozen older plans. Plan versions 1 and 2 remain readable only through their explicit compatibility path. release-finish is optional local follow-up, not publication evidence: branch merges, Kimi trust prompts, and local host changes still require explicit user consent, and unsupported exact-ref updates remain manual. Hook cache v2, safe full-tree inventory, the Audit offline release-record verifier, and mandatory public-marketplace host invocation gates remain outside this version.
|
|
40
44
|
<!-- release-skill:managed:end id=latest-release -->
|
|
41
45
|
|
|
42
46
|
<!-- release-skill:capability:external-write-boundary -->
|
|
43
|
-
> **Current boundary:** v0.
|
|
47
|
+
> **Current boundary:** v0.9.0 is the current source candidate. This README
|
|
44
48
|
> records intended scope and verification boundaries; it is not evidence of
|
|
45
49
|
> publication, consumer-installation verification, or independent acceptance.
|
|
46
50
|
> Release availability must be established from the corresponding release records
|
|
@@ -64,7 +68,7 @@ Old production plans missing sourceAuthority and checker v4 plans must not be si
|
|
|
64
68
|
> publish global preflight.
|
|
65
69
|
|
|
66
70
|
<!-- release-skill:capability:safe-first-command -->
|
|
67
|
-
> **Production path verified since the v0.1.1 milestone; v0.
|
|
71
|
+
> **Production path verified since the v0.1.1 milestone; v0.9.0 is the current
|
|
68
72
|
> source candidate. Its README does not establish publication,
|
|
69
73
|
> consumer-installation verification, or independent acceptance.**
|
|
70
74
|
> The npm-installed CLI is the supported user entry. Source checkout
|
|
@@ -724,6 +728,13 @@ verification is automated. Kimi Code and CodeBuddy/WorkBuddy are returned as
|
|
|
724
728
|
`manualFollowUps` with `verifiedBySystem: false`; their completion is not a
|
|
725
729
|
condition for the automated release to reach `VERIFIED`.
|
|
726
730
|
|
|
731
|
+
After `VERIFIED`, the optional `release-finish` workflow can update Claude and
|
|
732
|
+
Codex from the frozen marketplace identity, drive Kimi's TUI and re-check its
|
|
733
|
+
managed installation, or confirm an already exact CodeBuddy/WorkBuddy entry.
|
|
734
|
+
It requires explicit user confirmation, does not change release status, and
|
|
735
|
+
leaves CodeBuddy/WorkBuddy mismatches for manual handling because that CLI
|
|
736
|
+
cannot pin the frozen ref.
|
|
737
|
+
|
|
727
738
|
A `codebuddy-plugin` distribution may optionally declare `marketplace` (and
|
|
728
739
|
`marketplaceSource`, the URL consumers use to add the marketplace) to override
|
|
729
740
|
the default unified marketplace `artifact-skill-set`; undeclared distributions
|
|
@@ -749,9 +760,10 @@ declaration is narrowed to concrete targets.
|
|
|
749
760
|
- no overwrite of branches/tags/releases or npm unpublish; create-only refs use
|
|
750
761
|
`--force-with-lease=<ref>:` solely as an atomic compare-and-set assertion that
|
|
751
762
|
the ref is absent, while existing branches use an ordinary non-force push;
|
|
752
|
-
- no
|
|
753
|
-
|
|
754
|
-
|
|
763
|
+
- no Kimi or CodeBuddy/WorkBuddy marketplace install checkpoint in the release
|
|
764
|
+
state machine — optional release-finish can drive and re-check Kimi locally,
|
|
765
|
+
or confirm an already exact CodeBuddy/WorkBuddy entry, but those results do
|
|
766
|
+
not become publication evidence;
|
|
755
767
|
- no promise of Windows or broad multi-platform native write support;
|
|
756
768
|
- no hidden commit, push, tag, release, or package publication.
|
|
757
769
|
|
package/README.zh-CN.md
CHANGED
|
@@ -2,39 +2,43 @@
|
|
|
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.9.0 -->
|
|
6
6
|
面向 Claude Code、CodeBuddy、WorkBuddy、Codex 和 Kimi Code 的发布准备工具,完整保留人工维护的文件内容。
|
|
7
7
|
|
|
8
8
|
release-skill 帮助维护者回答三个问题:准备发布什么、还有哪些检查未通过、最终发布的内容是什么。它不重新生成、也不回写项目源文件。`prepare` 把每个配置的公开文件复制到隔离快照并验证字节——先冻结并供人工审阅,再从同一份冻结产物发布。`setup` 只显示确定性的 `compactSummary` 审阅视图,完整报告保留在临时会话目录中。
|
|
9
9
|
|
|
10
10
|
<!-- release-skill:managed:start id=latest-release -->
|
|
11
|
-
**0.
|
|
11
|
+
**0.9.0** (2026-08-28)
|
|
12
12
|
|
|
13
|
-
0.
|
|
13
|
+
0.9.0 是多发布单元 postPublish 计划和可选发布后本机收尾能力的本地源码候选。本说明记录预期范围与验证边界,不代表已经发布、完成消费者安装验证或通过独立验收。版本是否可用,须以对应的生产发布记录和发布后验证结果为准。
|
|
14
14
|
|
|
15
15
|
**安全**
|
|
16
16
|
|
|
17
|
-
-
|
|
17
|
+
- release-finish 在执行宿主命令前,要求确认计划摘要,并核对同一发布血缘的 VERIFIED run。宿主更新只传入受限环境;Claude/Codex 的精确结果绑定真实安装载荷,各宿主在自身协议能够提供的身份依据不足时都会失败关闭。
|
|
18
|
+
|
|
19
|
+
**新增**
|
|
20
|
+
|
|
21
|
+
- 计划版本 3 按发布单元冻结有序的 postPublish 声明数组。每项声明分别绑定目标、Hook、批准、执行包、检查点和 postVerify 后续动作;显式的计划版本 1、2 继续保持既有单声明语义。
|
|
22
|
+
- 新增 release-finish 工作流。它从冻结计划和同一血缘的 VERIFIED run 派生只读本机收尾清单;用户明确同意后,可更新 Claude 和 Codex、驱动 Kimi TUI 并复验安装结果,或确认 CodeBuddy/WorkBuddy 已经精确匹配冻结身份。CodeBuddy/WorkBuddy 无法钉死冻结 ref 时仍转人工处理;这些本机动作都不改变已经完成的发布终态。
|
|
18
23
|
|
|
19
24
|
**变更**
|
|
20
25
|
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
- evidence v2 顶层封闭,阶段扩展进入受类型约束的 details;evidence v1 保持只读。摘要、生产者版本和恢复建议只作诊断,不构成发布权威。
|
|
26
|
+
- distribute 和 postVerify 在首次外部写入前预检全部声明,执行时重新观察可能变化的远端 proposal 状态。检查点 ID 按发布单元区分;前一项 Hook 失败后,后续单元全部跳过。
|
|
27
|
+
- 整份计划中的 postPublish Hook ID 必须唯一。prepare、setup、批准、distribute 和 postVerify 在副作用发生前复用同一条校验规则。
|
|
24
28
|
|
|
25
29
|
**修复**
|
|
26
30
|
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
31
|
+
- 修复后续单元缺执行包或存在确定性 proposal 冲突时,前序单元已经写入远端的问题。
|
|
32
|
+
- 任一检查点成功后发生后续失败时保留 PARTIAL;没有外部检查点成功时保持 BLOCKED。
|
|
33
|
+
- 避免不同发布单元使用同名 target 或重复 Hook ID 时,证据与批准身份发生碰撞。
|
|
30
34
|
|
|
31
35
|
**升级说明**
|
|
32
36
|
|
|
33
|
-
|
|
37
|
+
使用计划版本 3 时须重新生成 0.9.0 计划,禁止修改或升级已经冻结的旧计划。计划版本 1、2 只通过显式兼容路径读取。release-finish 是可选的本机后续动作,不构成发布证据:分支合并、Kimi 信任提示和本机宿主修改仍须用户明确同意;宿主不支持精确 ref 更新时继续转人工处理。本版不包含 Hook cache v2、安全整树盘点、Audit 离线发布记录验证器或强制的公开市场宿主调用门禁。
|
|
34
38
|
<!-- release-skill:managed:end id=latest-release -->
|
|
35
39
|
|
|
36
40
|
<!-- release-skill:capability:external-write-boundary -->
|
|
37
|
-
> **当前边界:** v0.
|
|
41
|
+
> **当前边界:** v0.9.0 只是当前源码候选。本 README 记录预期范围与验证边界,
|
|
38
42
|
> 不代表已经发布、完成消费者安装验证或通过独立验收。
|
|
39
43
|
> 版本可用性以对应发布记录及发布后验证结果为准。
|
|
40
44
|
> v0.4.1 是更早的已发布里程碑(v0.2.2 曾处于已发布状态,后因平台验证收敛修复而更新)。
|
|
@@ -50,7 +54,7 @@ release-skill 帮助维护者回答三个问题:准备发布什么、还有哪
|
|
|
50
54
|
> 远端唯一性检查在 `publish` 全局预检执行。
|
|
51
55
|
|
|
52
56
|
<!-- release-skill:capability:safe-first-command -->
|
|
53
|
-
> **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.
|
|
57
|
+
> **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.9.0 是当前源码候选,本 README 不证明该候选已经发布、完成消费者安装验证或通过独立验收。**
|
|
54
58
|
> npm 安装的 CLI 是受支持的用户入口;源码 checkout 保留为开发/贡献者路径。
|
|
55
59
|
>
|
|
56
60
|
> **第一条命令:**
|
|
@@ -616,6 +620,11 @@ release-skill ship --root "$PROJECT" --hook-approval "$HOOK_APPROVAL_PATH" --jso
|
|
|
616
620
|
|
|
617
621
|
每个适配器闭包都自带 CLI、skills 和 schemas 副本,安装后无需外部依赖即可运行。Claude/Codex 验证是自动化的;Kimi Code 和 CodeBuddy/WorkBuddy 以 `manualFollowUps` 返回并标记 `verifiedBySystem: false`,其完成情况不阻塞自动发布进入 `VERIFIED`。
|
|
618
622
|
|
|
623
|
+
发布达到 `VERIFIED` 后,可选的 `release-finish` 工作流可以按冻结市场身份更新 Claude
|
|
624
|
+
和 Codex、驱动 Kimi TUI 并复查受管安装,或确认 CodeBuddy/WorkBuddy 已经精确匹配。
|
|
625
|
+
它要求用户明确同意,不改变发布状态;由于 CodeBuddy/WorkBuddy CLI 无法钉死冻结
|
|
626
|
+
ref,不匹配时仍转人工处理。
|
|
627
|
+
|
|
619
628
|
`codebuddy-plugin` 分发可以可选地声明 `marketplace`(以及 `marketplaceSource`,即消费者添加市场所用的 URL)来覆盖默认统一市场 `artifact-skill-set`;未声明的分发保持默认值,冻结计划字节不变。
|
|
620
629
|
|
|
621
630
|
每个 npm 分发在 `prepare` 时都会针对精确封装的 tarball 静态校验
|
|
@@ -632,7 +641,7 @@ release-skill ship --root "$PROJECT" --hook-approval "$HOOK_APPROVAL_PATH" --jso
|
|
|
632
641
|
- 不声称已经替项目完成真实生产 canary,不声称已完成真实插件市场验证;
|
|
633
642
|
- `prepare --online` 只观察 bound 前序基线;目标唯一性由 publish 全局预检完成;
|
|
634
643
|
- 不覆盖已有 branch/tag/Release,不 unpublish npm;
|
|
635
|
-
-
|
|
644
|
+
- 发布状态机不提供 Kimi 或 CodeBuddy/WorkBuddy marketplace 安装检查点——可选的 release-finish 可以在本机驱动并复查 Kimi,或确认 CodeBuddy/WorkBuddy 已经精确匹配,但这些结果不构成发布证据;
|
|
636
645
|
- 不承诺 Windows 或广泛的跨平台原生写入;
|
|
637
646
|
- 不会隐藏地 commit、push、打 tag、创建 Release 或发布包。
|
|
638
647
|
|