code-reviewer
FreePR・コミット・差分・ファイルをレビューし、再現条件と根拠のある不具合、回帰、検証漏れを報告する。変更が差分の外で何を壊しうるか(影響範囲)を、安全の根拠をコードで証明して確かめるときにも使う。
The English summary is being prepared. Showing the original description.
リポジトリにエージェント開発用の検証基盤を整える。`make check`、GitHub ActionsのCI、短いAGENTS.mdを、言語とツールを検出して作る。'harness-init'、'リポジトリを初期化して'、'検証コマンドを用意して'、新規リポジトリ作成直後や既存リポジトリへの導入時に使う。
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
エージェントが自分で合否を確かめられる状態を作る。グローバルのstop-check.shは、リポジトリにmake check(または実行可能な.claude/check.sh)があれば、未コミットの変更がある状態での終了時に必ずそれを実行し、失敗したら終了を止める。このスキルはそのcheckと、エージェントの外で同じ判定を行うCIを用意する。
既存ファイルは上書きしない。既存の内容と衝突する場合は差分を示して確認する。commitはしない。
次を読んで、言語、パッケージマネージャ、既存のlint・型・テスト・ビルドのコマンドを特定する。
Cargo.toml、package.jsonとロックファイル、pyproject.tomlとuv.lock、go.modなどMakefile、package.jsonのscripts、justfile、.github/workflows/既存の仕組みがあればそれを使う。新しいツールの導入は、ユーザーが求めた場合か承認した場合に限る。
make checklint、型検査、高速なテストを順に実行し、どれかが失敗したら非ゼロで終わるtargetを作る。数十秒以内に終わる範囲に絞り、遅いE2Eや重いビルドはmake test-allなど別targetにする。
例(既存コマンドに合わせて置き換える):
| 言語 | check |
|---|---|
| Rust | cargo fmt --check、cargo clippy --all-targets -- -D warnings、cargo test |
| TypeScript(bun) | bun run lint、bun run typecheck、bun test |
| Python(uv) | uv run ruff check、uv run ruff format --check、uv run pyright(または既存の型検査)、uv run pytest -q |
Makefileがなく、作る理由もない場合は.claude/check.sh(実行権限付き、set -euo pipefail)にする。作成後に実行し、現状で通ることを確認する。通らない場合は、既存の失敗として一覧を報告し、勝手に直さない。
.github/workflows/check.ymlを作る。~/.claude/rules/dependency-security.mdに従う。
make checkをCIでも実行する。ローカルとCIで同じコマンドを使う。bun install --frozen-lockfile、uv sync --locked、cargo test --lockedなど)。gh api repos/<owner>/<repo>/commits/<tag> --jq .shaなどで現在の値を確認する。permissions: contents: readを既定にする。監査コマンドやActionの使い方は公式資料かContext7(ctx7)で現在の仕様を確認する。
新規プロジェクトでは、最小リリース期間の設定と、postinstall/preinstallスクリプトの既定ブロックも行う。具体的な設定キーは公式資料かContext7(ctx7)で確認する。
100行以内で、エージェントが最初に読む地図を書く。CLAUDE.mdしか使わないリポジトリでは、CLAUDE.mdに書くか、@AGENTS.mdを読み込む1行を置く。
書くもの:
make check、遅いテストの実行方法)書かないもの: 一般的なコーディング規約、lintやhooksで強制できる規則、ユーザーのグローバル設定と重複する内容。守らせたい規則は、文章ではなくlint規則、テスト、hooksに置く。
作成・変更したファイルと、実行したcheckの結果を示す。人間が行う作業として、次を伝える。
checkを必須にするNo reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
PR・コミット・差分・ファイルをレビューし、再現条件と根拠のある不具合、回帰、検証漏れを報告する。変更が差分の外で何を壊しうるか(影響範囲)を、安全の根拠をコードで証明して確かめるときにも使う。
The English summary is being prepared. Showing the original description.
Codex CLI(`codex exec`)に、モデル・reasoning effort・速度を指定して作業(調査、レビュー、相談、実装)を頼み、結果を受け取って要約する。「solで〜して」「astra xhighで調べて」「luna low fastで」「Codexで〜」「Codexに聞いて/やらせて」のように、呼び名(sol / astra / luna)やCodexを指定して作業を頼まれたときだけ使う。文中に普通の単語として「sol」「luna」が出てきただけのときは使わない。
The English summary is being prepared. Showing the original description.
エージェントが同じ間違いを繰り返すとき、履歴から間違いの種類を洗い出し、設計、型、lint・CI、テスト、文書の順に、効く範囲で最も上の層で再発を防ぐ。計画を承認してから実装し、各チェックが過去の実際の間違いで失敗することを証明する。'/correct'で使う。
The English summary is being prepared. Showing the original description.
アプリを利用者と同じ操作で動かして振る舞いを確かめる、プロジェクト専用の検証スキル(`.claude/skills/verify-<app>/`)と機能一覧を作る。言語、フレームワーク、Web・CLI・API・デスクトップを問わない。'/create-verification-skill'、'このリポジトリの検証スキルを作って'、UI・CLI・サービスの振る舞いを確かめる手順がリポジトリにないときに使う。
The English summary is being prepared. Showing the original description.
既存のコードやシステムが今どう動いているか(仕組み、処理の流れ、どこに何があるか、どの層やモジュールが持つべきか)を、コードを読んで説明する。'どうなっているか'、'仕組みを教えて'、'この処理の流れ'、'これはどこに置くべきか'、変更の前に既存の仕組みを理解したいときに使う。なぜ今の形なのか(経緯)は`why`、技術の選定は`research`を使う。
The English summary is being prepared. Showing the original description.
知らない分野にキャッチアップするとき、汎用的な言葉から界隈の用語・中心の人・場(学会・雑誌・個人ブログ・動画・リポジトリ・一覧)を特定し、 引用・リンク・著者を芋づる式にたどって、当たりの原文(論文も個人の記事や動画の字幕も)を要約せずそのまま ~/research/<話題>/sources/ に落とす。 周ごとに地図(map.md)を育て、要る主張の全部に原文が付くか飽和したら止める。 見張りのモードでは、地図の場(Qiita・Zenn のタグ、note、YouTube、ブログ、arXiv)の新着を RSS で引いて原文の冒頭つきで並べる。 以下で使用:「芋づる式に調べて」「この分野をキャッチアップしたい」「界隈の用語と人から掘って」 「論文とか先行研究を漁って」「既存の技術を真似したいから元ネタを探して」「上手い人のやり方を集めて」「原文で落として」「/imozuru」 「〇〇って研究あるの?原典ほしい」「全然わからないから流れを掘って」「どういう界隈でどう呼ばれてるか知りたい」 「〇〇の新着見て」「今週の〇〇の記事まとめて」「キャッチアップ」「/imozuru watch」 "dig into this field", "find the canonical papers on X", "literature dive", "what's new in X this week"。 以下には使用しない: 答えが1つの事実の確認(年・有無だけ・仕様1つ → そのまま検索)/ 手元の PC の中の資料を探す/読んだ資料の要約や解説を書く。
The English summary is being prepared. Showing the original description.