mcpField
S
skill-prune

skill-prune

github.com/transilienceaiエージェントワークフロー598150 回インストール13 週間前に更新
リポジトリ

skill-prune について

skill-pruneは、エージェントスキルの孤立・古い・重複した内容を整理する保守用スキルです。明確な基準と安全ルールで候補を評価し、削除は承認済みの計画に基づいて行います。

主な機能

  1. 01内容を整理する4つの基準
  2. 02保護対象ファイルの安全確認
  3. 03理由付きの削除計画
  4. 04整理後のリンクと重複の確認

活用シーン

  1. 01定期的なスキルの保守
  2. 02リンターが報告した孤立項目の確認
  3. 03上限を超えたスキルファイルの整理
  4. 04終了した課題に関する内容の削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/transilienceai/communitytools --skill skill-prune

インストール後、Claude Code で/skill-pruneを入力して読み込まれたか確認します。

詳細

スキルの整理

/skill-updateの逆です。内容を追加するのではなく削除します。四半期ごとのメンテナンス時、エンゲージメント終了後、またはscripts/skill_linter.pyが孤立項目や重複を報告したときに実行します。

実行するタイミング

  • 四半期ごとの定期実行時。
  • scripts/skill_linter.py --check-orphansが孤立した参照ファイルを報告した後。
  • SKILL.mdまたは参照ファイルが上限を超え、内容を削る必要があるとき。
  • 専門性を下げるための一斉見直し後、終了した課題に関連する内容を削除するとき。

整理の基準(4つのシグナル — /skill-updateと同じ形式で、逆の操作)

参照ファイル/シナリオ/行は、次のいずれかに該当する場合、削除候補になります。

  1. 孤立 — 過去60日間、どのSKILL.mdや他の参照ファイルからもリンクされていない。
  2. 失敗したエンゲージメントからのみ参照されている — status=BLOCKEDで終了した実行のattack-chain.mdに登場し、成功したチェーンには一度も登場していない。
  3. 新しい内容と矛盾している — 後から追加されたシナリオ/パターンに置き換えられており、古い項目が現在の手法を反映していない。
  4. 新しい内容と重複している — 同じ手法が他の場所で、より明確に説明されている。

これらのいずれにも該当しない内容は削除せず、残します。

安全ルール

  • ``注釈が付いたファイルは、絶対に削除しないでください。
  • 進行中のエンゲージメントのOUTPUT_DIR/attack-chain.mdで引用されている内容は、絶対に削除しないでください。
  • 単一オーナールール(brute-force、output-discipline、env-reader、skill-update)の標準配置ファイルは、絶対に削除しないでください。
  • 運用上の知識よりも、技術的な内容が豊富なものを残すようにしてください。

手順

  1. scripts/skill_linter.py --check-orphansを実行して孤立項目を洗い出します。
  2. 候補となるファイルまたはブロックごとに、4つのシグナルを評価します。
  3. 削除計画を作成します。削除するファイル/行と、それぞれの簡潔な理由を示します。
  4. 計画の承認後にのみ削除を適用します(skill-pruneは実行時に自動削除しません)。
  5. scripts/skill_linter.pyを再実行し、変更によって他のリンクが壊れていないこと、重複が再発していないことを確認します。

出力

簡潔な変更レポート:

  • 削除済み。 ファイルまたはブロックと、それぞれの簡潔な理由。
  • 保持(要フォローアップ)。 4つのシグナルのいずれにも該当しないものの、次の四半期に再確認する価値がある項目。
  • 削除なし。 削除に値するものがなかった場合は、明示します。

アンチパターン

  • 古いという理由だけで内容を削除すること — 古さだけではシグナルにならず、重要なのは関連性です。
  • 親のSKILL.mdが肥大化しているという理由で参照ファイルを削除すること — SKILL.mdのほうを修正してください。
  • 単一オーナーの標準配置ファイル(brute-force/output-discipline/env-reader)を削除すること。
  • 内容が参照される可能性のある進行中のエンゲージメント中に削除すること。

コメント