mcpField
E
ecc-skill-defer

ecc-skill-defer

github.com/ashe-liエージェントワークフロー238 回インストール1 日前に更新
リポジトリ

ecc-skill-defer について

ECC skills の defer と restore 状態を管理するコマンドラインスクリプトです。初期化時のトークン消費を抑えるため、状態確認、設定に基づく defer、復元、実行後の検証を行います。

主な機能

  1. 01skill の状態と一覧の確認
  2. 02設定に基づく skill の defer
  3. 03個別または全 skill の復元
  4. 04defer 理由の記録
  5. 05操作後の状態検証

活用シーン

  1. 01active と deferred の skill の確認
  2. 02ECC 更新後の defer 設定の適用
  3. 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.md
DEFER_REFERENCE.md
ecc-skill-defer.conf
ecc-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 --alldefer 済みのスキルをすべて復元します
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 のリソース割り当ての品質が失われます。

  1. defer を確認 — 影響を理解したうえで、続行します
  2. キャンセル — これらのスキルを保持し、apply を実行しません

ユーザーが明示的に「defer を確認」を選択した場合にのみ、apply の実行を続けます。

apply 操作の検証(根拠:DAMA-DMBOK Completeness — manifest vs. actual)

apply の実行後、list を使って状態を必ず再検証します。

  1. apply の実行前に、defer する予定のスキル一覧(manifest)を記録します

  2. apply の完了後、list を実行して現在の状態を取得します

  3. manifest と照合し、各項目を検証します(根拠:OpenAI Developer Community の合意 — チェックリスト主導):

    Skill期待される状態実際の状態結果
    foodeferreddeferredPASS
    bardeferredactiveFAIL
  4. FAIL が 1 つでもある場合 → 警告を出力し、ecc-skill-defer.conf とスクリプトの実行結果を手動で確認するよう促します

  5. すべて PASS の場合 → 現在利用可能なスキル一覧を出力し、ユーザーが利用可能なリソースを把握できるようにします

restore 操作の検証(根拠:DAMA-DMBOK Completeness)

restore <name> または restore --all の実行後:

  1. list を実行し、対象スキルの状態が active であることを検証します
  2. 検証結果を出力します:[PASS] <skill> は active に復元されました または [FAIL] <skill> の状態はまだ deferred です
  3. ユーザーに次のように伝えます:「スキルが復元されました。次のセッション(またはコンテキストの再読み込み後)に利用可能になります。」

コメント