aider-cli-workflow について
ローカルリポジトリで Aider を使い、小規模な変更をテストで確認しながら進めるワークフロースキルです。環境確認、編集範囲の限定、検証、コミット確認を扱います。
主な機能
- 01リポジトリと Aider の環境確認
- 02作業を一つの変更に限定
- 03編集前後のテスト実行
- 04差分とコミットの確認
活用シーン
- 01Aider による小さなバグ修正
- 02範囲を絞った機能の実装
- 03Aider の変更の検証と整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/aider-cli-workflowを入力して読み込まれたか確認します。
詳細
Aider CLI ワークフロー
ユーザーがローカルリポジトリでの Aider ベースのコーディングループ を明示的に希望した場合に、このスキルを使用します。
このスキルを使う場合
- Aider のインストールや初期設定の確認から実行までを一度に整理する必要がある場合
- 小規模な機能やバグを、テストを基準とした AI ペアプログラミングで対応する場合
- Aider が作成した変更を、コミット単位で検証・整理する必要がある場合
使用しない場合
- ホスト型 PR のレビュー、ラベル、ブランチ保護ポリシーが中心の作業（
code-review、GitHub ワークフロー系） - Git の衝突や復旧だけが必要な場合（
git-workflow） - 根本原因のデバッグが中心の作業（
debugging）
手順
Step 1) 前提条件
- リポジトリのルートを確認します：
git rev-parse --show-toplevel - Aider のインストールを確認します：
aider --version - 基本的な検証コマンドを確認します：テストまたはリンターのコマンドを1つ以上用意します
Step 2) スコープを限定して開始
- 一度に指定する作業は1つだけにします（バグ1件／機能1つ）。
- Aider のプロンプトには、必ず以下を含めます。
- 変更対象ファイルの範囲
- 受け入れ基準（acceptance criteria）
- テスト／検証コマンド
Step 3) テストを基準に編集を繰り返す
- 基準となるテストを実行します（失敗／成功の基準を確保します）
- Aider で修正します
- テストを再実行します
- 差分を確認し、必要に応じて追加で修正します
Step 4) コミットの管理
git add -pで変更範囲を確認します- コミットメッセージには、意図と検証コマンドを含めます
- リスク（実験的なパッチ、不安定なテスト、未検証の経路）は、コミットまたはレポートに明記します
Step 5) フォールバック
- 変更が広がりすぎた場合は、すぐに範囲を縮小して再試行します
- テストが繰り返し失敗する場合は、Aider による自動修正ループを停止し、原因分析に切り替えます
出力形式
# Aider Run Brief
- Goal:
- Scope:
- Validation commands:
- Changed files:
- Risks / follow-ups:
例
例 1：小規模なバグ修正ループ
- 目標：失敗している単体テスト1件を成功状態に戻す
- 範囲：テストファイルと関連する実装ファイルのみを編集
- 検証：
pytest -q tests/path/test_x.py
例 2：範囲を絞った機能追加
- 目標：API フィールドを1つ追加し、後方互換性を維持する
- 範囲：スキーマ、ハンドラー、テスト
- 検証：既存テストと新規テスト
ベストプラクティス
- 必ず最初にベースラインのテスト結果を取得します。
- ファイルの範囲を明示せずに Aider のセッションを開始しないでください。
- コミット前に
git add -pで不要な変更を取り除きます。 - 不安定な変更や実験的な変更はリスクを明記し、後続の TODO を残します。
参考資料
- Aider：https://github.com/Aider-AI/aider
- Aider のドキュメント：https://aider.chat/
コメント
Markdown 対応