ecc-skill-defer について
ECC skills の defer と restore 状態を管理するコマンドラインスクリプトです。初期化時のトークン消費を抑えるため、状態確認、設定に基づく defer、復元、実行後の検証を行います。
主な機能
- 01skill の状態と一覧の確認
- 02設定に基づく skill の defer
- 03個別または全 skill の復元
- 04defer 理由の記録
- 05操作後の状態検証
活用シーン
- 01active と deferred の skill の確認
- 02ECC 更新後の defer 設定の適用
- 03必要な skill の復元と状態確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ ashe-li/ agent-skills --skill ecc-skill-deferインストール後、Claude Code で/ecc-skill-deferを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
DEFER_LOG.mdDEFER_REFERENCE.mdecc-skill-defer.confecc-skill-defer.sh詳細
/ecc-skill-defer — ECC Skill の段階的読み込み管理
ECC スキルの defer/復元状態を管理し、初期化時のトークン消費を削減します。
手順
このスキルのディレクトリにあるスクリプトを実行します:ecc-skill-defer/ecc-skill-defer.sh(skills リポジトリのルートからの相対パス)、またはインストール済みのコピー ~/.claude/scripts/ecc-skill-defer.sh。
使用可能なコマンド
| コマンド | 説明 |
|---|---|
status | 有効/defer 済みの数を表示します |
list | すべてのスキルとその状態を表示します |
apply | 設定ファイルに記載されたスキルを defer します(ECC の更新後に使用) |
restore <name> | defer 済みのスキルを 1 つ有効化します |
restore --all | defer 済みのスキルをすべて復元します |
apply --reason "<text>" | 明示した理由を DEFER_LOG.md に記録して defer します |
デフォルトの動作
ユーザーから引数が指定されない場合は、status を実行してから list を実行します。
設定
defer リストは ecc-skill-defer.conf にあります(スクリプトと同じディレクトリ)。defer リストのスキルを追加/削除するには、このファイルを編集してから apply を実行します。
スキルを復元した後
ユーザーに次のように伝えます:「スキルが復元されました。次のセッション(またはコンテキストの再読み込み後)に利用可能になります。」
注意事項
- defer 理由の追跡:
apply --reasonは defer の理由をDEFER_LOG.mdに追記専用で記録します。形式は<date> | <skill> | <reason>です。listコマンドでは、最後に defer した理由を任意で表示できます。 - ポートフォリオの健全性確認: defer/復元の操作後は、現在のスキル構成に冗長性や不足がないか確認するため、
/skill-healthの実行をおすすめします。
コアスキルの保護(HITL ガード)
apply を実行する前に、defer する予定のスキル一覧(ecc-skill-defer.conf)を必ず確認してください。
一覧に design または assist が含まれている場合は、AskUserQuestion を使用して必ず確認します(これはハードストップであり、省略できません)。
defer する予定の一覧に、コア計画スキルが含まれています:
- [検出されたコアスキルを列挙]
design/assist はコア計画スキルです。defer すると、業界/学術的な参照能力と ECC のリソース割り当ての品質が失われます。
- defer を確認 — 影響を理解したうえで、続行します
- キャンセル — これらのスキルを保持し、apply を実行しません
ユーザーが明示的に「defer を確認」を選択した場合にのみ、apply の実行を続けます。
apply 操作の検証(根拠:DAMA-DMBOK Completeness — manifest vs. actual)
apply の実行後、list を使って状態を必ず再検証します。
-
apply の実行前に、defer する予定のスキル一覧(manifest)を記録します
-
apply の完了後、
listを実行して現在の状態を取得します -
manifest と照合し、各項目を検証します(根拠:OpenAI Developer Community の合意 — チェックリスト主導):
Skill 期待される状態 実際の状態 結果 foo deferred deferred PASS bar deferred active FAIL -
FAIL が 1 つでもある場合 → 警告を出力し、
ecc-skill-defer.confとスクリプトの実行結果を手動で確認するよう促します -
すべて PASS の場合 → 現在利用可能なスキル一覧を出力し、ユーザーが利用可能なリソースを把握できるようにします
restore 操作の検証(根拠:DAMA-DMBOK Completeness)
restore <name> または restore --all の実行後:
listを実行し、対象スキルの状態がactiveであることを検証します- 検証結果を出力します:
[PASS] <skill> は active に復元されましたまたは[FAIL] <skill> の状態はまだ deferred です - ユーザーに次のように伝えます:「スキルが復元されました。次のセッション(またはコンテキストの再読み込み後)に利用可能になります。」