Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-engineered release skill: executable commands, clear single-gate sequencing with validation and failure recovery, and clean one-level-deep references. The main weakness is conciseness — several contextual/rationale passages could be trimmed or offloaded to references.
Suggestions
Tighten the 'CC runtime hard floor' and 'mirror drift / run ID' passages to one or two lines and move historical regression detail into a reference file, since it competes with context without changing the action.
Consolidate the repeated PR-ready/release-ready and bare-invocation rationale blocks that appear across the Quick Reference, bare invocation contract, and 設計思想 sections to remove near-duplicate explanation.
Consider moving the full Confirmation Gate ASCII plan block into post-gate-detail.md and summarizing the three-choice gate inline, so the overview body stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is accurate and mostly purposeful but is long (~360 lines) and re-explains operational context Claude can derive (e.g. multiple paragraphs on runtime hard floor, mirror drift run IDs, lane taxonomy) that could be tightened or pushed to references. | 2 / 3 |
Actionability | Provides concrete, copy-pasteable bash (preflight checks, `claude plugin tag --dry-run`, `check-release-version-sync.py --json`, verify-publish polling) and exact literal markers (RELEASE_AUTOSTART, the trailing output literal) rather than vague direction. | 3 / 3 |
Workflow Clarity | The single-gate flow is explicitly sequenced as numbered Pre-Gate → Confirmation Gate → Post-Gate stages with a failure-recovery table, validation checkpoints (preflight fail-closed, version-sync re-check after merge), and a REQUEST_CHANGES→fix→re-review feedback loop. | 3 / 3 |
Progressive Disclosure | Body is an overview that links one level deep to real reference files (version-files.md, bump-detection.md, release-notes.md, github-release.md, versioning.md, post-gate-detail.md), all verified present, with the detail split out rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |