diff --git a/CATALOG.md b/CATALOG.md index 48b8d2b..5e3204c 100644 --- a/CATALOG.md +++ b/CATALOG.md @@ -12,8 +12,8 @@ of what is installed on a particular Agent host. | --- | --- | | Collection | Personal Skills Collection | | Package count | 5 admitted first-party Skills | -| Current state | Release candidate v0.1.1 — release gate pending; v0.1.0 remains the current stable release | -| Stable release | [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0) | +| Current state | Released v0.1.1; independent `review-loop agent-skill` acceptance remains BLOCKED | +| Stable release | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) | | Installation authority | [docs/INSTALLATION.md](docs/INSTALLATION.md) | | Discovery check | [tests/collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) | | Evidence | [v0.1.1 release evidence](docs/evidence/releases/v0.1.1/) | diff --git a/CATALOG.zh-CN.md b/CATALOG.zh-CN.md index 669381b..3d32e80 100644 --- a/CATALOG.zh-CN.md +++ b/CATALOG.zh-CN.md @@ -10,8 +10,8 @@ | --- | --- | | 集合 | Personal Skills Collection | | 包数量 | 5 个第一方 Skill | -| 当前状态 | Release candidate v0.1.1 — release gate 待通过;v0.1.0 仍是当前稳定版本 | -| 稳定版本 | [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0) | +| 当前状态 | v0.1.1 已发布;独立 `review-loop agent-skill` acceptance 仍为 BLOCKED | +| 稳定版本 | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) | | 安装权威 | [docs/INSTALLATION.zh-CN.md](docs/INSTALLATION.zh-CN.md) | | 发现检查 | [collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) | | 证据 | [v0.1.1 release evidence](docs/evidence/releases/v0.1.1/) | diff --git a/CHANGELOG.md b/CHANGELOG.md index 8f35dd7..1c3ac9f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,13 +6,13 @@ All notable changes are recorded here. A release entry must be tied to an actual version or tag and must not be created merely because a document was drafted. -## Unreleased — target v0.1.1 (2026-07-26) +## 0.1.1 — 2026-07-26 ### Added - Bilingual user guides for all five first-party Skills, validated workflow recipes, and a runnable-sized Quick Start example. -- A release-candidate evidence tree under +- A release evidence tree under `docs/evidence/releases/v0.1.1/` and CI checks for structure, metadata, links, bilingual pairs, package tests, retired references, and header assets. - Explicit `$ask-light next` and `$ask-light workflow` modes with bounded @@ -28,13 +28,18 @@ drafted. the CLI's default revision, while `#v0.1.1` will pin the target tag once published. -### Release-candidate evidence +### Release evidence -- Release tag/release: `NOT TESTED` until the release gate passes. +- Release tag: `v0.1.1`, commit `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`. +- GitHub Actions `collection-quality`: `PASS` on the merged release commit. +- Fresh whole-collection and per-Skill installs: `PASS` with CLI `1.5.20`. +- GitHub release: https://github.com/LightDevCoder/skills/releases/tag/v0.1.1 - Whole-collection and per-Skill fresh-install target evidence: [INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md). - Structural and package evidence: [TEST_SUMMARY.md](docs/evidence/releases/v0.1.1/TEST_SUMMARY.md). +- Independent `review-loop agent-skill` acceptance remains `BLOCKED`; see + [release receipt](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md). ## 0.1.0 — 2026-07-23 @@ -44,7 +49,7 @@ drafted. - Stable tag: v0.1.0. - The v0.1.0 whole-collection and per-Skill installer commands were verified against a fresh destination and the published package content; this - historical evidence is retained while v0.1.1 remains a release candidate. + historical evidence is retained alongside the v0.1.1 release. - Historical commands: `npx skills add LightDevCoder/skills` and `npx skills add LightDevCoder/skills --skill review-loop`. - Historical installation details: diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md index 7a2242e..5aec210 100644 --- a/CHANGELOG.zh-CN.md +++ b/CHANGELOG.zh-CN.md @@ -4,12 +4,12 @@ 所有变更都必须记录在实际版本/tag 对应的条目中,不能因为文档已起草就提前宣称 release。 -## Unreleased — target v0.1.1(2026-07-26) +## 0.1.1 — 2026-07-26 ### 新增 - 五个第一方 Skill 的双语用户指南、已验证的 workflow recipes 和可运行大小的 Quick Start 示例。 -- `docs/evidence/releases/v0.1.1/` release candidate 证据目录,以及覆盖结构、metadata、链接、双语配对、包测试、退休引用和头图的 CI 检查。 +- `docs/evidence/releases/v0.1.1/` release 证据目录,以及覆盖结构、metadata、链接、双语配对、包测试、退休引用和头图的 CI 检查。 - 显式 `$ask-light next` 与 `$ask-light workflow` 模式,包含 bounded recipe、availability gap、handoff 字段和不执行测试。 - 可编辑 SVG 与 1600 × 480 PNG 头图:平面叠层的 `LightDevCoder` / `/skills` wordmark 和 serif slogan。 @@ -18,18 +18,22 @@ - 为 user-invoked 的 `learn-anything`、`ask-light`、`project-init` 补齐 `policy.allow_implicit_invocation: false` 及对应 frontmatter。 - 修正安装语义:无 fragment 的仓库来源遵循 CLI 默认 revision,发布后 `#v0.1.1` 才是固定 target tag。 -### Release candidate 证据 +### Release 证据 -- Release tag/release:`NOT TESTED`,等待 release gate。 +- Release tag:`v0.1.1`,commit `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`。 +- 合并后的 release commit 上 GitHub Actions `collection-quality`:`PASS`。 +- 整仓和单 Skill fresh install:使用 CLI `1.5.20`,均为 `PASS`。 +- GitHub release:https://github.com/LightDevCoder/skills/releases/tag/v0.1.1 - 整仓与单 Skill fresh-install 目标记录:[INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 - 结构与包测试证据:[TEST_SUMMARY.md](docs/evidence/releases/v0.1.1/TEST_SUMMARY.md)。 +- 独立 `review-loop agent-skill` acceptance 仍为 `BLOCKED`;见[发布收据](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md)。 ## 0.1.0 — 2026-07-23 - 建立第一方治理基础并准入五个第一方 Skill。 - 已发布于 https://github.com/LightDevCoder/skills。 - 稳定 tag:v0.1.0。 -- v0.1.0 的整集合与单 Skill 安装命令曾针对 fresh destination 和已发布包内容完成验证;这份历史证据予以保留,v0.1.1 仍是 release candidate。 +- v0.1.0 的整集合与单 Skill 安装命令曾针对 fresh destination 和已发布包内容完成验证;这份历史证据与 v0.1.1 release 证据一并保留。 - 历史命令:`npx skills add LightDevCoder/skills` 和 `npx skills add LightDevCoder/skills --skill review-loop`。 - 历史安装明细:[v0.1.0 摘要](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md#历史-v0.1.0-摘要)。 diff --git a/README.md b/README.md index efb260d..6bdfb25 100644 --- a/README.md +++ b/README.md @@ -10,26 +10,25 @@ invocation boundary, and small enough to inspect before use. > **About:** Personal Skills Collection — Drive your creativity -> **Release candidate:** v0.1.1 is prepared in this worktree. The release -> record and fresh-install evidence live in -> [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/); promotion -> remains subject to the recorded release gates. +> **Release:** [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) +> is published from commit `c50f1ef`. The release record and fresh-install evidence +> live in [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/). > -> The current published stable release remains [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0). +> Independent `review-loop agent-skill` acceptance remains `BLOCKED`; see the +> receipt for the exact boundary. ## Quick Start -Install the whole first-party collection at the target revision after the -release gate passes: +Install the published first-party collection: ```text -npx skills add LightDevCoder/skills#v0.1.1 +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex ``` -Install one Skill at the same target revision after the release gate passes: +Install one Skill at the same published revision: ```text -npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop +npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex ``` Refresh the Agent host, then confirm that the package is visible in its Skill diff --git a/README.zh-CN.md b/README.zh-CN.md index 7caab9a..f611c6a 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -8,22 +8,24 @@ > **About:** Personal Skills Collection — Drive your creativity -> **Release candidate:** 当前工作树准备的是 v0.1.1。发布记录和 fresh-install 证据见 [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/),promotion 仍受其中 release gate 约束。 +> **Release:** [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) +> 已从 commit `c50f1ef` 发布。发布记录和 fresh-install 证据见 +> [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/)。 > -> 当前已发布的稳定版本仍是 [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0)。 +> 独立 `review-loop agent-skill` acceptance 仍为 `BLOCKED`;准确边界见发布收据。 ## Quick Start -release gate 通过后,安装目标版本的整个第一方集合: +安装已发布的第一方集合: ```text -npx skills add LightDevCoder/skills#v0.1.1 +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex ``` -release gate 通过后,只安装同一目标版本下的一个 Skill: +安装同一已发布版本下的一个 Skill: ```text -npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop +npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex ``` 刷新 Agent host,然后在其 Skill catalog 中确认发现结果。若 host 提供文件系统,检查已安装包的 `SKILL.md` 与 `agents/openai.yaml`;脱离 source checkout 后仍能发现,才是有意义的验证。CLI 版本、destination 和结果见 [INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index 5147fee..58b1177 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -3,10 +3,9 @@ [中文安装说明](INSTALLATION.zh-CN.md) The public first-party collection's current stable release is -[v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0). The -working tree also prepares v0.1.1 as a release candidate; its tag and -fresh-install proof are still release-gate evidence. Until those are recorded, -the v0.1.1 commands below are targets rather than verified installation claims. +[v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1), commit +`c50f1ef403a5f0bfe02e75d1aeff2c237556db63`. Fresh-install evidence for the +published tag is recorded in the [release evidence](evidence/releases/v0.1.1/). Package contracts remain inside `skills//`; this document is the installation authority and does not replace host-specific discovery rules. @@ -21,7 +20,7 @@ and [Git helper](https://raw.githubusercontent.com/vercel-labs/skills/main/src/g ## Historical v0.1.0 verification -The current stable release is the published v0.1.0 snapshot at commit +The historical stable release was the published v0.1.0 snapshot at commit `fb36fc2dad39ee94ad4aa25a5fee3c87c54f05f2`. The following unqualified commands are retained as historical commands from that published release. The summarized CLI, host, destination, validator, and known evidence limits are @@ -38,18 +37,18 @@ receipt did not record them. That historical verification does not change the CLI revision semantics: an unqualified source follows the repository's default revision and is not a -permanent v0.1.0 pin. The v0.1.1 candidate commands below use an explicit tag. +permanent v0.1.0 pin. The published v0.1.1 commands below use an explicit tag. The target release commands are: ```text -npx skills add LightDevCoder/skills#v0.1.1 -npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex +npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex ``` -After the release gate passes, the first installs the five-package collection -and the second selects one complete package at the same tag. Always record the actual CLI version, host, -destination, discovery result, and smoke result; see the +The first installs the five-package collection and the second selects one +complete package at the same tag. The verified CLI version, destination class, +discovery result, and smoke result are recorded in the [v0.1.1 installation record](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md). ## Supported installation scopes diff --git a/docs/INSTALLATION.zh-CN.md b/docs/INSTALLATION.zh-CN.md index 61dcd1a..c648f03 100644 --- a/docs/INSTALLATION.zh-CN.md +++ b/docs/INSTALLATION.zh-CN.md @@ -2,7 +2,7 @@ [English installation guide](INSTALLATION.md) -公开第一方集合当前稳定版本是 [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0)。当前工作树同时准备 v0.1.1 release candidate;其 tag 和 fresh-install proof 仍属于 release gate。在证据写入前,下列 v0.1.1 命令只是目标,不是已验证的安装声明。`skills//` 内的包契约仍是行为权威;本页只规定安装和验证证据。 +公开第一方集合当前稳定版本是 [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1),commit 为 `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`。已发布 tag 的 fresh-install 证据见[release evidence](evidence/releases/v0.1.1/)。`skills//` 内的包契约仍是行为权威;本页只规定安装和验证证据。 ## Revision 语义 @@ -21,16 +21,16 @@ npx skills add LightDevCoder/skills --skill review-loop 该历史记录是整理摘要,不是当前重跑;原始 receipt 未记录的 boundary/missing-dependency smoke 和重复安装行为会明确标为 `NOT RECORDED`。 -这份历史验证不改变 CLI 的 revision 语义:无 fragment source 遵循仓库默认 revision,并不是永久固定到 v0.1.0。下面的 v0.1.1 candidate 命令使用显式 tag。 +这份历史验证不改变 CLI 的 revision 语义:无 fragment source 遵循仓库默认 revision,并不是永久固定到 v0.1.0。下面的已发布 v0.1.1 命令使用显式 tag。 目标 v0.1.1 的命令为: ```text -npx skills add LightDevCoder/skills#v0.1.1 -npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex +npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex ``` -release gate 通过后,第一条安装五个包,第二条选择同一 tag 下的完整单包。必须记录 CLI version、host、destination、discovery 和 smoke result;见 [v0.1.1 安装记录](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 +第一条安装五个包,第二条选择同一 tag 下的完整单包。已验证的 CLI version、destination 类别、discovery 和 smoke result 见 [v0.1.1 安装记录](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 ## 安装范围 diff --git a/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.md b/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.md index a974c04..87441b6 100644 --- a/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.md +++ b/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.md @@ -4,9 +4,9 @@ ## Status -`STRUCTURAL PASS` — the local collection test returned 668 assertions and -`COLLECTION_DISCOVERY=PASS`. Fresh released-artifact discovery remains -`NOT TESTED` until the final release is inspected from a fresh destination. +`PASS` — the local collection test returned 683 assertions and +`COLLECTION_DISCOVERY=PASS`; the tagged artifact was installed into fresh +destinations and listed successfully without a source checkout. ## Required observations @@ -20,11 +20,26 @@ - User-invoked packages are not silently model-invoked. - `project-workflow` and `to-manuscript-spec` remain outside the admitted tree. +## Fresh artifact command + +```text +npx --yes skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex +npx --yes skills list +npx --yes skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex +npx --yes skills list +``` + +Observed: the whole-collection destination listed exactly 5 packages and the +single-Skill destination listed exactly `review-loop`; both destinations had no +`skills/` source checkout. Installed `review-loop` contract tests passed, and +the installed whole collection's `ask-light` behavior suite returned 52 +assertions/PASS. + ## Structural command ```text powershell -File tests/collection-discovery-tests.ps1 ``` -Observed local result: `COLLECTION_DISCOVERY_ASSERTIONS=668`, +Observed local result: `COLLECTION_DISCOVERY_ASSERTIONS=683`, `COLLECTION_DISCOVERY=PASS`. This is structural/discovery evidence only. diff --git a/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.zh-CN.md b/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.zh-CN.md index 734a8ab..c2e6522 100644 --- a/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.zh-CN.md +++ b/docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.zh-CN.md @@ -4,9 +4,9 @@ ## 状态 -本地 collection test 已返回 668 条断言并输出 `COLLECTION_DISCOVERY=PASS`,属于 -`STRUCTURAL PASS`。从 fresh destination 检查最终 release artifact 仍为 -`NOT TESTED`。 +本地 collection test 已返回 683 条断言并输出 `COLLECTION_DISCOVERY=PASS`;tagged +artifact 已安装到 fresh destination,并在没有 source checkout 的情况下成功 +列出,结论为 `PASS`。 ## 必须观察 @@ -17,6 +17,21 @@ - user-invoked 包不会被静默当作 model-invoked。 - `project-workflow` 与 `to-manuscript-spec` 仍在准入树外。 +## Fresh artifact 命令 + +```text +npx --yes skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex +npx --yes skills list +npx --yes skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex +npx --yes skills list +``` + +观察结果:整仓 destination 恰好列出 5 个包,单 Skill destination 恰好列出 +`review-loop`;两个 destination 都不存在 `skills/` source checkout。已安装的 +`review-loop` contract tests 通过,整仓安装后的 `ask-light` behavior suite +返回 52 assertions/PASS。 + 结构命令为 `powershell -File tests/collection-discovery-tests.ps1`。 -观察结果:`COLLECTION_DISCOVERY_ASSERTIONS=668`、`COLLECTION_DISCOVERY=PASS`。 -这只属于 structural/discovery evidence。 +观察结果:`COLLECTION_DISCOVERY_ASSERTIONS=683`、`COLLECTION_DISCOVERY=PASS`。 +这同时包含 structural/discovery evidence 和 fresh artifact discovery evidence; +不等于 host refresh 或模型介导的 runtime proof。 diff --git a/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md b/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md index f9f41c6..902e215 100644 --- a/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md +++ b/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md @@ -4,20 +4,21 @@ ## Status -`NOT TESTED` until the tagged public release is reachable from a fresh -destination. The commands below are the release targets, not a claim that a -source-checkout scan already proved them. +`PASS` for the tagged public repository using Skills CLI `1.5.20`. Host refresh +is host-specific and was not claimed; CLI discovery was run from each fresh +destination without a source checkout. | Field | Whole collection | Per-Skill | | --- | --- | --- | -| Command | `npx skills add LightDevCoder/skills#v0.1.1` | `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop` | -| CLI version | `NOT TESTED` | `NOT TESTED` | -| Released commit | `NOT TESTED` | `NOT TESTED` | -| Fresh destination | `NOT TESTED` | `NOT TESTED` | -| Discovery without source checkout | `NOT TESTED` | `NOT TESTED` | -| Success/boundary/missing-dependency smoke | `NOT TESTED` | `NOT TESTED` | -| Repeat-install behavior | `NOT TESTED` | `NOT TESTED` | -| Limitation | Host-specific destination/discovery must be recorded after execution. | Same. | +| Command | `npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex` | `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex` | +| CLI version | `1.5.20` | `1.5.20` | +| Released commit | `c50f1ef403a5f0bfe02e75d1aeff2c237556db63` | same | +| Fresh destination | New empty temporary project; exactly 5 packages under `.agents/skills/` | New empty temporary project; exactly 1 package under `.agents/skills/` | +| Install result | `PASS`, exit code 0 | `PASS`, exit code 0 | +| Discovery without source checkout | `npx --yes skills list` exit 0; 5 packages listed; source checkout absent | `npx --yes skills list` exit 0; 1 package listed; source checkout absent | +| Success/boundary/missing-dependency smoke | Installed `ask-light` behavior suite: 52 assertions/PASS; installed `manuscript-ops` CLI help/PASS | Installed `review-loop` generic profile contract: `PASS`; package resources present | +| Repeat-install behavior | Same command exit 0; CLI reported `overwrites: Codex` for all 5 packages | Not repeated separately; whole-collection repeat covered the installer path | +| Limitation | Host refresh and model-mediated runtime invocation were not tested. | Same. | ## Procedure @@ -30,14 +31,14 @@ source-checkout scan already proved them. 5. Repeat the same command and record whether it is a no-op or reports a duplicate. -Do not include tokens, usernames, absolute private paths, or sensitive host -details in this public record. +The evidence records destination classes rather than absolute private paths. It +does not include tokens, usernames, or sensitive host details. ## Historical v0.1.0 summary This summary preserves the actual v0.1.0 installer evidence from the controller T16 acceptance receipt. It is not a rerun and does not promote the current -v0.1.1 candidate. +v0.1.1 release. | Field | Whole collection | Per-Skill | | --- | --- | --- | diff --git a/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md b/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md index 36e514e..5b1f856 100644 --- a/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md +++ b/docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md @@ -4,25 +4,31 @@ ## 状态 -只有公开 tag 能从 fresh destination 访问后才可更新为 verified。下列命令是 release target,不是 source-checkout scan 已经证明的事实。 +使用 Skills CLI `1.5.20` 从公开 tag 安装后为 `PASS`。host refresh 仍是 +host-specific 行为,因此不宣称已经完成;但每个 fresh destination 都在没有 +source checkout 的条件下执行了 CLI discovery。 | 字段 | 整个集合 | 单 Skill | | --- | --- | --- | -| 命令 | `npx skills add LightDevCoder/skills#v0.1.1` | `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop` | -| CLI version | `NOT TESTED` | `NOT TESTED` | -| Release commit | `NOT TESTED` | `NOT TESTED` | -| Fresh destination | `NOT TESTED` | `NOT TESTED` | -| 脱离 source checkout 的 discovery | `NOT TESTED` | `NOT TESTED` | -| Success/boundary/missing-dependency smoke | `NOT TESTED` | `NOT TESTED` | -| 重复安装行为 | `NOT TESTED` | `NOT TESTED` | -| 限制 | 必须在执行后记录 host-specific destination/discovery。 | 同左。 | - -执行时记录 CLI version 和 exact command,使用 disposable empty destination,让 discovery 阶段无法读取 source checkout;分别运行整仓和单包命令,刷新 host,捕获 discovery 和 smoke,再重复安装并记录 no-op/duplicate 行为。公开记录不得包含 token、用户名、绝对私人路径或敏感 host 信息。 +| 命令 | `npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex` | `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex` | +| CLI version | `1.5.20` | `1.5.20` | +| Release commit | `c50f1ef403a5f0bfe02e75d1aeff2c237556db63` | 同左 | +| Fresh destination | 新建空临时项目;在 `.agents/skills/` 下恰好安装 5 个包 | 新建空临时项目;在 `.agents/skills/` 下恰好安装 1 个包 | +| 安装结果 | `PASS`,exit code 0 | `PASS`,exit code 0 | +| 脱离 source checkout 的 discovery | `npx --yes skills list` exit 0;列出 5 个包;不存在 source checkout | `npx --yes skills list` exit 0;列出 1 个包;不存在 source checkout | +| Success/boundary/missing-dependency smoke | 已安装 `ask-light` behavior suite:52 assertions/PASS;已安装 `manuscript-ops` CLI help/PASS | 已安装 `review-loop` generic profile contract:`PASS`;包资源存在 | +| 重复安装行为 | 同命令 exit 0;CLI 对 5 个包均报告 `overwrites: Codex` | 未单独重复;整仓重复已覆盖安装器路径 | +| 限制 | 未测试 host refresh 和模型介导的 runtime invocation。 | 同左。 | + +本次记录了 CLI version 和 exact command,使用 disposable empty destination,让 +discovery 阶段无法读取 source checkout;分别运行整仓和单包命令,捕获 +discovery 和 smoke,并重复整仓安装记录覆盖行为。公开记录只写 destination +类别,不包含 token、用户名、绝对私人路径或敏感 host 信息。 ## 历史 v0.1.0 摘要 本摘要根据 controller 的 T16 acceptance receipt 保留真实的 v0.1.0 安装证据; -不是当前重跑,也不提升当前 v0.1.1 candidate。 +不是当前 v0.1.1 release 的重跑。 | 字段 | 整个集合 | 单 Skill | | --- | --- | --- | diff --git a/docs/evidence/releases/v0.1.1/LIMITATIONS.md b/docs/evidence/releases/v0.1.1/LIMITATIONS.md index 71a45ec..a2a16f1 100644 --- a/docs/evidence/releases/v0.1.1/LIMITATIONS.md +++ b/docs/evidence/releases/v0.1.1/LIMITATIONS.md @@ -2,14 +2,13 @@ [中文限制](LIMITATIONS.zh-CN.md) -- `NOT TESTED`: Fresh public whole-collection and per-Skill installation must - be run against the actual tagged remote release. +- `PASS`: Fresh public whole-collection and per-Skill installation were run + against tag `v0.1.1` with CLI `1.5.20`; host refresh remains host-specific. - `BLOCKED`: An independent `review-loop agent-skill` Evaluator record is not present yet; same-context inspection cannot be labeled independent. -- `NOT TESTED`: GitHub Actions status depends on the public release commit and - runner execution. +- `PASS`: GitHub Actions `collection-quality` passed on merged release commit + `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`. - Host-specific Skill destinations and discovery refresh behavior vary; the public record must not publish private paths or credentials. - Direct upstream and private third-party packages are availability-dependent; this first-party repository does not copy or vend them. - diff --git a/docs/evidence/releases/v0.1.1/LIMITATIONS.zh-CN.md b/docs/evidence/releases/v0.1.1/LIMITATIONS.zh-CN.md index 2d5996c..333d0e8 100644 --- a/docs/evidence/releases/v0.1.1/LIMITATIONS.zh-CN.md +++ b/docs/evidence/releases/v0.1.1/LIMITATIONS.zh-CN.md @@ -2,9 +2,11 @@ [English limitations](LIMITATIONS.md) -- `NOT TESTED`:整仓和单 Skill fresh public install 必须针对真实 remote tag 运行。 +- `PASS`:已用 CLI `1.5.20` 针对 `v0.1.1` tag 完成公开整仓和单 Skill 安装;host + refresh 仍是 host-specific 行为。 - `BLOCKED`:尚无独立 `review-loop agent-skill` Evaluator 记录;同一上下文检查不能标为 independent。 -- `NOT TESTED`:GitHub Actions 状态要等公开 release commit 的 runner 执行。 +- `PASS`:合并后的 release commit + `c50f1ef403a5f0bfe02e75d1aeff2c237556db63` 上的 GitHub Actions + `collection-quality` 已通过。 - 不同 host 的 Skills destination 和 refresh/discovery 行为不同;公开记录不能包含私人路径或凭据。 - Direct upstream 和 private third-party 包依赖可见性;本第一方仓库不复制或代售它们。 - diff --git a/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md b/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md index 035f853..9cb6876 100644 --- a/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md +++ b/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md @@ -2,9 +2,9 @@ [中文收据](RELEASE_RECEIPT.zh-CN.md) -Status: `IN PROGRESS` — local implementation and structural evidence are -updated; tag, remote release, fresh installation, and independent acceptance -remain open gates. +Status: `RELEASED WITH ACCEPTANCE LIMITATION` — the immutable tag, remote +default branch, GitHub Actions, and fresh-install evidence are verified; +independent `review-loop agent-skill` acceptance remains `BLOCKED`. ## Identity @@ -12,8 +12,8 @@ remain open gates. | --- | --- | | Repository | `LightDevCoder/skills` | | Release | `v0.1.1` | -| Release commit | `NOT TESTED — fill after the release tag is created` | -| Release URL | `NOT TESTED — fill after GitHub release creation` | +| Release commit | `c50f1ef403a5f0bfe02e75d1aeff2c237556db63` | +| Release URL | https://github.com/LightDevCoder/skills/releases/tag/v0.1.1 | | Date | `2026-07-26` | | Scope | Five first-party packages, bilingual docs, Quick Start, workflow recipes, header, CI, and ask-light workflow mode. | @@ -33,10 +33,11 @@ remain open gates. | Ownership and scope | `VERIFIED` | First-party package list and public ownership boundary. | | Metadata/invocation consistency | `VERIFIED` | Collection test plus package frontmatter and `agents/openai.yaml`. | | Package behavior | `VERIFIED` for the listed local contract/behavior checks | See [TEST_SUMMARY.md](TEST_SUMMARY.md); fresh installation and independent acceptance remain separate gates. | -| Fresh whole-repository install | `NOT TESTED` | See [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md). | -| Fresh per-Skill install | `NOT TESTED` | See [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md). | +| Fresh whole-repository install | `VERIFIED` | See [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md). | +| Fresh per-Skill install | `VERIFIED` | See [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md). | | Independent `review-loop agent-skill` acceptance | `BLOCKED` until a fresh independent evaluator record is attached | Same-context review is not independent evidence. | -| GitHub Actions | `NOT TESTED` until the workflow has run on the release commit | See `.github/workflows/quality.yml`. | +| GitHub Actions | `VERIFIED` on merged release commit | See `.github/workflows/quality.yml` and the public Actions run. | -Do not call this receipt an independent acceptance record while the independent -evaluator row is `BLOCKED`. Do not call structural evidence runtime proof. +This receipt is a release record, not an independent acceptance record, while +the independent evaluator row is `BLOCKED`. Do not call structural evidence +model-mediated runtime proof. diff --git a/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.zh-CN.md b/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.zh-CN.md index e2523f3..c298fca 100644 --- a/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.zh-CN.md +++ b/docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.zh-CN.md @@ -2,8 +2,9 @@ [English receipt](RELEASE_RECEIPT.md) -状态:`IN PROGRESS`;本地实现和结构证据已更新,但 tag、远程 release、fresh -installation 与独立 acceptance 仍是未完成 gate。 +状态:`RELEASED WITH ACCEPTANCE LIMITATION`;不可变 tag、远程默认分支、GitHub +Actions 和 fresh-install 证据已核验;独立 `review-loop agent-skill` acceptance +仍为 `BLOCKED`。 ## 身份 @@ -11,8 +12,8 @@ installation 与独立 acceptance 仍是未完成 gate。 | --- | --- | | 仓库 | `LightDevCoder/skills` | | Release | `v0.1.1` | -| Release commit | `NOT TESTED — 创建 tag 后填写` | -| Release URL | `NOT TESTED — 创建 GitHub release 后填写` | +| Release commit | `c50f1ef403a5f0bfe02e75d1aeff2c237556db63` | +| Release URL | https://github.com/LightDevCoder/skills/releases/tag/v0.1.1 | | 日期 | `2026-07-26` | | 范围 | 五个第一方包、双语文档、Quick Start、workflow recipes、头图、CI 和 ask-light workflow mode。 | @@ -25,4 +26,10 @@ installation 与独立 acceptance 仍是未完成 gate。 - [审查策略](../../../REVIEW_POLICY.md) - [准入契约](../../../SKILL_ADMISSION.md) -独立 `review-loop agent-skill` acceptance 在有 fresh independent evaluator 记录前保持 `BLOCKED`;同一上下文的自审不是独立证据。结构证据不能写成 runtime proof。 +| Fresh whole-repository install | `VERIFIED` | 见 [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md)。 | +| Fresh per-Skill install | `VERIFIED` | 见 [INSTALLATION_VERIFICATION.md](INSTALLATION_VERIFICATION.md)。 | +| Independent `review-loop agent-skill` acceptance | `BLOCKED` | 等待 fresh independent evaluator 记录;同一上下文不是独立证据。 | +| GitHub Actions | `VERIFIED` | 合并后的 release commit 上的 workflow 已通过。 | + +这是一份 release 记录,不是独立 acceptance 记录;在 independent evaluator 行为 +为 `BLOCKED` 期间,不能把结构证据写成模型介导的 runtime proof。 diff --git a/docs/evidence/releases/v0.1.1/TEST_SUMMARY.md b/docs/evidence/releases/v0.1.1/TEST_SUMMARY.md index e5c4d77..c206df0 100644 --- a/docs/evidence/releases/v0.1.1/TEST_SUMMARY.md +++ b/docs/evidence/releases/v0.1.1/TEST_SUMMARY.md @@ -15,14 +15,17 @@ marked `NOT TESTED`; a zero-assertion or source-only scan is not a pass. | review-loop Profiles | all contract/behavior scripts under `skills/review-loop/tests/` | `PASS` — 5 contract suites and 105 behavior assertions across Agent-Skill, generic, manuscript, software, and specification profiles. | | learn-anything hooks | `python -m unittest discover -s tests -p "test*.py"` | `PASS` — 4 tests; 54 collection assertions and 7 learn-anything hook assertions. | | manuscript-ops | `python skills/manuscript-ops/scripts/{assess_project,check_dependencies,validate_state}.py --help` | `PASS` — all three read-only CLI help checks returned successfully. | -| collection discovery | `powershell -File tests/collection-discovery-tests.ps1` | `PASS` — 668 assertions, including Skill-guide, workflow, release-evidence, and bilingual semantic-pair parity. | +| collection discovery | `powershell -File tests/collection-discovery-tests.ps1` | `PASS` — 683 assertions, including Skill-guide, workflow, release-evidence, and bilingual semantic-pair parity. | | header asset | `powershell -File tests/header-asset-tests.ps1` | `PASS` — 11 assertions; SVG/PNG dimensions, synchronized asset manifest, and layered wordmark markers. | | Quick Start | `powershell -File tests/quick-start-smoke-tests.ps1` | `PASS` — 8 assertions. | | Python syntax | `python -B -c "...ast.parse..."` | `PASS` — 12 Python files parsed without writing bytecode. | -| Python `compileall` | `python -m compileall -q skills tests` | `NOT TESTED` as a bytecode-write proof — the sandbox denied writes to existing protected `__pycache__` directories; the read-only AST check above passed. | +| Python `compileall` | `python -m compileall -q skills tests` | `NOT PASSED locally` — the sandbox denied writes to existing protected `__pycache__` directories; the same command passed in GitHub Actions on merged release commit `c50f1ef`. | +| Tagged fresh install | `npx skills add LightDevCoder/skills#v0.1.1 ...` plus `npx skills list` | `PASS` — CLI `1.5.20`; whole collection listed 5 packages, per-Skill destination listed `review-loop`, and both source checkouts were absent. See [installation evidence](INSTALLATION_VERIFICATION.md). | +| Release-commit CI | GitHub Actions `collection-quality` | `PASS` — run `30189210521` on `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`. | ## Evidence class Package tests demonstrate the exercised contract scenarios. Collection -discovery demonstrates cross-reference and metadata consistency. Neither one -proves a fresh host installation or independent acceptance. +discovery demonstrates cross-reference and metadata consistency. Fresh tagged +installation evidence is recorded separately; neither local package tests nor +CLI discovery proves independent acceptance or model-mediated runtime behavior. diff --git a/docs/evidence/releases/v0.1.1/TEST_SUMMARY.zh-CN.md b/docs/evidence/releases/v0.1.1/TEST_SUMMARY.zh-CN.md index 73a01fb..36b9103 100644 --- a/docs/evidence/releases/v0.1.1/TEST_SUMMARY.zh-CN.md +++ b/docs/evidence/releases/v0.1.1/TEST_SUMMARY.zh-CN.md @@ -12,10 +12,12 @@ | review-loop Profiles | `skills/review-loop/tests/` 全部 contract/behavior | `PASS`;5 个 contract 套件、5 个 behavior 套件,共 105 条 behavior 断言。 | | learn-anything hooks | `python -m unittest discover -s tests -p "test*.py"` | `PASS`;4 个测试,collection 54 条断言、learn-anything hook 7 条断言。 | | manuscript-ops | 三个 Python CLI 的 `--help` | `PASS`;三个只读 CLI help 检查均成功。 | -| collection discovery | `powershell -File tests/collection-discovery-tests.ps1` | `PASS`;668 条断言,包含 Skill guide、workflow、release evidence 和双语 semantic-pair parity。 | +| collection discovery | `powershell -File tests/collection-discovery-tests.ps1` | `PASS`;683 条断言,包含 Skill guide、workflow、release evidence 和双语 semantic-pair parity。 | | header asset | `powershell -File tests/header-asset-tests.ps1` | `PASS`;11 条断言,覆盖 SVG/PNG 尺寸、同步资产 manifest 和叠层字标标记。 | | Quick Start | `powershell -File tests/quick-start-smoke-tests.ps1` | `PASS`;8 条断言。 | | Python 语法 | 只读 `ast.parse` 检查 | `PASS`;12 个 Python 文件解析通过且不写入字节码。 | -| Python `compileall` | `python -m compileall -q skills tests` | `NOT TESTED` 作为字节码写入证明;沙箱拒绝写入现有受保护的 `__pycache__`,上面的只读 AST 检查已通过。 | +| Python `compileall` | `python -m compileall -q skills tests` | 本地 `NOT PASSED`;沙箱拒绝写入现有受保护的 `__pycache__`,但合并 release commit `c50f1ef` 上的 GitHub Actions 同命令已通过。 | +| Tagged fresh install | `npx skills add LightDevCoder/skills#v0.1.1 ...` 加 `npx skills list` | `PASS`;CLI `1.5.20`,整仓 destination 列出 5 个包,单 Skill destination 列出 `review-loop`,且两个 source checkout 都不存在。见[安装证据](INSTALLATION_VERIFICATION.md)。 | +| Release-commit CI | GitHub Actions `collection-quality` | `PASS`;run `30189210521` 对应 `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`。 | -包测试只证明覆盖到的 contract 场景;collection discovery 只证明 cross-reference 和 metadata 一致,不证明 fresh host install 或 independent acceptance。 +包测试只证明覆盖到的 contract 场景;collection discovery 只证明 cross-reference 和 metadata 一致。tagged installation 证据另有记录;这些证据都不能证明 independent acceptance 或模型介导的 runtime 行为。 diff --git a/docs/skills/ask-light.md b/docs/skills/ask-light.md index 13c42fb..34e72ca 100644 --- a/docs/skills/ask-light.md +++ b/docs/skills/ask-light.md @@ -59,7 +59,7 @@ verdict. Stop after the recommendation or the `NEED-INPUT`/`BLOCKED` record. ## Installation and discovery check -After the v0.1.1 release gate passes, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill ask-light`, +For the published v0.1.1 release, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill ask-light`, refresh, and inspect `SKILL.md`, `agents/openai.yaml`, and the PowerShell scanner without the source checkout. Run [ask-light contract tests](../../skills/ask-light/tests/ask-light-contract-tests.ps1) diff --git a/docs/skills/learn-anything.md b/docs/skills/learn-anything.md index 2dff6a7..0099af9 100644 --- a/docs/skills/learn-anything.md +++ b/docs/skills/learn-anything.md @@ -56,7 +56,7 @@ Skill. ## Installation and discovery check -After the v0.1.1 release gate passes, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill learn-anything`, +For the published v0.1.1 release, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill learn-anything`, refresh the host, and confirm `SKILL.md`, `agents/openai.yaml`, and the `hooks/` resources are discovered without the source checkout. The explicit metadata policy must read `allow_implicit_invocation: false`. diff --git a/docs/skills/manuscript-ops.md b/docs/skills/manuscript-ops.md index 986391b..859ac8a 100644 --- a/docs/skills/manuscript-ops.md +++ b/docs/skills/manuscript-ops.md @@ -57,7 +57,7 @@ consumes that verdict. Stop at every stated handoff or final verdict. ## Installation and discovery check -After the v0.1.1 release gate passes, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill manuscript-ops`, +For the published v0.1.1 release, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill manuscript-ops`, refresh, and verify the complete package including `assets/`, `references/`, and `scripts/` without the source checkout. Probe local capabilities and run the package's state/dependency checks before treating a format result as diff --git a/docs/skills/project-init.md b/docs/skills/project-init.md index a7b4615..51dbbba 100644 --- a/docs/skills/project-init.md +++ b/docs/skills/project-init.md @@ -55,7 +55,7 @@ discovery, specification, implementation, or final review. ## Installation and discovery check -After the v0.1.1 release gate passes, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill project-init`, +For the published v0.1.1 release, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill project-init`, refresh the host, and confirm the package is discovered without the source checkout. Run the contract and behavior tests in [skills/project-init/tests/](../../skills/project-init/tests/) and record any diff --git a/docs/skills/review-loop.md b/docs/skills/review-loop.md index 010acdc..80e49c1 100644 --- a/docs/skills/review-loop.md +++ b/docs/skills/review-loop.md @@ -63,7 +63,7 @@ user-invoked Skill implicitly. ## Installation and discovery check -After the v0.1.1 release gate passes, install from the target release with +For the published v0.1.1 release, install with `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop`, refresh the host, and inspect the discovered `SKILL.md` plus `agents/openai.yaml` without the source checkout. Run the Profile tests under diff --git a/docs/zh-CN/skills/ask-light.md b/docs/zh-CN/skills/ask-light.md index 7eb24b7..d041d52 100644 --- a/docs/zh-CN/skills/ask-light.md +++ b/docs/zh-CN/skills/ask-light.md @@ -38,4 +38,4 @@ Execution: recommendation only; nothing was invoked, installed, or orchestrated ## 安装与发现验证 -v0.1.1 release gate 通过后,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill ask-light` 安装,刷新 host,在不依赖 source checkout 的情况下检查 `SKILL.md`、`agents/openai.yaml` 和 PowerShell scanner。运行 [contract test](../../../skills/ask-light/tests/ask-light-contract-tests.ps1) 与 [behavior test](../../../skills/ask-light/tests/ask-light-behavior-tests.ps1),覆盖 learn-anything、私有依赖缺失和歧义 fixtures。 +对于已发布的 v0.1.1,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill ask-light` 安装,刷新 host,在不依赖 source checkout 的情况下检查 `SKILL.md`、`agents/openai.yaml` 和 PowerShell scanner。运行 [contract test](../../../skills/ask-light/tests/ask-light-contract-tests.ps1) 与 [behavior test](../../../skills/ask-light/tests/ask-light-behavior-tests.ps1),覆盖 learn-anything、私有依赖缺失和歧义 fixtures。 diff --git a/docs/zh-CN/skills/learn-anything.md b/docs/zh-CN/skills/learn-anything.md index ad8f1a8..c979b69 100644 --- a/docs/zh-CN/skills/learn-anything.md +++ b/docs/zh-CN/skills/learn-anything.md @@ -36,4 +36,4 @@ builder 会报告 `created`、`updated`、`no-op`、`duplicate` 或 `blocked`。 ## 安装与发现验证 -v0.1.1 release gate 通过后,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill learn-anything` 安装,刷新 host,在脱离 source checkout 的情况下检查 `SKILL.md`、`agents/openai.yaml` 和 `hooks/`。显式 metadata 必须包含 `allow_implicit_invocation: false`。 +对于已发布的 v0.1.1,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill learn-anything` 安装,刷新 host,在脱离 source checkout 的情况下检查 `SKILL.md`、`agents/openai.yaml` 和 `hooks/`。显式 metadata 必须包含 `allow_implicit_invocation: false`。 diff --git a/docs/zh-CN/skills/manuscript-ops.md b/docs/zh-CN/skills/manuscript-ops.md index 72e67f6..333e6d7 100644 --- a/docs/zh-CN/skills/manuscript-ops.md +++ b/docs/zh-CN/skills/manuscript-ops.md @@ -33,4 +33,4 @@ Project route 先按需要选择一个 discovery handoff:单会话决策用 `g ## 安装与发现验证 -v0.1.1 release gate 通过后,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill manuscript-ops` 安装,刷新 host,在不依赖 source checkout 的情况下验证 `assets/`、`references/`、`scripts/` 等完整资源。先运行 capability/dependency/state 检查,再把 format 结果标为 verified。 +对于已发布的 v0.1.1,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill manuscript-ops` 安装,刷新 host,在不依赖 source checkout 的情况下验证 `assets/`、`references/`、`scripts/` 等完整资源。先运行 capability/dependency/state 检查,再把 format 结果标为 verified。 diff --git a/docs/zh-CN/skills/project-init.md b/docs/zh-CN/skills/project-init.md index 1049caf..210bfa0 100644 --- a/docs/zh-CN/skills/project-init.md +++ b/docs/zh-CN/skills/project-init.md @@ -34,4 +34,4 @@ $project-init ## 安装与发现验证 -v0.1.1 release gate 通过后,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill project-init` 安装,刷新 host,在脱离 source checkout 的环境确认发现结果,并运行 [tests](../../../skills/project-init/tests/)。把 host 限制记录到 release evidence。 +对于已发布的 v0.1.1,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill project-init` 安装,刷新 host,在脱离 source checkout 的环境确认发现结果,并运行 [tests](../../../skills/project-init/tests/)。把 host 限制记录到 release evidence。 diff --git a/docs/zh-CN/skills/review-loop.md b/docs/zh-CN/skills/review-loop.md index 1d16209..865ccc2 100644 --- a/docs/zh-CN/skills/review-loop.md +++ b/docs/zh-CN/skills/review-loop.md @@ -36,4 +36,4 @@ $review-loop resume ## 安装与发现验证 -v0.1.1 release gate 通过后,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop` 安装,刷新 host,在不依赖 source checkout 的情况下检查已发现的 `SKILL.md` 和 `agents/openai.yaml`。运行 [Profile tests](../../../skills/review-loop/tests/);结果记录在 [安装证据](../../evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 +对于已发布的 v0.1.1,使用 `npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop` 安装,刷新 host,在不依赖 source checkout 的情况下检查已发现的 `SKILL.md` 和 `agents/openai.yaml`。运行 [Profile tests](../../../skills/review-loop/tests/);结果记录在 [安装证据](../../evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。 diff --git a/examples/quick-start/README.md b/examples/quick-start/README.md index 75b098a..30f6dab 100644 --- a/examples/quick-start/README.md +++ b/examples/quick-start/README.md @@ -8,11 +8,11 @@ workflow and not a record of commands already run. ## 1. Install -The commands below target v0.1.1 and become install instructions only after -the release gate passes. +The commands below install the published v0.1.1 release. The output remains a +recommendation boundary; installation does not authorize automatic chaining. ```text -npx skills add LightDevCoder/skills#v0.1.1 +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex ``` Refresh the Agent host and confirm discovery without this source checkout. diff --git a/examples/quick-start/README.zh-CN.md b/examples/quick-start/README.zh-CN.md index b70534a..e5000b1 100644 --- a/examples/quick-start/README.zh-CN.md +++ b/examples/quick-start/README.zh-CN.md @@ -6,10 +6,10 @@ ## 1. 安装 -下列命令以 v0.1.1 为目标,只有 release gate 通过后才作为安装说明。 +下列命令安装已发布的 v0.1.1。示例输出仍然只展示选择边界;安装不会授权自动串联。 ```text -npx skills add LightDevCoder/skills#v0.1.1 +npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex ``` 刷新 Agent host,并在脱离 source checkout 的情况下确认 discovery。只安装一个包时,例如: diff --git a/tests/collection-discovery-tests.ps1 b/tests/collection-discovery-tests.ps1 index cf81726..c18cc5e 100644 --- a/tests/collection-discovery-tests.ps1 +++ b/tests/collection-discovery-tests.ps1 @@ -149,7 +149,7 @@ foreach ($pair in @( $parityMatrix = @( [pscustomobject]@{ English = 'README.md'; Chinese = 'README.zh-CN.md'; Markers = @('Quick Start', 'ask-light', 'v0.1.1') }, - [pscustomobject]@{ English = 'CATALOG.md'; Chinese = 'CATALOG.zh-CN.md'; Markers = @('review-loop', 'v0.1.0', 'skills/') }, + [pscustomobject]@{ English = 'CATALOG.md'; Chinese = 'CATALOG.zh-CN.md'; Markers = @('review-loop', 'v0.1.1', 'skills/') }, [pscustomobject]@{ English = 'CHANGELOG.md'; Chinese = 'CHANGELOG.zh-CN.md'; Markers = @('v0.1.1', '0.1.0', 'release') }, [pscustomobject]@{ English = 'docs/INSTALLATION.md'; Chinese = 'docs/INSTALLATION.zh-CN.md'; Markers = @('npx skills add', 'fresh-install', 'SKILL.md') }, [pscustomobject]@{ English = 'docs/MAINTENANCE.md'; Chinese = 'docs/MAINTENANCE.zh-CN.md'; Markers = @('README', 'review-loop', 'release') }, @@ -166,8 +166,8 @@ foreach ($pair in $parityMatrix) { $semanticParityMatrix = @( [pscustomobject]@{ English = 'README.md'; Chinese = 'README.zh-CN.md'; Pairs = @( - @('Install the whole first-party collection', '安装目标版本的整个第一方集合'), - @('Install one Skill at the same target revision', '只安装同一目标版本下的一个 Skill'), + @('Install the published first-party collection', '安装已发布的第一方集合'), + @('Install one Skill at the same published revision', '安装同一已发布版本下的一个 Skill'), @('fresh-install evidence', 'fresh-install 证据') ) }, [pscustomobject]@{ English = 'CATALOG.md'; Chinese = 'CATALOG.zh-CN.md'; Pairs = @( @@ -176,7 +176,7 @@ $semanticParityMatrix = @( @('Installation authority', '安装权威') ) }, [pscustomobject]@{ English = 'CHANGELOG.md'; Chinese = 'CHANGELOG.zh-CN.md'; Pairs = @( - @('Release-candidate evidence', 'Release candidate 证据'), + @('Release evidence', 'Release 证据'), @('Historical installation details', '历史安装明细') ) }, [pscustomobject]@{ English = 'docs/INSTALLATION.md'; Chinese = 'docs/INSTALLATION.zh-CN.md'; Pairs = @( @@ -260,7 +260,8 @@ foreach ($pair in $secondaryParity) { foreach ($name in @('RELEASE_RECEIPT', 'TEST_SUMMARY', 'INSTALLATION_VERIFICATION', 'DISCOVERY_VERIFICATION', 'LIMITATIONS')) { $englishText = Get-Content -LiteralPath (Join-Path $Root "docs/evidence/releases/v0.1.1/$name.md") -Raw $chineseText = Get-Content -LiteralPath (Join-Path $Root "docs/evidence/releases/v0.1.1/$name.zh-CN.md") -Raw - foreach ($marker in @('v0.1.1', 'NOT TESTED', 'fresh')) { + $markers = if ($name -eq 'RELEASE_RECEIPT') { @('v0.1.1', 'VERIFIED', 'fresh') } else { @('v0.1.1', 'PASS', 'fresh') } + foreach ($marker in $markers) { Assert-Collection ($englishText -match [regex]::Escape($marker) -and $chineseText -match [regex]::Escape($marker)) "$name release evidence is missing the synchronized semantic marker: $marker" } }