skill-family-engineering-kit 0.8.4 → 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/CHANGELOG.md +42 -0
- package/CHANGELOG.zh-CN.md +42 -0
- package/README.md +23 -17
- package/README.zh-CN.md +23 -17
- package/candidate/adoption-mechanisms.mjs +1 -1
- package/candidate/profile-bundle.mjs +149 -15
- package/docs/agents/capability-catalog.en.json +59 -51
- package/docs/agents/capability-catalog.json +70 -21
- package/docs/agents/capability-catalog.schema.json +19 -3
- package/docs/agents/capability-catalog.zh-CN.json +59 -51
- package/docs/agents/index.html +4 -1
- package/docs/architecture/index.html +35 -5
- package/docs/en/agents/index.html +1 -0
- package/docs/en/architecture/index.html +30 -5
- package/docs/en/help/index.html +2 -1
- package/docs/en/recipes/adapter-text-closure/index.html +4 -3
- package/docs/en/recipes/host-profile-integration/index.html +31 -12
- package/docs/en/reference/compatibility/index.html +129 -124
- package/docs/en/reference/failure-and-side-effect-matrix/index.html +23 -3
- package/docs/help/index.html +2 -1
- package/docs/integration/audit/index.html +3 -1
- package/docs/integration/audit/mutation-taxonomy/index.html +1 -1
- package/docs/integration/audit/version-compatibility/index.html +4 -2
- package/docs/public/status/index.html +3 -3
- package/docs/recipes/adapter-text-closure/index.html +4 -3
- package/docs/recipes/host-profile-integration/index.html +31 -12
- package/docs/reference/api/contracts/index.html +107 -3
- package/docs/reference/api/engineering-kit/index.html +33 -20
- package/docs/reference/api/harness/index.html +158 -8
- package/docs/reference/api/index.html +1 -1
- package/docs/reference/compatibility/index.html +138 -124
- package/docs/reference/failure-and-side-effect-matrix/index.html +4 -4
- package/docs/search/search_index.json +1 -1
- package/package.json +9 -6
- package/profile-spi/extension-spi.json +1 -1
- package/release-notes/0.10.0.yaml +25 -0
- package/release-notes/0.9.0.yaml +21 -0
- package/src/host-profiles.mjs +38 -12
- package/src/host.mjs +115 -14
- package/src/index.mjs +6 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,47 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.10.0 locale=en baseline=sha256:fc575df3b8c5f7a0d819090ce9637f8cdc654c277892fe3f14149d5cc1746b24 -->
|
|
4
|
+
## [0.10.0] - 2026-08-24
|
|
5
|
+
|
|
6
|
+
Engineering Kit 0.10.0 adds responsibility-specific canonical entrypoints, a bounded host lifecycle slice, and a thin read-only peer adapter verification entry.
|
|
7
|
+
|
|
8
|
+
### Added
|
|
9
|
+
|
|
10
|
+
- Adds skill-family-engineering-kit/quickstart-profile, /adoption, and /skill-naming canonical exports.
|
|
11
|
+
- Adds finite Profile alias resolution, independent manual probe facts for non-driver hosts, and explicit local install/update plans; uninstall remains a manual-recovery refusal.
|
|
12
|
+
- Adds `verifyHostPeers` as a thin wrapper over Harness peer verification; the Kit retains four top-level commands and does not write peer directories.
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
|
|
16
|
+
- Keeps the historical Quickstart candidate export as a same-source migration alias and preserves the four-command Kit boundary.
|
|
17
|
+
- Compiles one canonical Quickstart and batch Schema set while mapping historical and canonical IDs to the same standalone validators.
|
|
18
|
+
|
|
19
|
+
### Upgrade Notes
|
|
20
|
+
|
|
21
|
+
Update all three exact pins to 0.10.0 and migrate imports and Schema IDs once to canonical identities. A later maturity-label promotion adds no separate Bundle rebuild requirement; package-identity, source-digest, and provenance changes continue to follow the existing projection contract.
|
|
22
|
+
<!-- release-skill:changelog:end version=0.10.0 locale=en -->
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
<!-- release-skill:changelog:start version=0.9.0 locale=en baseline=sha256:6419bbdc8d469e6dd7f9fda5995e5465cc6bf98724371f9f4aa9293a7e0d9f14 -->
|
|
26
|
+
## [0.9.0] - 2026-08-24
|
|
27
|
+
|
|
28
|
+
Engineering Kit 0.9.0 projects the stable filesystem schemas, bound-read Harness closure, and candidate ordered batch validation into the existing Quickstart Bundle.
|
|
29
|
+
|
|
30
|
+
### Added
|
|
31
|
+
|
|
32
|
+
- Projects the three stable filesystem schemas and two candidate batch schemas from Contracts authorities.
|
|
33
|
+
- Projects the stable bound-read entry and its exact native prebuild closure without adding a Kit command.
|
|
34
|
+
|
|
35
|
+
### Changed
|
|
36
|
+
|
|
37
|
+
- Keeps the four top-level Kit commands and Profile SPI candidate boundary unchanged.
|
|
38
|
+
|
|
39
|
+
### Upgrade Notes
|
|
40
|
+
|
|
41
|
+
Pin all three Foundation packages to exactly 0.9.0 and rebuild managed Bundles. Batch validation is available only through the existing candidate Bundle and mechanisms CLI.
|
|
42
|
+
<!-- release-skill:changelog:end version=0.9.0 locale=en -->
|
|
43
|
+
|
|
44
|
+
|
|
3
45
|
<!-- release-skill:changelog:start version=0.8.4 locale=en baseline=sha256:0f6ad4e641ae6ef85ea323e458aa6263aa6d87280e704ac1324742f83016d779 -->
|
|
4
46
|
## [0.8.4] - 2026-08-24
|
|
5
47
|
|
package/CHANGELOG.zh-CN.md
CHANGED
|
@@ -1,5 +1,47 @@
|
|
|
1
1
|
# 变更日志
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.10.0 locale=zh-CN baseline=sha256:45180b7a3b60853842cbe3a379da7ff95f1bd1fe832192368ec2c92a813279dc -->
|
|
4
|
+
## [0.10.0] - 2026-08-24
|
|
5
|
+
|
|
6
|
+
Engineering Kit 0.10.0 为历史 candidate 提供职责明确的规范入口,增加受限的跨平台宿主身份、探针和本地生命周期能力,并提供同级适配器只读验证薄入口。
|
|
7
|
+
|
|
8
|
+
### 新增
|
|
9
|
+
|
|
10
|
+
- 新增 skill-family-engineering-kit/quickstart-profile、/adoption 与 /skill-naming 规范导出。
|
|
11
|
+
- 增加有限 Profile alias 解析、非 driver 宿主的独立手动 probe fact 和显式本地 install/update 计划;uninstall 仍要求人工恢复。
|
|
12
|
+
- 新增 `verifyHostPeers`,只包装 Harness 的 peer 验证,不增加第五个顶层命令,也不写入 peer 目录。
|
|
13
|
+
|
|
14
|
+
### 变更
|
|
15
|
+
|
|
16
|
+
- 历史 Quickstart candidate 导出继续作为同源迁移别名,Kit 四命令边界不变。
|
|
17
|
+
- 只编译一套规范 Quickstart 与批量校验 Schema;历史和规范 ID 指向同一 standalone validator。
|
|
18
|
+
|
|
19
|
+
### 升级说明
|
|
20
|
+
|
|
21
|
+
消费者应把三个包的精确 pin 更新到 0.10.0,并把导入与 Schema ID 一次迁移到规范身份。以后仅晋升成熟度标签时不另加 Bundle 重建要求;包身份、来源摘要或 provenance 变化仍按既有投影合同处理。
|
|
22
|
+
<!-- release-skill:changelog:end version=0.10.0 locale=zh-CN -->
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
<!-- release-skill:changelog:start version=0.9.0 locale=zh-CN baseline=sha256:c84db7b53f562cbdad947ccf8fcc23209f18137100270b2691bab7d9a7ad623c -->
|
|
26
|
+
## [0.9.0] - 2026-08-24
|
|
27
|
+
|
|
28
|
+
Engineering Kit 0.9.0 将稳定文件系统 Schema、绑定读取 Harness 闭包与有序批量校验 candidate 投影到既有 Quickstart Bundle。
|
|
29
|
+
|
|
30
|
+
### 新增
|
|
31
|
+
|
|
32
|
+
- 从 Contracts 权威源投影三个稳定文件系统 Schema 与两个批量校验 candidate Schema。
|
|
33
|
+
- 投影稳定绑定读取入口及其精确原生预构建闭包,不新增 Kit 命令。
|
|
34
|
+
|
|
35
|
+
### 变更
|
|
36
|
+
|
|
37
|
+
- 四个顶层 Kit 命令与 Profile SPI 的 candidate 边界保持不变。
|
|
38
|
+
|
|
39
|
+
### 升级说明
|
|
40
|
+
|
|
41
|
+
三个 Foundation 包必须精确锁定 0.9.0 并重新构建 managed Bundle;批量校验只能通过既有 candidate Bundle 与 mechanisms CLI 使用。
|
|
42
|
+
<!-- release-skill:changelog:end version=0.9.0 locale=zh-CN -->
|
|
43
|
+
|
|
44
|
+
|
|
3
45
|
<!-- release-skill:changelog:start version=0.8.4 locale=zh-CN baseline=sha256:38a973bb735c925e8453656ce24a11173b530c6376609d68dfb850d9029daa21 -->
|
|
4
46
|
## [0.8.4] - 2026-08-24
|
|
5
47
|
|
package/README.md
CHANGED
|
@@ -4,24 +4,29 @@
|
|
|
4
4
|
|
|
5
5
|
# skill-family-engineering-kit
|
|
6
6
|
|
|
7
|
-
<!-- release-skill:release-version: 0.
|
|
7
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
8
8
|
|
|
9
9
|
An engineering toolkit used in development and CI. There are **exactly four** top-level commands, and no fifth:
|
|
10
10
|
|
|
11
11
|
<!-- release-skill:managed:start id=latest-release -->
|
|
12
|
-
**0.
|
|
12
|
+
**0.10.0** (2026-08-24)
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
Engineering Kit 0.10.0 adds responsibility-specific canonical entrypoints, a bounded host lifecycle slice, and a thin read-only peer adapter verification entry.
|
|
15
|
+
|
|
16
|
+
**Added**
|
|
17
|
+
|
|
18
|
+
- Adds skill-family-engineering-kit/quickstart-profile, /adoption, and /skill-naming canonical exports.
|
|
19
|
+
- Adds finite Profile alias resolution, independent manual probe facts for non-driver hosts, and explicit local install/update plans; uninstall remains a manual-recovery refusal.
|
|
20
|
+
- Adds `verifyHostPeers` as a thin wrapper over Harness peer verification; the Kit retains four top-level commands and does not write peer directories.
|
|
15
21
|
|
|
16
22
|
**Changed**
|
|
17
23
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
- Keeps the four stable top-level Kit commands, builder, Profile SPI, and public exports unchanged.
|
|
24
|
+
- Keeps the historical Quickstart candidate export as a same-source migration alias and preserves the four-command Kit boundary.
|
|
25
|
+
- Compiles one canonical Quickstart and batch Schema set while mapping historical and canonical IDs to the same standalone validators.
|
|
21
26
|
|
|
22
27
|
**Upgrade Notes**
|
|
23
28
|
|
|
24
|
-
|
|
29
|
+
Update all three exact pins to 0.10.0 and migrate imports and Schema IDs once to canonical identities. A later maturity-label promotion adds no separate Bundle rebuild requirement; package-identity, source-digest, and provenance changes continue to follow the existing projection contract.
|
|
25
30
|
<!-- release-skill:managed:end id=latest-release -->
|
|
26
31
|
|
|
27
32
|
| Command | Purpose | Side effects |
|
|
@@ -42,7 +47,7 @@ Kit is the "engineering stage" layer, depending on the Harness and Contracts. It
|
|
|
42
47
|
## Installation and Minimal Example
|
|
43
48
|
|
|
44
49
|
```sh
|
|
45
|
-
npm install --save-dev skill-family-engineering-kit@0.
|
|
50
|
+
npm install --save-dev skill-family-engineering-kit@0.10.0
|
|
46
51
|
npm exec -- skill-family-kit --help
|
|
47
52
|
npm exec -- skill-family-kit scaffold --root <empty-dir> --project-id my-project
|
|
48
53
|
npm exec -- skill-family-kit adopt-plan --root <repo>
|
|
@@ -50,7 +55,7 @@ npm exec -- skill-family-kit projection --root <repo>
|
|
|
50
55
|
npm exec -- skill-family-kit check --root <repo>
|
|
51
56
|
```
|
|
52
57
|
|
|
53
|
-
The four commands above cover skeleton generation, read-only inventory, managed projection, and diagnostics respectively; a zero-install form is available via `npm exec --package=skill-family-engineering-kit@0.
|
|
58
|
+
The four commands above cover skeleton generation, read-only inventory, managed projection, and diagnostics respectively; a zero-install form is available via `npm exec --package=skill-family-engineering-kit@0.10.0 -- skill-family-kit --help`.
|
|
54
59
|
|
|
55
60
|
### Public Profile SPI
|
|
56
61
|
|
|
@@ -60,7 +65,7 @@ The package carries three SPI JSON resources and the Contracts canonical `profil
|
|
|
60
65
|
|
|
61
66
|
`verifyProfile({ profileRoot })` is read-only and data-only for Profile descriptors. `verifyProjectProfile({ projectRoot, profileRelPath? })` is the corresponding entry for a project root declaration. Both refuse invalid input with stable result codes, never execute Profile-provided files, and leave Profile domain meaning to the caller.
|
|
62
67
|
|
|
63
|
-
When a provider Profile descriptor moves from Foundation 0.
|
|
68
|
+
When a provider Profile descriptor moves from Foundation 0.9.0 and Contracts 1.9.0 to Foundation 0.10.0, update its `base.contractsVersion` field mechanically to `1.10.0`. The four Kit commands and Profile SPI retain their existing shapes.
|
|
64
69
|
|
|
65
70
|
### Report sub-action
|
|
66
71
|
|
|
@@ -80,7 +85,7 @@ import { parseSourceAuthorityReceipt } from "skill-family-contracts";
|
|
|
80
85
|
import {
|
|
81
86
|
buildQuickstartProfileProjection,
|
|
82
87
|
QUICKSTART_PROFILE_TARGET_PREFIX,
|
|
83
|
-
} from "skill-family-engineering-kit/
|
|
88
|
+
} from "skill-family-engineering-kit/quickstart-profile";
|
|
84
89
|
|
|
85
90
|
const authority = parseSourceAuthorityReceipt(receipt, actualSubjects);
|
|
86
91
|
if (!authority.valid) throw new Error(authority.errorCode);
|
|
@@ -93,7 +98,7 @@ const projection = await buildQuickstartProfileProjection({
|
|
|
93
98
|
|
|
94
99
|
The caller obtains `receipt` and `actualSubjects` outside Kit. Contracts validates their exact binding before the existing builder receives `sourceRepository` and `sourceBaseCommit`; Kit does not parse release plans or discover source authority. The generated Bundle selects standalone validators by schema `$id` and runs offline without Foundation packages, `node_modules`, or runtime Ajv. Its provenance binds Foundation sources, consumer schemas, payload bytes, tool versions, and the licenses of code that actually enters the Bundle.
|
|
95
100
|
|
|
96
|
-
Pass the returned `manifest` to the stable `runProjection` API; the helper does not write files or add a fifth top-level command.
|
|
101
|
+
Pass the returned `manifest` to the stable `runProjection` API; the helper does not write files or add a fifth top-level command. The capability remains **candidate**, so pin all three packages exactly. Version 0.10.0 adds the canonical path above; the historical `/candidate/quickstart-profile` path remains a same-source migration alias. Adoption and skill naming now also have the canonical `skill-family-engineering-kit/adoption` and `skill-family-engineering-kit/skill-naming` paths. A later stable promotion will not require a second migration. Integrations that still require the v1 dependency-closure Bundle must stay pinned to exactly `0.2.1`.
|
|
97
102
|
|
|
98
103
|
### Host sub-action
|
|
99
104
|
|
|
@@ -104,7 +109,7 @@ npm exec -- skill-family-kit scaffold host-build --root <workspace> --host <id>
|
|
|
104
109
|
npm exec -- skill-family-kit adopt-plan host-plan --root <workspace> --host <id> --path-category <id> --build-manifest <relpath> --probe-facts <relpath> --hosts-root <dir>
|
|
105
110
|
```
|
|
106
111
|
|
|
107
|
-
The Profile must be provided explicitly; Kit does not bind a specific host by default. Probe starts no process by default; only when both `--allow-host-spawn --host-executable <absolute-path>` are given is the frozen version vector executed.
|
|
112
|
+
The Profile must be provided explicitly; Kit does not bind a specific host by default. Canonical host IDs may resolve only aliases declared by the finite registered Profile set. Probe starts no process by default; only when both `--allow-host-spawn --host-executable <absolute-path>` are given is the frozen version vector executed. Local install and update use an explicit authorization reference plus the existing contained publication primitives; uninstall is rejected with `manual-recovery-required` because Foundation has no safe bound deletion primitive. Two registered hosts have trusted version drivers; Kimi Code, WorkBuddy, CodeBuddy, and DeepSeek Harness expose independent manual facts; Qoder is `unsupported`. Adapter source only accepts declared text closures; binary projection is not supported; see the [host capability matrix](../../docs/reference/host-capability-matrix.md) and registered Profiles.
|
|
108
113
|
|
|
109
114
|
## Typical Use Cases
|
|
110
115
|
|
|
@@ -166,7 +171,7 @@ This package must not perform git init, commit, push, tag, stash, branch switch,
|
|
|
166
171
|
### Do not use when
|
|
167
172
|
|
|
168
173
|
- You need auto-fix (`check` does not fix), or auto-migration (`adopt-plan` writes no files).
|
|
169
|
-
- You need host
|
|
174
|
+
- You need remote host publication, automatic trust confirmation, uninstall deletion, or a full Qoder driver (explicitly unsupported).
|
|
170
175
|
- You need a stable Quickstart API or expect the candidate helper to bypass `runProjection` authorization.
|
|
171
176
|
|
|
172
177
|
### Capability selection
|
|
@@ -177,7 +182,8 @@ This package must not perform git init, commit, push, tag, stash, branch switch,
|
|
|
177
182
|
- `foundation.kit.check`: nine check classes, diagnosis only, no fix.
|
|
178
183
|
- `foundation.kit.report`: projection/check report sub-action orchestration.
|
|
179
184
|
- `foundation.kit.git-probe`: read-only whitelisted Git status probe.
|
|
180
|
-
- `foundation.kit.host`: describe/build/probe/plan, apply
|
|
185
|
+
- `foundation.kit.host`: describe/build/probe/plan plus authorized, digest-bound local install/update through `applyHostPlan`; Kit CLI apply, generic or remote apply, and deleting uninstall remain rejected.
|
|
186
|
+
- `verifyHostPeers` is a thin read-only host entry over Harness peer adapter verification; it does not write peer directories or add a fifth command.
|
|
181
187
|
- `foundation.kit.licensing`: Profile authorization-data loading and generation.
|
|
182
188
|
- `foundation.kit.identity-check`: identity-drift and Profile-consistency checks.
|
|
183
189
|
- `foundation.kit.cli`: four-command dispatch and mutation-flag entry rejection.
|
|
@@ -212,12 +218,12 @@ This package must not perform git init, commit, push, tag, stash, branch switch,
|
|
|
212
218
|
### Route elsewhere when
|
|
213
219
|
|
|
214
220
|
- Remote publish: route to release-skill.
|
|
215
|
-
- host
|
|
221
|
+
- remote host publication, automatic trust confirmation, and uninstall deletion: explicitly unsupported; local install/update are limited to the registered plan API.
|
|
216
222
|
- Business state machine / migration execution: stays with the caller or a later version.
|
|
217
223
|
|
|
218
224
|
### Machine-readable sources
|
|
219
225
|
|
|
220
226
|
- Public capability catalog: [`capability-catalog.json`](https://ifoohoo.github.io/skill-family-engineering-kit/agents/capability-catalog.json) (`foundation.kit.*` entries).
|
|
221
227
|
- Package-local source: `src/*.mjs`.
|
|
222
|
-
- Package-local candidate source: `candidate/*`; public
|
|
228
|
+
- Package-local candidate source: `candidate/*`; canonical public imports: `skill-family-engineering-kit/quickstart-profile`, `/adoption`, and `/skill-naming`; historical migration alias: `skill-family-engineering-kit/candidate/quickstart-profile`.
|
|
223
229
|
<!-- agent-quick-reference:end -->
|
package/README.zh-CN.md
CHANGED
|
@@ -5,24 +5,29 @@
|
|
|
5
5
|
|
|
6
6
|
# skill-family-engineering-kit
|
|
7
7
|
|
|
8
|
-
<!-- release-skill:release-version: 0.
|
|
8
|
+
<!-- release-skill:release-version: 0.10.0 -->
|
|
9
9
|
|
|
10
10
|
开发与 CI 阶段使用的工程工具包。**恰好四个**顶层命令,没有第五个:
|
|
11
11
|
|
|
12
12
|
<!-- release-skill:managed:start id=latest-release -->
|
|
13
|
-
**0.
|
|
13
|
+
**0.10.0** (2026-08-24)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
Engineering Kit 0.10.0 为历史 candidate 提供职责明确的规范入口,增加受限的跨平台宿主身份、探针和本地生命周期能力,并提供同级适配器只读验证薄入口。
|
|
16
|
+
|
|
17
|
+
**新增**
|
|
18
|
+
|
|
19
|
+
- 新增 skill-family-engineering-kit/quickstart-profile、/adoption 与 /skill-naming 规范导出。
|
|
20
|
+
- 增加有限 Profile alias 解析、非 driver 宿主的独立手动 probe fact 和显式本地 install/update 计划;uninstall 仍要求人工恢复。
|
|
21
|
+
- 新增 `verifyHostPeers`,只包装 Harness 的 peer 验证,不增加第五个顶层命令,也不写入 peer 目录。
|
|
16
22
|
|
|
17
23
|
**变更**
|
|
18
24
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- 四个稳定顶层命令、builder、Profile SPI 与公共导出保持不变。
|
|
25
|
+
- 历史 Quickstart candidate 导出继续作为同源迁移别名,Kit 四命令边界不变。
|
|
26
|
+
- 只编译一套规范 Quickstart 与批量校验 Schema;历史和规范 ID 指向同一 standalone validator。
|
|
22
27
|
|
|
23
28
|
**升级说明**
|
|
24
29
|
|
|
25
|
-
|
|
30
|
+
消费者应把三个包的精确 pin 更新到 0.10.0,并把导入与 Schema ID 一次迁移到规范身份。以后仅晋升成熟度标签时不另加 Bundle 重建要求;包身份、来源摘要或 provenance 变化仍按既有投影合同处理。
|
|
26
31
|
<!-- release-skill:managed:end id=latest-release -->
|
|
27
32
|
|
|
28
33
|
| 命令 | 用途 | 副作用 |
|
|
@@ -43,7 +48,7 @@ Kit 是「工程阶段」层,依赖 Harness 与 Contracts。它只做四件事
|
|
|
43
48
|
## 安装和最小示例
|
|
44
49
|
|
|
45
50
|
```sh
|
|
46
|
-
npm install --save-dev skill-family-engineering-kit@0.
|
|
51
|
+
npm install --save-dev skill-family-engineering-kit@0.10.0
|
|
47
52
|
npm exec -- skill-family-kit --help
|
|
48
53
|
npm exec -- skill-family-kit scaffold --root <empty-dir> --project-id my-project
|
|
49
54
|
npm exec -- skill-family-kit adopt-plan --root <repo>
|
|
@@ -51,7 +56,7 @@ npm exec -- skill-family-kit projection --root <repo>
|
|
|
51
56
|
npm exec -- skill-family-kit check --root <repo>
|
|
52
57
|
```
|
|
53
58
|
|
|
54
|
-
以上四条命令分别覆盖生成骨架、只读盘点、受管投影与诊断;零安装形式可用 `npm exec --package=skill-family-engineering-kit@0.
|
|
59
|
+
以上四条命令分别覆盖生成骨架、只读盘点、受管投影与诊断;零安装形式可用 `npm exec --package=skill-family-engineering-kit@0.10.0 -- skill-family-kit --help`。
|
|
55
60
|
|
|
56
61
|
### 公共 Profile SPI
|
|
57
62
|
|
|
@@ -61,7 +66,7 @@ npm exec -- skill-family-kit check --root <repo>
|
|
|
61
66
|
|
|
62
67
|
`verifyProfile({ profileRoot })` 只读处理 Profile descriptor;项目根声明使用对应的 `verifyProjectProfile({ projectRoot, profileRelPath? })`。两个入口遇到无效输入都以稳定结果码失败关闭,不会执行 Profile 提供的文件;Profile 的领域含义仍由调用方负责。
|
|
63
68
|
|
|
64
|
-
provider Profile descriptor 从 Foundation 0.
|
|
69
|
+
provider Profile descriptor 从 Foundation 0.9.0 与 Contracts 1.9.0 升级到 Foundation 0.10.0 时,须把自身的 `base.contractsVersion` 字段更新为 `1.10.0`。Kit 四个顶层命令与 Profile SPI 的形状保持不变。
|
|
65
70
|
|
|
66
71
|
### 报告子动作
|
|
67
72
|
|
|
@@ -81,7 +86,7 @@ import { parseSourceAuthorityReceipt } from "skill-family-contracts";
|
|
|
81
86
|
import {
|
|
82
87
|
buildQuickstartProfileProjection,
|
|
83
88
|
QUICKSTART_PROFILE_TARGET_PREFIX,
|
|
84
|
-
} from "skill-family-engineering-kit/
|
|
89
|
+
} from "skill-family-engineering-kit/quickstart-profile";
|
|
85
90
|
|
|
86
91
|
const authority = parseSourceAuthorityReceipt(receipt, actualSubjects);
|
|
87
92
|
if (!authority.valid) throw new Error(authority.errorCode);
|
|
@@ -94,7 +99,7 @@ const projection = await buildQuickstartProfileProjection({
|
|
|
94
99
|
|
|
95
100
|
`receipt` 与 `actualSubjects` 由调用方在 Kit 外取得。Contracts 先精确核对两者,既有 builder 再接收返回的 `sourceRepository` 与 `sourceBaseCommit`;Kit 不解析发布计划,也不发现来源权威。生成的 Bundle 按 Schema `$id` 选择 standalone validator,离线运行时不依赖 Foundation 包、`node_modules` 或 Ajv。provenance 绑定 Foundation 来源、消费者 Schema、payload 字节、工具版本,以及实际进入 Bundle 的代码许可证。
|
|
96
101
|
|
|
97
|
-
以上辅助函数不写文件,也不增加第五个顶层命令。调用方需要把返回的 `manifest` 交给稳定的 `runProjection` API
|
|
102
|
+
以上辅助函数不写文件,也不增加第五个顶层命令。调用方需要把返回的 `manifest` 交给稳定的 `runProjection` API。该能力仍是 **candidate**,必须精确锁定三个包。0.10.0 新增上面的规范入口;历史 `/candidate/quickstart-profile` 入口作为同源迁移别名继续可用。adoption 与 skill naming 也分别提供 `skill-family-engineering-kit/adoption` 和 `skill-family-engineering-kit/skill-naming` 规范入口。消费者迁移一次后,未来晋升 stable 不再二次迁移。仍依赖 v1 依赖闭包 Bundle 的接入必须继续精确锁定 `0.2.1`。
|
|
98
103
|
|
|
99
104
|
### 宿主子动作
|
|
100
105
|
|
|
@@ -105,7 +110,7 @@ npm exec -- skill-family-kit scaffold host-build --root <workspace> --host <id>
|
|
|
105
110
|
npm exec -- skill-family-kit adopt-plan host-plan --root <workspace> --host <id> --path-category <id> --build-manifest <relpath> --probe-facts <relpath> --hosts-root <dir>
|
|
106
111
|
```
|
|
107
112
|
|
|
108
|
-
Profile 必须显式提供,Kit
|
|
113
|
+
Profile 必须显式提供,Kit 不默认绑定具体宿主。规范宿主 ID 只能解析已登记有限 Profile 中声明的 alias。probe 默认不启动进程;只有同时给出 `--allow-host-spawn --host-executable <绝对路径>` 才执行冻结版本向量。本地 install/update 通过显式授权引用和既有受收容发布原语执行;uninstall 因没有安全的绑定删除原语而返回 `manual-recovery-required`,不删除文件。Claude/Codex 使用受信版本 driver;Kimi Code、WorkBuddy、CodeBuddy 和 DeepSeek Harness 只提供独立手动事实;Qoder 为 `unsupported`。adapter source 只接受已声明的文本闭包,不支持二进制投影;精确宿主支持矩阵见 [宿主能力矩阵](../../docs/reference/host-capability-matrix.md) 与已登记 Profile。
|
|
109
114
|
|
|
110
115
|
## 典型使用场景
|
|
111
116
|
|
|
@@ -167,7 +172,7 @@ projection 只写同时满足两个条件的路径:manifest 列出,且目标
|
|
|
167
172
|
### Do not use when
|
|
168
173
|
|
|
169
174
|
- 需要自动修复(`check` 不修复)、自动迁移(`adopt-plan` 不写文件)。
|
|
170
|
-
-
|
|
175
|
+
- 需要远端宿主发布、自动信任、删除式 uninstall 或 Qoder 完整 driver(明确 unsupported)。
|
|
171
176
|
- 需要稳定 Quickstart API,或希望 candidate 辅助函数绕过 `runProjection` 授权。
|
|
172
177
|
|
|
173
178
|
### Capability selection
|
|
@@ -178,7 +183,8 @@ projection 只写同时满足两个条件的路径:manifest 列出,且目标
|
|
|
178
183
|
- `foundation.kit.check`:九类检查只诊断不修复。
|
|
179
184
|
- `foundation.kit.report`:projection/check report 子动作编排。
|
|
180
185
|
- `foundation.kit.git-probe`:只读白名单 Git 状态探测。
|
|
181
|
-
- `foundation.kit.host
|
|
186
|
+
- `foundation.kit.host`:有限身份解析、describe/build/probe/plan,以及受授权的本地 install/update;删除式 uninstall 和远端 apply 稳定拒绝。
|
|
187
|
+
- `verifyHostPeers` 是 Harness 同级适配器验证的薄只读宿主入口,不写入 peer 目录,也不增加第五个顶层命令。
|
|
182
188
|
- `foundation.kit.licensing`:Profile 授权数据加载与生成。
|
|
183
189
|
- `foundation.kit.identity-check`:身份漂移与 Profile 一致性检查。
|
|
184
190
|
- `foundation.kit.cli`:四命令分派与变更旗标入口拒绝。
|
|
@@ -213,12 +219,12 @@ projection 只写同时满足两个条件的路径:manifest 列出,且目标
|
|
|
213
219
|
### Route elsewhere when
|
|
214
220
|
|
|
215
221
|
- 远端发布:转 release-skill。
|
|
216
|
-
- host apply
|
|
222
|
+
- 远端 host apply、自动信任与删除式 uninstall:明确 unsupported;本地 install/update 仅限已登记计划。
|
|
217
223
|
- 业务状态机/迁移执行:留在调用方或后续版本。
|
|
218
224
|
|
|
219
225
|
### Machine-readable sources
|
|
220
226
|
|
|
221
227
|
- 公开能力目录:[`capability-catalog.json`](https://ifoohoo.github.io/skill-family-engineering-kit/agents/capability-catalog.json)(`foundation.kit.*` 条目)。
|
|
222
228
|
- 包内源:`src/*.mjs`。
|
|
223
|
-
- 包内 Candidate 源:`candidate
|
|
229
|
+
- 包内 Candidate 源:`candidate/*`;规范公共导入:`skill-family-engineering-kit/quickstart-profile`、`/adoption` 与 `/skill-naming`;历史迁移别名:`skill-family-engineering-kit/candidate/quickstart-profile`。
|
|
224
230
|
<!-- agent-quick-reference:end -->
|