agent-sort

agent-sort スキルの概要

agent-sort は、広い ECC 構成を、証拠に基づいたより小さなインストール対象へと絞り込むための、リポジトリ認識型のプランニングスキルです。毎日読み込むべきものと、ライブラリとして検索可能に残すべきものを見極めるのに役立ち、プロジェクトで使わない skill、rules、hooks、scripts を過剰にインストールしないようにします。

これは、メンテナー、エージェントワークフローのオーナー、そして既存リポジトリで agent-sort install を行う人に最適です。実際にやるべき仕事は「ファイルを整理すること」ではなく、コードベースの実態に基づいて、推測を減らし ECC ノイズを抑えた、妥当性のあるインストール計画を作ることです。

agent-sort は何のためのものか

リポジトリ固有の ECC 要素を実用的な区分に分類したいときに、agent-sort スキルを使います。特に、ワークフローが混在しているプロジェクトや、ECC の導入が部分的なプロジェクトで有効です。日常的に読み込む面は絞り込みつつ、後で参照するための資料は残しておきたい場合に向いています。

何が違うのか

agent-sort スキルは証拠ベースです。インストール計画を決めるのは個人の好みではなく、リポジトリの内容そのものです。最大の価値は、誤って不要なものをインストールするのを防ぎ、プロジェクトが実際に使っているものを浮かび上がらせることにあります。そのため、一般的なプロンプトよりも、判断そのものに強く寄っています。

向いているケースと向いていないケース

ECC はあるものの、範囲が広すぎる、重複が多すぎる、あるいはプロジェクトの実際のワークフローからずれているリポジトリに向いています。一方で、リポジトリの要約を素早く一度だけ出したい場合や、そもそも ECC ネイティブな面を使っていないプロジェクトでは、適性は高くありません。

agent-sort スキルの使い方

インストールとコンテキストの準備

対象リポジトリで agent-sort install の流れを始めてから、skills/agent-sort/SKILL.md を運用ガイドとして読みます。このスキルは、リポジトリの証拠をもとに動くよう設計されているため、単独で使うのではなく、評価対象のリポジトリと一緒にインストールしてください。

出力品質を上げる入力

具体的な対象リポジトリ、明確なスコープ、そして知りたい判断境界を与えてください。良い入力例は「このリポジトリの ECC 面を、現在のアプリ向けに DAILY と LIBRARY に分け、通常のエージェント実行に必要なものだけを残してほしい」です。弱い入力は「プロジェクトを整理して」「もっときれいにして」のように曖昧です。

推奨ワークフロー

まず、リポジトリ自身の README、AGENTS 形式の指示、ECC 関連のフォルダや manifest ファイルを確認します。次に agent-sort usage を使って、具体的な証拠を daily-load 候補、library-only の参照物、そしてインストール対象にすべきでないものへ対応づけます。目的は、推測で構成を変えることではなく、検証手順を伴う簡潔なインストール計画を作ることです。

最初に読むファイル

まず SKILL.md を読み、その後でリポジトリツリーを見て README.md、AGENTS.md、metadata.json、および rules/、resources/、references/、scripts/ 配下のフォルダを確認してください。このリポジトリでは、補助ファイルがないため SKILL.md が主な情報源です。

agent-sort スキル FAQ

agent-sort は ECC プロジェクト専用ですか？

はい。agent-sort は ECC ネイティブな面とインストール判断を前提に作られています。そのパターンを使っていないリポジトリでは、通常のプロンプトのほうがシンプルで、agent-sort スキルより適しています。

通常のプロンプトとどう違いますか？

通常のプロンプトでも素早い提案はできますが、agent-sort は証拠に裏打ちされた分類とインストール計画を求めます。リポジトリ全体で一回限りの意見ではなく、agent-sort usage を繰り返し再現したいときに、この違いが重要になります。

agent-sort は初心者向けですか？

評価したいリポジトリを特定でき、まずソースツリーを読む意思があるなら、初心者でも使いやすいです。必要なのは深い ECC の専門知識ではなく、何を毎日インストールし、何をライブラリとして残すかを明確にすることです。

どんなときに agent-sort を使うべきではありませんか？

一般的なリポジトリ要約だけが必要なとき、プロジェクトに仕分けるべき ECC 面がないとき、あるいはインストール判断ではなく広いリファクタリングを求めているときは使わないでください。その場合、agent-sort for Skill Authoring のオーバーヘッドは不要です。

agent-sort スキルの改善方法

リポジトリの証拠をより具体的に示す

agent-sort の最良の結果は、ファイルパス、現在のワークフロー名、エージェントが実際に触るものの例といった、具体的なリポジトリのシグナルから得られます。コマンド、フォルダ、ルールファイルを特定できれば、daily/library の切り分けはより正確になります。

インストール境界を明確にする

リポジトリ全体を対象にするのか、サブパッケージなのか、あるいは狭いワークフローなのかをはっきり伝えてください。境界が明確だと、agent-sort install 作業で参照資料を daily load に過剰分類してしまう、よくある失敗を防げます。

初回結果で過剰な読み込みがないか確認する

出力が重すぎると感じたら、毎回本当に必要なものと、参照用にあれば十分なものを分けて尋ねてください。最も有効な反復は、日常インストールを絞り込み、理論上の有用性ではなく、実際の通常利用に合う計画へ近づけることです。

役立つライブラリ資料は残す

優れた agent-sort guide は、毎日使わないものをすべて削除するものではありません。後続の判断を支える境界線上の項目は、ライブラリに残してください。スキルの目的はデフォルトの読み込み量を減らすことであって、プロジェクトの知識を消すことではありません。