heal-skill

/heal-skill — 1 つ以上のスキルパッケージをチェック

heal-skill は、スキルの健全性を確認する専門ツールです。正規のソーススキルと、生成された Codex の対応スキルにおける構造上の欠陥を報告します。--fix を指定すると、ジェネレーターを通じて、管理対象のプロジェクションのみを修復します。作業のスケジュール設定、Git の操作、ソフトウェア候補の検証、または失敗後の処理の決定は行いません。

入力

bash skills/heal-skill/scripts/heal.sh --check [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --check --strict [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --fix [skills/<slug> ...]

明示的に指定する各ターゲットは、skills/ または skills-codex/ の直下に実在するディレクトリでなければなりません。存在しないパス、ディレクトリの遡及、シンボリックリンクによる表記は拒否されます。

手順

1. 要求されたすべてのターゲットディレクトリを解決し、その範囲内に収まることを確認します。
2. 各 SKILL.md のフロントマターを解析します。
3. パスと名前の一致、説明、API バージョン、処遇メタデータ、リンクされたローカル参照をチェックします。
4. すべての検出事項を 1 回ずつ出力します。
5. --fix モードの場合のみ、メタデータが管理するプロジェクションとスコープ内の Codex 対応スキルを再生成して終了します。

--check は読み取り専用です。--strict を指定すると、検出事項が 1 つでもあれば終了コード 1 になります。修復に失敗した場合は呼び出し元に返されます。このスキルは再試行したり、別のアクションを選択したりしません。

詳細コンテンツ監査

オプションの読み取り専用コンテンツ監査は次のとおりです。

bash skills/heal-skill/scripts/audit.sh [--strict] [--json <path>] skills/<slug>

構造チェックの結果に、決定論的な作成チェックと参考用の品質スコアを組み合わせます。これはコアの Validate フェーズではなく、verdict.v2 を書き込まず、成果物の提供を決定する権限もありません。チェックの定義は audit-checks.md に、密度スコアの説明は context-density-checks.md にあります。

出力

構造上の検出事項は次の形式で出力されます。

[FINDING_CODE] skills/example: concrete explanation

詳細監査の JSON は audit-report.json に準拠します。 その後の編集や呼び出しは、呼び出し元が管理します。

チェック項目

• チェックモードではファイルを変更しません。
• 修復モードでは、明示的に指定されたソースターゲットと、その管理対象プロジェクションのみを変更します。
• 同じ修復を再度実行しても、結果は変わりません。
• 生成される Codex 対応スキルとの整合性は、codex-parity.md に従います。
• 修復できない検出事項は、明示されたまま残ります。

関連する実行可能な仕様

• heal-skill.feature
• skill-auditor.feature