Review Repository
リポジトリ全体の品質と構造を評価し、改善のロードマップを作成します。
手順
ディレクトリ構造の把握:
list_dirを使用して、プロジェクトの全体像(gwexpy,tests,docs,examplesなど)を確認する。find_by_nameで主要なファイル形式(.py,.ipynb,.md,.toml)の分布を確認する。
設計・依存関係の確認:
README.mdを読み、プロジェクトの目的と主要機能を理解する。pyproject.tomlやsetup.pyを確認し、依存関係とビルド設定を把握する。
コード品質のスクリーニング:
grep_searchで以下のアンチパターンや残存項目を検索する:except Exception:(広範すぎる例外キャッチ)pass(空のブロック)TODO,FIXME,XXX- 古いPythonバージョンへの対応コード (
sys.version_info)
view_file_outlineで主要クラスのメソッドが型ヒントや docstring を持っているか確認する。
テスト・品質管理の検証:
run_testsスキルやrun_command(pytest --collect-only) でテストの規模と状態を確認する。- GitHub Actions (
.github/workflows) などのCI設定を確認する。
レポートの生成とタスク化:
- 以下のセクションを含むレポートを作成する:
- 概要: プロジェクトの規模と現在の状態。
- 長所: 良い実装や設計のポイント。
- 改善点 (P1:高, P2:中, P3:低): 優先度順に整理された具体的な問題点。
- レポートを元に、AIが理解しやすい「改善タスク用プロンプト」を
.agent/ディレクトリにマークダウン形式で保存する。
- 以下のセクションを含むレポートを作成する: