Communitygithub.com

zhaidewei/keep-or-sweep

Keep or Sweep – 証拠に基づいてアセットを監査し、「Keep」「Repair」「Archive」「Delete」「Pause」のいずれかの処分を決定するAIエージェントスキル。

keep-or-sweep とは?

「Keep or Sweep」は、AIエージェントに明確に定義された単一のアセット(コードベース、サービス、ドキュメントなど)を証拠に基づいて監査・処分するためのスキルです。このスキルは、エージェントがシステム全体の重複排除や大規模な整理ではなく、一つひとつのアセットに焦点を当てて調査し、Read-onlyインベントリ収集、削除反実仮想テスト、役割分類を経て、Keep(保持)、Repair or Replace(修理・交換)、Archive(アーカイブ)、Delete(削除推奨)、Pause(一時停止)の5つの処分から正確に一つを選択することを促します。主な対応プラットフォームはClaude CodeやCursor、CodexなどのAIエージェント環境で、SKILL.mdに定義されたワークフローと決定木に沿って動作します。このスキルの価値は、曖昧な「使われていないから消す」という判断を防ぎ、実際の利用者や依存関係、法的保管義務などの具体的な証拠に基づいて安全かつ責任ある処分判断を行う点にあります。また、権限外の削除実行を禁止し、常にRead-only監査に留めることで、誤操作による不可逆的損失を防止します。

対応~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Keep or Sweep

明確に範囲が定められた1つのアセットを監査してください。これを組織全体の重複排除や正規本拠地の特定に拡大しないでください。

ワークフロー

  1. アセットの範囲を設定する。 正確なターゲット名、所有者または権限者、許可された操作、影響範囲を指定します。リクエストに複数の独立したアセットが含まれている場合は、この監査で1つの明確なターゲットを選択し、残りは対象外としてリストアップします。同じ監査内でリストを続けて処理しないでください。
  2. 読み取り専用でインベントリを収集する。 実際の利用者、呼び出し元、トリガー、依存関係、入力、出力、契約、生成されたコピー、履歴、保管義務、ランタイムでの使用状況を調査します。名前と振る舞いを検索しますが、動的な利用や利用できない権限は不明のままです。
  3. 削除反実仮想をテストする。 アセットが消失した場合に、どの観測可能なユーザーまたはエージェントの振る舞いが悪化するかを述べてください。名前の一致や類似した形状は冗長性を証明しません。
  4. 役割を分類する。 真実の源泉、プロジェクション、アダプターは役割であり、判定ではありません。プロジェクションの場合は、利用者固有の価値、ソースとの整合性、再生成または同期、および所有者、トリガー、ドリフト検出、修復パスを含むメンテナンスメカニズムを確認します。
  5. 正確に1つの処分を選択する。
    • Keep(保持): 証拠のある価値と信頼できるメンテナンスメカニズムがある場合。
    • Repair or replace(修理または交換): 証拠のある利用者がいるが、現在のメカニズムが信頼できない場合。
    • Archive(アーカイブ): ライブでの使用はないが、法的、歴史的、監査、または契約上の保管義務が存在する場合。
    • Delete(削除): 観測可能な振る舞いが悪化せず、保管義務も適用されない場合。これは推奨であり、実行を許可するものではありません。
    • Pause(一時停止): 証拠、権限、許可、回復可能性、または不可逆リスクの分析が不十分な場合。
  6. 権限の範囲内でのみ実行する。 読み取り専用の監査は、削除、上書き、リモートステートの変更、または不可逆的な変更を行う許可を決して意味しません。削除前に回復方法を明示します。削除後は、期待される利用者を確認し、まだ証明されていないものを報告します。

決定木

flowchart TD
    A["1つのアセットの範囲を設定し<br/>読み取り専用でインベントリ収集"] --> B{"証拠は十分か?"}
    B -- "いいえ" --> P["一時停止し、不足している<br/>証拠を明示"]
    B -- "はい" --> C{"削除により観測可能な<br/>振る舞いが悪化するか?"}
    C -- "不明" --> P
    C -- "いいえ" --> D{"保管義務はあるか?"}
    D -- "はい" --> R["アーカイブ"]
    D -- "いいえ" --> X["削除を推奨"]
    C -- "はい" --> F{"メンテナンスメカニズムは<br/>信頼できるか?"}
    F -- "はい" --> K["保持"]
    F -- "いいえ" --> N["修理または交換"]

未知の利用者、動的な呼び出し、アクセス権限の欠如、証拠の不在は、未使用を意味しません。不明な場合は一時停止し、処分を変えうる最小の次のチェック項目を特定します。

関連スキル