# Freebuff 実践編：エージェントが書いたコードをマージ前に読む

> コーディングエージェントの変更をレビューする順序。元に戻せる状態、先に見るべき危険な行、テストが緑でも埋まらない確認項目。

Canonical: https://dreamrefer.al/ja/ai-blog/freebuff-guide/
Publisher: DreamReferral
Content language: 日本語
Reviewed: 2026-10-26

## テストが緑なのはレビューではない

テストは誰かが思いついたケースを確認するだけです。振る舞いを変えるエージェントは、既存のテストをすべて緑のまま残せます。テストが古い振る舞いを緩くしか固定していなかったか、その経路をそもそも誰もテストしていなかったからです。緑は「変更が動く」証拠であって、「変更が正しい」証拠ではありません。

整った要約も同じです。エージェントが「何をしたか」という説明は、その変更を行ったのと同じシステムによる主張です。カバーノートではなく diff を読み、テストは数あるシグナルの一つとして扱ってください。

## きれいで元に戻せる状態から始める

最初のプロンプトの前に、作業をコミットするか退避し、ブランチを作り、戻り方を正確に把握しておきます。ターミナルにアクセスできるエージェントは、マイグレーションを実行し、設定を書き換え、ファイルを削除できます。元に戻せる出発点があれば、事故は不便で済みます。

規制対象や機密に関わる作業なら、プロジェクトの使い捨てコピーと、秘密情報を含まない会話を使ってください。何がマシンの外に出るかは提供元の規約とデータ取り扱いの文書が決めます。境界を想像せず、読んでください。

## 痛いところから順に diff を読む

大きな生成変更は、上から下へではなく意図した順序で見るほうが確実です。

- **入口**：ルート、ハンドラ、権限、誰が何に届くかを変えるものすべて。
- **データ**：スキーマ、マイグレーション、シリアライズ、クエリ。とくに削除や上書きをするもの。
- **設定**：環境変数、ビルド手順、CI、デプロイ設定。
- **その他**：命名、構造、重複、そして diff を実際より大きく見せる見た目だけの編集。

そのうえで追加されたテストを読み、何をカバーしていないかを考えます。コードとテストの両方を書いたエージェントは、同じ誤解を二重に固定しかねません。

## 依存関係、秘密情報、そして誰も読まない行

生成パッチで最も静かなリスクは新しい依存関係です。見覚えのあるパッケージ名、出どころのわからないバージョン、丸ごと書き換えられた lockfile。何が追加されたのか、なぜ必要か、既に同じ役割のものがなかったかを確認してください。

コミットに含めるべきでない認証情報、トークン、内部 URL がないか探し、ログが顧客データを出力し始めていないかも見ます。レビューで流し読みされがちなのがこうした行であり、まさにそこがエージェントの慎重さが働かない場所です。エージェントは依頼に最適化しており、あなたの脅威モデルには最適化していません。

## 捨てるべきとき

diff が依頼より大きい、推測なしにはハンクを説明できない、変更が原因ではなく症状を直している。どれかに当てはまるならブランチを削除してください。誰も理解できないコードを保守するより、より狭い依頼でやり直すほうが安く済みます。

同じ原則はプロンプトにも当てはまります。[Manus ガイド](/ja/ai-blog/manus-guide/)のレビュー用チェックリストと、[Prompt Cowboy ガイド](/ja/ai-blog/prompt-cowboy-guide/)の構成の助言は、どちらも diff を短くします。製品そのものは [Freebuff の概要](/ja/freebuff/)から、紹介リンクの扱いは[アフィリエイト開示](/ja/disclaimer/)をご覧ください。

## Frequently asked questions

### ターミナルでのコマンド実行を許可すべき？

ターミナルへのアクセスはコーディングエージェントを便利にし、同時に危険にします。権限の扱いは提供元が決めています。使い捨てのコピーや一時ブランチから始め、最初の実行は注意深く見守り、認証情報は手の届かない場所に置いてください。ファイルを読むだけのコマンドと、デプロイするコマンドはまったく別の依頼です。

### 無料のコーディングエージェントで実務に足りる？

自分でレビューできる機械的な作業なら足りえます。無料はビジネスモデルであって品質保証ではありません。提供元は広告で運営し、モデルや上限、機能を変更できます。判断材料は価格ではなく、出力を読んでテストできるかどうかです。

### エージェントが書いたコードだと明示する必要は？

チーム、リポジトリ、ライセンスのルールに従い、聞かれたら正直に答えてください。法的にも職業的にも重要なのは、人が変更をレビューして責任を負うことです。危険なのは誰も読まなかった生成パッチであり、それを書いたツールではありません。

## Official sources

- [Freebuff — 公式サイト](https://freebuff.com/)
- [Freebuff — コマンドラインエージェント](https://freebuff.com/cli)
- [Freebuff — デスクトップアプリ](https://freebuff.com/desktop)
- [Freebuff — ソースリポジトリ](https://github.com/CodebuffAI/freebuff)

Affiliate disclosure: DreamReferral may receive referral benefits. Eligibility, rewards, availability and fees are set by each provider. No reward or saving is guaranteed. Contact: dreamreferral@duck.com.