costajohnt/oss-scout

oss-scout は何をしますか？

あなたのコントリビューション履歴に基づいてパーソナライズされたオープンソースのissueを発見します。3つの戦略による検索、詳細な評価、実行可能性スコアリング。

概要

oss-scout は、あなたの過去の貢献パターンを分析し、オープンソースプロジェクト内で最も適切なissueを特定して推薦するAIエージェントスキルです。単なるキーワード検索ではなく、以下の3つの戦略を組み合わせます。

1. キーワードマッチング: あなたが以前に貢献したプロジェクトで使用された技術キーワードに基づいてissueを検索します。
2. スキルベース推薦: あなたのGitHubプロフィールやコントリビューションログから推測されるスキルセットにマッチするissueを見つけます。
3. 関連プロジェクト探索: あなたが貢献したプロジェクトと依存関係やテーマが似ているプロジェクトからissueを探索します。

使い方

1. oss-scout をAIエージェント（例：Claude Code）にインストールします。
2. エージェントに対して、あなたのGitHubユーザー名または組織を指定します。
3. スカウトがあなたの履歴を分析し、優先順位付けされたissueのリストを生成します。
4. 各issueには実行可能性スコアが付与され、どのissueに取り組むべきかの判断を支援します。

設定

環境変数:

• GITHUB_TOKEN: GitHub API にアクセスするためのトークン（必須）
• OSS_SCOUT_MAX_RESULTS: 返される最大結果数（デフォルト: 10）
• OSS_SCOUT_MIN_SCORE: 最小実行可能性スコア（0.0～1.0、デフォルト: 0.3）

実行可能性スコアリング

各issueは以下の要素に基づいてスコアリングされます:

• コードベースとの親和性（あなたのスキルとのマッチ度）
• 議論の活発さ（コメント数、最近の更新）
• メンテナーの反応性（平均応答時間）
• issueの複雑さ（ラベル、説明の明確さ）

スコアが高いほど、あなたがそのissueに貢献しやすいことを示します。

例

# Claude Code での使用例（指示）
「oss-scout を使って、@あなたのユーザー名 に適したオープンソースのissueを見つけてください」

対応プラットフォーム

• Claude Code
• Cursor
• Codex
• その他のAIエージェント（カスタム統合可能）

ライセンス

MIT