Important
このリポジトリのリリースノートやREADME、コミットメッセージの9割近くはclaude.aiやChatGPT4を活用したAIRA, SourceSage, Gaiah, HarmonAI_IIで生成しています。
I.R.I.S（Intelligent Repository Issue Solver）は、GitHubリポジトリのイシュー管理を劇的に向上させるインテリジェントアシスタントです。機械学習と自然言語処理を活用し、イシューの自動分類、優先順位付け、解決策の提案を行います。
初めての方でも簡単に使い始められるよう、以下では詳しい説明と手順を記載しています。
IRISは以下の3つの主要な自動化領域で強力な機能を提供します：
-
インテリジェントな自動ラベリング：
- 新規イシューの内容をAIが分析し、適切なラベルを自動付与
- Google Gemini AIなどの高度な自然言語処理モデルを活用
- プロジェクト固有のラベルをCSVファイルで簡単に定義・管理
-
詳細なイシュー分析と対応：
- イシューに対する深い洞察を含む詳細コメントを自動生成
- 具体的な変更提案を作成し、プルリクエスト作成をサポート
- 自動リリースノート生成：
- タグ付与時に対応するリリースノートを自動作成
- プロジェクトの進捗と変更点を簡潔かつ正確に記録
-
READMEの自動メンテナンス：
- 新リリース情報を自動的にREADMEに反映
- 最新の機能や変更点を常にドキュメントに反映
-
多言語サポート：
- 日本語READMEの更新に合わせて英語版READMEを自動生成
- プロジェクトの国際的な可視性と理解を促進
- 24/7稼働：GitHubアクションを活用し、人間の介入なしで常時運用
- 高度なカスタマイズ性：プロジェクトの特性に合わせて各機能を柔軟に調整可能
- 継続的な学習と改善：AIモデルの定期的な更新により、パフォーマンスが常に向上
IRISを導入することで、開発チームはコア開発業務に集中でき、プロジェクト管理の効率が大幅に向上します。
IRIS/
├─ .github/
│ ├─ scripts/
│ │ ├─ deep_comment.py
│ │ ├─ suggest_changes.py
│ │ ├─ label_adder.py
│ │ └─ generate_github_release_notes.py
│ ├─ workflows/
│ │ ├─ issue-deep-comment.yml
│ │ ├─ issue-review.yml
│ │ └─ generate-release-notes.yml
│ ├─ services/
│ │ └─ github_service.py
│ └─ config.py
├─ docs/
│ └─ .sourcesage_releasenotes.yml
└─ README.mdIRISは以下の2つの方法でセットアップできます：
-
iris-coonコマンドを使用する方法
IRISをセットアップする最も簡単な方法は、
iris-coonコマンドを使用することです。以下のコマンドでインストールとセットアップができます：pip install iris-coon iris-coon
このコマンドを実行すると、必要なファイルとフォルダが現在のディレクトリにコピーされます。
-
手動で.githubフォルダをコピーする方法
IRISの機能を既存のプロジェクトに追加したい場合は、以下の手順で.githubフォルダを直接コピーできます：
git clone https://github.com/Sunwood-ai-labs/IRIS.git cp -r IRIS/.github /path/to/your/project/
この方法では、IRISの.githubフォルダとその内容が、指定したプロジェクトディレクトリにコピーされます。必要に応じて、コピーしたファイルを編集してプロジェクトに合わせてカスタマイズできます。
IRISを正常に機能させるためには、以下のGitHubシークレットを設定する必要があります。これはどちらのセットアップ方法を選択した場合も必要な手順です。
- GitHubリポジトリページの「Settings」タブを開く
- 左側メニューから「Secrets and variables」→「Actions」を選択
- 「New repository secret」ボタンをクリック
| シークレット名 | 説明 | 用途 |
|---|---|---|
GITHUB_TOKEN |
GitHubのパーソナルアクセストークン | リポジトリへのアクセス権限 |
GEMINI_API_KEY |
Google AI StudioのAPIキー | AI機能の利用 |
YOUR_PERSONAL_ACCESS_TOKEN |
GitHubパーソナルアクセストークン | リポジトリへの書き込み権限 |
YOUR_PERSONAL_ACCESS_TOKEN_IRIS |
IRIS専用のアクセストークン | IRIS固有の操作権限 |
Warning
これらのキーの取得方法については、各サービスの公式ドキュメントを参照するか、必要に応じて開発者にお問い合わせください。
- これらのトークンは極めて重要な認証情報です。安全に管理し、決して公開リポジトリに直接記載しないでください。
- 定期的にトークンをローテーション（更新）することをお勧めします。
- 各トークンに必要最小限の権限のみを付与し、原則of最小権限を守ってください。
IRISをPythonライブラリとして使用したい場合は、example/demo.pyファイルを参考にしてください。このデモファイルには、IRISの主要な機能を使用する方法が示されています。
例えば：
from iris_coon import IrisCoon
# IRISのセットアップ
coon = IrisCoon(target_dir="path/to/your/project", force=True)
coon.run()詳細な使用方法と高度な設定については、example/demo.pyファイルを確認してください。
IRISをセットアップすると、以下の自動化された機能が利用可能になります：
-
イシュー管理の自動化:
- 新しいイシューが作成されると、IRISが自動的に起動します。
- AIがイシューの内容を分析し、適切なラベルを提案・適用します。
- イシューに詳細なコメントが自動追加されます。
- 必要に応じて、コードの変更提案が生成されます。
-
リリース管理の自動化:
- タグが付与されると、そのタグに対応する自動リリースノートが生成されます。
- 新しいリリースが発生すると、READMEが自動更新されます。
-
ドキュメンテーションの自動化:
- READMEが更新されると、自動的に英語版README（
README.en.md）が生成されます。
- READMEが更新されると、自動的に英語版README（
新しいバージョンをリリースする準備ができたら、以下のようにタグを付けるだけです：
git tag v1.0.0
git push origin v1.0.0これにより、v1.0.0に対応する詳細なリリースノートが自動的に生成されます。
-
リリースノートが生成されると、IRISはREADMEを自動更新し、新機能や重要な変更点を反映します。
-
その後、更新されたREADMEの内容に基づいて、英語版の
README.en.mdが自動生成されます。
これらの自動化プロセスにより、以下のメリットが得られます：
- プロジェクトドキュメントが常に最新状態に保たれます。
- 開発者の作業負荷が大幅に軽減されます。
- 国際的なユーザーへのアクセシビリティが向上します。
IRISを導入することで、開発チームはコア機能の開発により多くの時間を割くことができ、プロジェクト管理の効率が大幅に向上します。
iris-coon コマンドは、以下のオプションをサポートしています：
| オプション | 短縮形 | 説明 | デフォルト値 |
|---|---|---|---|
--target |
-t |
ファイルをコピーするターゲットディレクトリ | 現在の作業ディレクトリ |
--force |
-f |
既存のファイルを強制的に上書き | False |
--exclude |
-e |
コピーから除外するファイルのリスト | ["publish-to-pypi.yml"] |
-
デフォルト設定でIRISをセットアップ：
iris-coon -
特定のディレクトリにIRISをセットアップ：
iris-coon --target /path/to/your/project -
強制的に既存ファイルを上書きしてセットアップ：
iris-coon -f -
特定のファイルを除外してセットアップ：
iris-coon --exclude config.yml secrets.yml -
複数のオプションを組み合わせて使用：
iris-coon -t /path/to/project -f --exclude config.yml
Warning
--force オプションを使用する際は、既存のファイルが上書きされる可能性があるため注意してください。
- v0.6.1: IRIS v0.6.1 は、GitHub リポジトリのイシュー管理をさらに効率化するための新機能と改善点を含むマイナーリリースです。今回のリリースでは、IRIS を簡単にセットアップできる新しいパッケージ
iris-coonが導入されました。 - v0.6.0: Iris Coonパッケージの導入: IRISリポジトリをクローンし、.githubフォルダをコピーする機能を提供する新しいパッケージです。
- v0.5.5: README自動更新処理の改善、英語READMEの更新、ヘッダー画像の更新。
- v0.5.4: 英語READMEの更新、SourceSageの設定ファイルのバージョン情報の更新、不要なREADMEの記述の削除、README自動更新機能の改善、いくつかのコード変更。
- v0.5.3: READMEの自動更新、タグ付与によるリリースノート作成、英語README作成など、新機能と改善点が追加されました。
- v0.5.1: ドキュメントと構造を改善し、ユーザーエクスペリエンスを向上させました。
- v0.5.0: リリースノートの自動生成、READMEの自動更新、ヘッダー画像の生成など、新たな機能が追加されました。
- v0.4.0: 自動リリースノート生成機能の追加(実験的機能)、GitHub Serviceの改善
- v0.3.0: 詳細コメント生成機能、変更提案機能の追加
- v0.2.0: Google Generative AI統合、ラベル管理システムの改善、ユーザビリティの向上
- v0.1.0: イシュー自動ラベリング機能の実装
IRISの動作フローを以下の図で説明します：
%%{init:{'theme':'base','themeVariables':{'primaryColor':'#024959','primaryTextColor':'#F2C335','primaryBorderColor':'#F2AE30','lineColor':'#A1A2A6','secondaryColor':'#593E25','tertiaryColor':'#F2C335','noteTextColor':'#024959','noteBkgColor':'#F2C335','textColor':'#024959','fontSize':'18px'}}}%%
sequenceDiagram
participant User as 👤 User
participant GitHub as 🐙 GitHub
participant IRIS as 🤖 I.R.I.S
participant AI as 🧠 AI Models
participant Labels as 📋 Labels
alt イシュー管理の自動化
User->>GitHub: イシューを作成
GitHub->>IRIS: GitHub Action トリガー
IRIS->>GitHub: イシュー内容を取得
GitHub-->>IRIS: イシュー詳細
IRIS->>AI: 内容を分析リクエスト
AI-->>IRIS: 分析結果
IRIS->>Labels: 提案されたラベルを照合
Labels-->>IRIS: 有効なラベル
IRIS->>GitHub: 検証済みラベルを適用
IRIS->>AI: 詳細コメント生成リクエスト
AI-->>IRIS: 生成された詳細コメント
IRIS->>GitHub: 詳細コメントを追加
IRIS->>AI: 変更提案生成リクエスト
AI-->>IRIS: 生成された変更提案
IRIS->>GitHub: 変更提案を追加
GitHub-->>User: イシュー更新通知
end
alt リリース管理の自動化
User->>GitHub: タグを作成/プッシュ
GitHub->>IRIS: タグイベント通知
IRIS->>AI: リリースノート生成リクエスト
AI-->>IRIS: 生成されたリリースノート
IRIS->>GitHub: リリースノートを作成
GitHub-->>User: リリース通知
end
alt ドキュメンテーションの自動化
IRIS->>AI: README更新リクエスト
AI-->>IRIS: 更新されたREADME内容
IRIS->>GitHub: READMEを更新
IRIS->>AI: 英語版README生成リクエスト
AI-->>IRIS: 生成された英語版README
IRIS->>GitHub: 英語版READMEを追加/更新
GitHub-->>User: ドキュメント更新通知
end
IRISの開発に携わる方向けのコマンドです：
AIRAを使用してコミットメッセージを生成：
aira --mode sourcesage commit --config=.aira\config.dev.commit.yml --ss-model-name="gemini/gemini-1.5-pro-latest" --llm-output="llm_output.md"SourceSageを使用してリリースノートを生成：
sourcesage --ss-mode=DocuMind --yaml-file=docs\.sourcesage_releasenotes.ymlプロジェクトへの貢献を歓迎します！以下の方法で貢献できます：
- イシューを作成して改善点や問題点を報告
- 新機能の提案
- プルリクエストを送信してコードを改善
初めての方は、First Contributions のガイドを参考にしてみてください。
このプロジェクトはMITライセンスの下で公開されています。使用、複製、変更、配布の際はライセンス条項をご確認ください。
- Google - Gemini AIの提供
- GitHub - アクションと開発プラットフォームの提供
- すべてのコントリビューターとユーザーの皆様
質問やサポートが必要な場合は、以下の方法でお問い合わせください：
- GitHubのIssuesページで新しいイシューを作成
- 公式ウェブサイトのお問い合わせフォームを利用
- Twitterでダイレクトメッセージを送信
初心者の方も気軽にお問い合わせください。皆様のフィードバックをお待ちしています！