maintain-verification-skill について
リポジトリの検証スキルを、現在のコマンドやカバレッジに合わせるスキルです。チェックを再実行し、実測結果に基づいて検証マップを更新し、ロック付きの台帳ライターで再同期を記録します。
主な機能
- 01記録済みのコマンドとチェックを監査
- 02コマンドを再実行して期待値を確認
- 03未対応のプロジェクト領域を特定
- 04スキルと機能マップを更新
- 05台帳ライターで結果を記録
活用シーン
- 01ツールチェーンや CI の移行後にチェックを更新
- 02名称変更されたコマンドの検証手順を修正
- 03新しいプロジェクト領域のチェックを記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill maintain-verification-skillインストール後、Claude Code で/maintain-verification-skillを入力して読み込まれたか確認します。
README(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
Maintain Verification Skill
A verification skill that names dead commands is worse than none: it fails
loudly on trivia and passes quietly on what matters. This skill re-syncs the
project's verify skill to the repo's current reality.
When to use
- verification errors on a command that no longer exists or was renamed
- a new surface (package, app, e2e suite) has no check recorded
- after a toolchain or CI migration
Workflow
- Audit the recorded skill: list every command and manual check it names; for each, does the command still exist and still mean the same thing (flags, scripts, config)?
- Re-run, don't re-read: execute each surviving command and compare the observed outcome to the recorded expectation. A command whose passing shape changed gets its expectation rewritten, with the new evidence.
- Find uncovered surface: what does the repo build/check now that the feature map does not mention? Add the check by running it, or record the gap as uncovered — the map stays honest.
- Update the skill and feature map in place: same file, corrected commands, corrected coverage table, dated revision line at the top.
- Record the resync through the ledger's locked writer —
appendLedgerEntryanddefaultLedgerPathfrom the installed package'sdist/features/verification-ledger/index.js(babysit's ledger step demonstrates the exact invocation); never append raw rows to.omc/state/verification-ledger.tsv— the writer owns header creation, locking, and cell sanitization. The verdict is the one the rerun actually earned —unit-test-verifiedwhen the test suite ran,live-ui-verifiedfor a live-UI flow,type-check-onlywhen only build/lint/typecheck commands were rerun — and those commands as evidence. Never claim a test ran that did not.
Rules
- The rerun is the resync; nothing is marked current without execution.
- Coverage that shrank is reported out loud, not silently dropped from the map.
- If the project's verification has outgrown the single skill shape (multi- package, per-app checks), say so and split per surface rather than fattening one file.
コメント
Markdown 対応