CWP Conformance
暂无简介
- License 许可
- MIT
- 所属仓库
- rhCat/skillChip
- 最近更新
- 2026-07-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- CWP Conformance
- perks
- [ "repin", "doclint", "vectors", "crosslang", "digestlint", "interop", "schemas", "keystore", "labeling", "reprobuild", "quickstart" ]
- skill
- cws-conform
02 资源文件 82
- 其他blueprint.drawio2.7 KB
- 参考文档blueprint.json3.7 KB
- 资产文件blueprint.svg8.9 KB
- 参考文档index.json8.8 KB
- 参考文档ledger.json342 B
- 参考文档perks.json2.8 KB
- 参考文档perks/crosslang/manifesto.json281 B
- 参考文档perks/crosslang/metadata.json1.1 KB
- 参考文档perks/crosslang/src/contracts.json321 B
- 脚本perks/crosslang/src/cws_crosslang.py3.5 KB
- 脚本perks/crosslang/src/cws_crosslang.sh224 B
- 参考文档perks/crosslang/test/case.json223 B
- 参考文档perks/crosslang/test/fixture/corpus.json270 B
- 参考文档perks/digestlint/manifesto.json391 B
- 参考文档perks/digestlint/metadata.json1.4 KB
- 参考文档perks/digestlint/src/contracts.json485 B
- 脚本perks/digestlint/src/cws_digestlint.py7.2 KB
- 脚本perks/digestlint/src/cws_digestlint.sh246 B
- 参考文档perks/digestlint/test/case.json393 B
- 脚本perks/digestlint/test/fixture/bad.py622 B
- 脚本perks/digestlint/test/fixture/good.py406 B
- 参考文档perks/doclint/manifesto.json370 B
- 参考文档perks/doclint/metadata.json1.1 KB
- 参考文档perks/doclint/src/contracts.json472 B
- 脚本perks/doclint/src/cws_doclint.py2.8 KB
- 脚本perks/doclint/src/cws_doclint.sh237 B
- 参考文档perks/doclint/test/case.json342 B
- 参考文档perks/doclint/test/fixture/sample.md172 B
- 参考文档perks/interop/manifesto.json404 B
- 参考文档perks/interop/metadata.json1.5 KB
- 参考文档perks/interop/src/contracts.json407 B
- 脚本perks/interop/src/cws_interop.py4.8 KB
- 脚本perks/interop/src/cws_interop.sh237 B
- 参考文档perks/interop/test/case.json702 B
- 参考文档perks/interop/test/fixture/cosign_envelope.json589 B
- 其他perks/interop/test/fixture/cosign_pub.pem113 B
- 参考文档perks/keystore/manifesto.json247 B
- 参考文档perks/keystore/metadata.json183 B
- 参考文档perks/keystore/src/contracts.json256 B
- 脚本perks/keystore/src/cws_keystore.py1.2 KB
- 脚本perks/keystore/src/cws_keystore.sh177 B
- 参考文档perks/keystore/test/case.json260 B
- 参考文档perks/labeling/manifesto.json278 B
- 参考文档perks/labeling/metadata.json162 B
- 参考文档perks/labeling/src/contracts.json256 B
- 脚本perks/labeling/src/cws_labeling.py1.2 KB
- 脚本perks/labeling/src/cws_labeling.sh177 B
- 参考文档perks/labeling/test/case.json250 B
- 参考文档perks/quickstart/manifesto.json288 B
- 参考文档perks/quickstart/metadata.json1022 B
- 参考文档perks/quickstart/src/contracts.json357 B
- 脚本perks/quickstart/src/cws_quickstart.py4.1 KB
- 脚本perks/quickstart/src/cws_quickstart.sh246 B
- 参考文档perks/quickstart/test/case.json284 B
- 参考文档perks/quickstart/test/fixture/catalog.json171 B
- 参考文档perks/quickstart/test/fixture/quickstart.md387 B
- 参考文档perks/repin/manifesto.json322 B
- 参考文档perks/repin/metadata.json1.1 KB
- 参考文档perks/repin/src/contracts.json321 B
- 脚本perks/repin/src/cws_repin.py4.0 KB
- 脚本perks/repin/src/cws_repin.sh231 B
- 参考文档perks/repin/test/case.json268 B
- 参考文档perks/repin/test/fixture/chip/index.json290 B
- 参考文档perks/reprobuild/manifesto.json263 B
- 参考文档perks/reprobuild/metadata.json188 B
- 参考文档perks/reprobuild/src/contracts.json264 B
- 脚本perks/reprobuild/src/cws_reprobuild.py1.2 KB
- 脚本perks/reprobuild/src/cws_reprobuild.sh181 B
- 参考文档perks/reprobuild/test/case.json309 B
- 参考文档perks/schemas/manifesto.json281 B
- 参考文档perks/schemas/metadata.json172 B
- 参考文档perks/schemas/src/contracts.json252 B
- 脚本perks/schemas/src/cws_schemas.py1.3 KB
- 脚本perks/schemas/src/cws_schemas.sh175 B
- 参考文档perks/schemas/test/case.json246 B
- 参考文档perks/vectors/manifesto.json298 B
- 参考文档perks/vectors/metadata.json1.1 KB
- 参考文档perks/vectors/src/contracts.json393 B
- 脚本perks/vectors/src/cws_vectors.py3.7 KB
- 脚本perks/vectors/src/cws_vectors.sh220 B
- 参考文档perks/vectors/test/case.json260 B
- 参考文档perks/vectors/test/fixture/corpus.json200 B
03 SKILL.md 正文
cws-conform — CWP Conformance (SV-1)
Make "cyberware is a specification, not a codebase" a checkable claim. A chip's identity is the
canonical hash of its parts. The repin perk first observes drift against the committed pins — it
verifies each skill's files against its existing index.json (a reference the run did not produce), so
a file changed since the last pin is named — then regenerates every per-skill index.json (sha256 of
every file + a roll-up skill_sha) and the chip manifest (index.json with the roll-up chip_sha), and
records the old -> new chip_sha transition. The SV-1 self-referential act, performed and evidenced.
What to look out for
repin.json carries {skills, new_skills, old_chip_sha, new_chip_sha, changed, pre_drift[], drift_count, status}. The falsifiable signal is pre_drift: skills whose committed index no longer matched their
files. status: "green" (exit 0) means the committed chip was already canonical — a no-op re-pin, the
healthy steady state. status: "drift" (nonzero exit) means the committed pins were stale and the
named skills had to be rewritten — the chip is still left re-pinned, but the drift is flagged (this is the
SV-1 gate: someone changed a file without re-pinning). LOGS TO CHECK: that line + repin.json + the
executor run-ledger.
Perks
| perk | tool | nature |
|---|---|---|
repin |
cws_repin |
observe drift vs committed pins, regenerate indexes + manifest, record the chip_sha transition — writes to TARGET_CHIP's index files |
doclint |
cws_doclint |
structural conformance lint for a spec doc — exists, title, normative, on-topic (P0-V10) — read-only / safe |
vectors |
cws_vectors |
replay the golden vector corpus (canonical + digest + sig verdicts) → conformance verdict (P0-T07/T17) — read-only / safe |
crosslang |
cws_crosslang |
diff the independent Go verifier vs canonical.py+sign.py over the corpus — the external anchor (P0-T08) — needs the go toolchain |
digestlint |
cws_digestlint |
prove every JSON-object hash routes through cwp.canonical, not ad-hoc json.dumps — the digest-cutover gate (P0-T04 / F1 / P0-V03) — read-only / safe |
interop |
cws_interop |
prove cwp ↔ cosign/sigstore DSSE interop at the Ed25519ph layer, both directions (P0-T03) — needs openssl≥3.4 + go |
schemas |
cws_schemas |
validate the CWP message corpus against the 2020-12 JSON Schemas (P0-T05) — 100% valid + negatives rejected — read-only / safe |
keystore |
cws_keystore |
KeyStore seam contract (P0-T15) — file + PKCS#11-stub backends pass one suite; seam_real + HSM non-export — read-only / safe |
labeling |
cws_labeling |
truth-in-labeling doc lint (P0-T16) — no enforcement claim without a criterion-id reference — read-only / safe |
reprobuild |
cws_reprobuild |
reproducible engine build baseline (P0-T13 / M1 / P0-V11) — builds the Go anchor twice in isolated caches (two independent builders), asserts byte-identical digests; diffoscope: empty is proven by the sha256 match (and confirmed by diffoscope where installed); a flipped byte must break the match — needs the go toolchain |
repin— setTARGET_CHIP(a chip dir: skill dirs each with aperks.json). Output:repin.json.digestlint— setSCAN_ROOT(a dir) + optionalEXCLUDE(defaultinfra/cwp) /WHITELIST(relpath:lineexemptions). Output:digestlint.json. AST same-expression lint: nojson.dumpsmay feed a hash outsideinfra/cwp. This is what redeems the P0-T04 digest cutover.doclint— setSPEC(a.md) + optionalMIN_NORMATIVE/REQUIRE. Output:doclint.json. This is what redeems the P0 spec tranche (spec/keys.md,privacy.md,time.md,inflight.md, …).
Scope (the SV-1 surface)
repin is the canonical re-pin under the current sha256 scheme; doclint is the structural spec lint
(P0-V10). The full P0 surface is built: vectors replays the golden-vector corpus through infra/cwp,
crosslang diffs the verdict stream against the independent Go verifier (the V-EXT external anchor),
schemas validates the message corpus against the 2020-12 JSON Schemas, keystore contracts the KeyStore
seam (file + PKCS#11 stub), labeling is the truth-in-labeling doc lint, and reprobuild proves the
byte-identical engine build. crosslang / interop / reprobuild need the Go toolchain; the rest are pure.
How to use it
Pick repin, copy ledger.json → task-ledger.json, set TARGET_CHIP + record_store, then validate
→ compose → compile → oversight → executor.
04 同仓库更多 Skills
Vercel Deploy
暂无简介
Audio Transcribe
暂无简介
Speech (OpenAI TTS)
暂无简介
Skill Installer
暂无简介
demo-skill
A demo skill used as a test fixture for the validate perk. Use when checking that quick_validate.py accepts a well-formed SKILL.md.
demo-skill
A demo skill used as a test fixture for generating agents/openai.yaml. Use when validating the gen_openai_yaml perk.