find-reuse について
Markdown リクエストを基に再利用可能なソフトウェアを検索し、構造化レポートを作成するポータブルなスキルです。関連するリポジトリやレジストリの根拠が必要な利用元を対象とし、リポジトリの変更やレポートの扱いの判断は行いません。
主な機能
- 01リクエスト契約の検証
- 02対象となる検索先の特定
- 03ツールの確認と検索範囲の不足記録
- 04検索結果の補足と統合
- 05要件・出所・保守状況の比較
- 06バージョン付き Markdown レポートの作成
活用シーン
- 01指定された機能に使えるコンポーネントの検索
- 02リポジトリやレジストリをまたいだ候補の比較
- 03利用できない検索先を範囲不足として記録
- 04リポジトリを変更せず再利用レポートを作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shkarupa-alex/ meta-o --skill find-reuseインストール後、Claude Code で/find-reuseを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/cases.jsonreferences/adapters.jsonadapters.mdcontracts.md詳細
再利用可能なソリューションを探す
このスキルは、どこでも利用できるレポート作成ツールです。呼び出し元固有のパス、機能のライフサイクル、保存先ドキュメント、コミット方針は把握しません。リポジトリのファイルへの書き込み、ツールのインストール、ログイン、認証情報の値の要求は行いません。
検索を始める前に、リクエストとレポートの契約と ソースアダプターの契約を最後まで読んでください。
入力
YAML ブロックで contract: find-reuse.request.v1 を宣言する Markdown リクエストのみ受け付けます。契約がない場合や不明な場合は、検索前に拒否してください。すべてのビジネス要件 ID と優先度を保持してください。
検索
- リクエスト、リポジトリのリモート、マニフェスト、ロックファイル、インポートから、該当する対象を検出します。認証がなくても、名前が指定されたプライベートソースは対象に含めます。
- 使用前に、必要な各ツールとその正確な機能を確認します。利用できない場合は、OS に応じたインストールまたはログイン方法を案内しますが、インストールや認証は行いません。
- コマンドは引数配列として実行します。クエリをシェル文字列に埋め込んではいけません。エラーは空の結果ではなく、カバレッジの不足として記録します。
- 該当するすべての対象で必要な探索を実行してから、候補をソースホストとレジストリの両方が存在する場合は、それぞれの情報で補足します。
- ID の統合は、信頼できるパッケージメタデータまたはリポジトリが所有する証拠がある場合に限ります。フォーク、ミラー、モノレポのメンバーは個別に扱います。
- 要件、統合コスト、出所、ライセンス、メンテナンス状況、採用状況、セキュリティの証拠を比較します。ソース、観測時刻、指標の対象期間を保持し、異なるエコシステム間の人気度を同一の尺度で比較してはいけません。
エコシステムが特定されていない新しいコンポーネントの場合は、GitHub と GitLab に加え、利用が認められているスタックのうち最適な 2 つに対応するレジストリを検索し、その選定理由を記録します。
出力
find-reuse.report.v1 形式の完全な Markdown ドキュメントを 1 つだけ返してください。リポジトリを変更したと誤解させる記述は含めないでください。失敗や不明点も含め、必須のセクションと該当するすべての対象を記載します。
build が許可されるのは coverage: complete の場合のみです。必須ツール、認証、ソース、または情報補完のいずれかを利用できない場合は、status: unknown と coverage: partial|blocked を返します。検索が成功して初めて、真の結果なしを証拠として扱えます。
このスキルは、レポートの保存先や、unknown の後に実装を進めてよいかどうかを判断しません。それらの判断は呼び出し元に委ねられます。