Menu
36章 PKG-001〜017 と package-contract.json schema を参照するとき、PKG ID の意味・適用 package_mode・eval-log 保存先を判断するときに読む。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | ref-pkg-contract |
| description | 36章 PKG-001〜017 と package-contract.json schema を参照するとき、PKG ID の意味・適用 package_mode・eval-log 保存先を判断するときに読む。 |
| disable-model-invocation | false |
| user-invocable | false |
| allowed-tools | ["Read"] |
| kind | ref |
| prefix | ref |
| effect | none |
| owner | team-platform |
| since | "2026-05-23T00:00:00.000Z" |
| version | 0.1.0 |
| source | doc/ClaudeCodeスキルの設計書/36-plugin-package-harness-contract.md |
| source-tier | internal |
| last-audited | "2026-05-23T00:00:00.000Z" |
| audit-trigger | quarterly |
| responsibility_refs | ["prompts/R1-lookup-pkg.md"] |
| schema_refs | ["schemas/package-contract.schema.json"] |
36章 Plugin Package Harness Contract の PKG-001〜017 ID 表 と package-contract.json JSON Schema を機械可読化した参照専用 skill。run-plugin-package-check（B）と assign-plugin-package-evaluator（C）が同一定義を共有するためのシングルソース。
入力: PKG ID（PKG-001〜015、PKG-013a〜d、PKG-016/017 予約）または package_mode 値（bundle / skill-only）
出力: ID 意味・実装スクリプトパス・適用 package_mode・eval-log 保存先パス・ governance 制約
doc/ClaudeCodeスキルの設計書/36-plugin-package-harness-contract.md §PKG-001〜017 一覧。ただし機械処理上は二層正本で、36章本文と references/pkg-id-catalog.yaml に齟齬が出た場合は R1-lookup-pkg (CONST_002) が catalog 値を機械可読正本として採用し warn: catalog_doc_drift を併記する（doc-only 更新で CI を止めないため）eval-log/<plugin>/pkg-<id>/<YYYY-MM-DD>-<run>.{json,log}。本 skill で再定義しないschemas/package-contract.schema.json を一次。本 skill 本文には例示のみpackage_mode: skill-only は 3 例外限定: legacy / dev-only / migration。それ以外で参照されたら governance escalation| ID | 名称 | 適用 package_mode | 実装スクリプト | Phase |
|---|---|---|---|---|
| PKG-001 | claude plugin validate --strict 通過 | bundle | scripts/run-plugin-validate-strict.sh | 0 |
| PKG-002 | plugin.json frontmatter 完備 | bundle, skill-only | scripts/validate-plugin-package.py --check pkg-002 | 0 |
| PKG-003 | package 単位の名前空間衝突検査 | bundle | scripts/validate-plugin-package.py --check pkg-003 | 0 |
| PKG-004 | SKILL.md frontmatter 完備 | bundle, skill-only | scripts/validate-frontmatter.py | 0 |
| PKG-005 | Agent definition 整合 | bundle | scripts/validate-plugin-package.py --check pkg-005 | 0 |
| PKG-006 | Hook registration 整合 | bundle | scripts/validate-plugin-package.py --check pkg-006 | 0 |
| PKG-007 | script 存在 + 実行可能 | bundle | scripts/validate-plugin-package.py --check pkg-007 | 0 |
| PKG-008 | settings 断片 lint | bundle | scripts/validate-plugin-package.py --check pkg-008 | 0 |
| PKG-009 | 外部参照ゼロ | bundle | scripts/lint-external-refs.py --skills-dir plugins/<plugin>/skills --fail-on-external | 0 |
| PKG-010 | install smoke | bundle | scripts/smoke-plugin-install.sh | 1 |
| PKG-011 | uninstall 完全性 | bundle | scripts/smoke-plugin-uninstall.sh | 2 |
| PKG-012 | upgrade 冪等性 | bundle | scripts/smoke-plugin-upgrade.sh | 2 |
| PKG-013a | tool permissions scope | bundle | scripts/validate-plugin-permissions.py --plugin <name> --check 013a | 2 |
| PKG-013b | filesystem permissions scope | bundle | scripts/validate-plugin-permissions.py --plugin <name> --check 013b | 2 |
| PKG-013c | network permissions scope | bundle | scripts/validate-plugin-permissions.py --plugin <name> --check 013c | 2 |
| PKG-013d | MCP/external permissions scope | bundle | scripts/validate-plugin-permissions.py --plugin <name> --check 013d | 2 |
| PKG-014 | runtime contract 検証 | bundle | scripts/validate-plugin-package.py --check pkg-014 | 2 |
| PKG-015 | rubric 違反率しきい値 | bundle | run-plugin-package-check/scripts/run-pkg-015.py --plugin <name> --log-dir <log-dir> --out <pkg-log> | 2 |
| PKG-016 | 予約（未確定） | - | - | - |
| PKG-017 | 予約（未確定） | - | - | - |
eval-log/<plugin>/pkg-<id>/<YYYY-MM-DD>-<run>.{json,log}
例: eval-log/harness-creator/pkg-010/2026-05-23-001.json
PKG fail は 35章 pkg_check_failed failure_mode として observable 集約される。
package_mode | 適用 PKG ID | 用途 |
|---|---|---|
bundle | PKG-001〜015 全て必須 | 新規量産の既定値 |
skill-only | PKG-002/004 のみ任意適用 | legacy / dev-only / migration の 3 例外限定 |
skill-only 選択時は references/package-contract.json の package_mode_exception に legacy / dev-only / migration のいずれかを記録すること（schema enforced）。公式 CLI が読む .claude-plugin/plugin.json には harness 専用キーを混在させない。
skill-only での PKG-001/003/005-015 適用は no-op: skip 扱いではなく適用対象外として status: not_applicable を返すschemas/package-contract.schema.json の変更は P0_breaking。33章 proposal 必須schemas/package-contract.schema.json — package-contract.json の正本 JSON Schemareferences/pkg-id-catalog.yaml — PKG ID メタデータ（severity、適用 phase、依存スクリプト）の機械可読版prompts/R1-lookup-pkg.md — PKG ID 単発参照時の応答テンプレ（R1）YAML仕様が変わったか確認するとき、公式仕様との差分を確認するときに使う。
北原さん式ナレッジソースの差分を検知したいとき、6カテゴリへ分類・格納してナレッジを同期したいときに使う。
Capability 7 kind を新規作成・更新するとき、CapabilityManifest と plugin-composition.yaml を整備するときに使う。
rubric変更を提案するとき、rubric改正を施行するときに使う。
トリアージで影響ありと判定された spec-drift issue の rubric/schema/template を同期したいとき、propose(read-only)で最小 Edit 差分と pre-image hash を提案し apply で監査 PASS と明示承認後に allowlist 対象だけを適用したいときに使う。
spec-drift issue が起票され diff トリアージが必要なとき、C11 が再構成した issue 単位の完全 diff を hunk 化し name/type/required/enum/semantics 各軸の影響を before/after/evidence 付きで判定して triage-report を出したいときに使う。