skill-comply

skill-comply skill の概要

skill-comply は、エージェントが実際の実行で skill、ルール、または agent definition に本当に従っているかを確認するためのコンプライアンステスト用 skill です。仮定ではなく証拠が必要な人に向いています。たとえば、ワークフロー規則を検証するメンテナー、新しい skill をテストする作者、あるいは coding agent が TDD、レビュー、プロセス制約をプロンプト条件の違いにかかわらず守るかを確かめたいチームに適しています。

skill-comply skill でできること

skill-comply は、markdown ソースから期待される振る舞いの spec を生成し、サポート度合いを段階的に下げた 3 つの prompt を作成し、エージェントを実行してから、観測された tool-call のタイムラインを spec と照合します。そのため、最終出力だけでなく、アクションの有無と順序の両方が重要な Compliance Review に特に役立ちます。

skill-comply が向いているケース

skill-comply は、サポート的な prompt、ニュートラルな prompt、競合する prompt の下でもルールが守られるかを確認したいときに使います。とくに、「実装前にテストする」「編集前にルールを読む」のように、順序に依存する skill に有効です。

何が違うのか

「ルールに従ったか？」と尋ねる一般的な prompt テストと違い、skill-comply はチェックを実行可能な形に落とし込みます。ステップを抽出し、LLM で tool call を分類し、順序を決定的に評価します。価値があるのは trace、timeline、compliance rate であり、それによってその skill を継続利用するのに十分信頼できるか判断できます。

skill-comply skill の使い方

skill-comply をインストールして有効化する

skill-comply skill は次のコマンドでインストールします。

npx skills add affaan-m/everything-claude-code --skill skill-comply

その後、検証したい markdown ファイルに対して実行します。リポジトリの使い方は CLI 実行を中心に設計されているため、単一の対象ファイルを指定し、出力は要約文ではなくコンプライアンスレポートとして扱うのが最も適しています。

先に読むべきファイル

skill-comply install とセットアップの流れを把握するには、まず skills/skill-comply/SKILL.md を読み、続いて prompts/spec_generator.md、prompts/scenario_generator.md、prompts/classifier.md を確認してください。この 3 つの prompt には、spec 抽出、scenario 生成、trace 分類という実際のワークフローがそのまま示されています。実装上の制約を理解したい場合は、scripts/run.py、scripts/spec_generator.py、scripts/scenario_generator.py、scripts/classifier.py をざっと見ておくとよいです。

よい入力の作り方

優れた skill-comply usage prompt は、曖昧なポリシーではなく、具体的なコンプライアンス対象です。よい入力では、確認したいファイル名と挙動を明示します。たとえば、「rules/common/testing.md が coding task 中に守られているか確認する」「この skill