# Codexの機能と実践的な使い方 🔍 PR を開いたら、ノイズではなく「本当にヤバい指摘だけ」が返ってくる。Codex の GitHub 統合は P0/P1 の高優先度リスクに絞ったコードレビューを自動投稿します。 🏷️ タイトル: PRレビュー(@/codex review) 🔗 URL: 📘 概要 Codex の GitHub 統合は、Pull Request の差分を AI がレビューして高シグナルなフィードバックを投稿する機能です。あえて P0・P1 の深刻な問題だけに絞ることで、レビューコメントが高優先度のリスクに集中するよう設計されています。 ⚙️ 機能の説明 ・手動レビューは PR に `@/codex review` とコメントします。Codex は 👀 でリアクションした後、GitHub のコードレビューを投稿します。 ・設定で Automatic reviews を有効にすると、PR がオープンされた時点でメンション不要の自動レビューが走ります。 ・レビュー観点はリポジトリ最上位の `AGENTS.md` に書いた「Review guidelines」セクションで制御できます。Codex は変更ファイルに最も近い `AGENTS.md` の指示を適用するため、ディレクトリ階層を使ってパッケージごとに観点を変えられます。 ・`@/codex review` 以外で `@/codex` をメンションすると、その PR を文脈としてクラウドタスクが起動します。例えば `@/codex fix the CI failures` のように指示できます。 🛠️ 実践的な使い方 ・まず の Code review 設定で対象リポジトリのトグルを有効にします（Codex cloud のセットアップが前提）。 ・観点を固定したいときは `AGENTS.md` の「## Review guidelines」セクションに「PII をログに出さない」「全ルートを認証ミドルウェアで包む」などの観点を箇条書きします。 ・1回だけ観点を変えたいなら `@/codex review for security regressions` のようにコメントに直接添えます。 ・レビュー後に修正まで任せるなら `@/codex fix the P1 issue` とコメントすれば、Codex がクラウドタスクで修正に着手します。 💡 ユースケース レビュアーが多忙なチームで、まず Codex に一次レビューを通させて P0/P1 を潰してから人間レビューに回すと、レビュー往復が減ります。セキュリティや PII 取り扱いなど絶対に外せない観点を `AGENTS.md` に明文化しておけば、全 PR で機械的に確認されます。 ⚠️ 注意点 ・利用にはリポジトリで Codex cloud のセットアップとコードレビューの有効化が必要です。 ・手動レビューのトリガーは厳密に `@/codex review` という文字列です。 ・自動レビューはトグル設定が正しくないと動きません。導入時に設定を確認しましょう。 #OpenAICodex# #CodeReview#

ハーネスエンジニアリングのプラクティス P20. 可読性とキャリブレートされた不確実性をSLOにする 🎯 ポイント 生成が安価になった今、真のボトルネックは「人間のレビュー時間」です。差分は正しさだけでなく、レビューしやすさに対しても最適化すべきです。 📝 概要 差分は正しさだけでなくレビュー時間に対しても最適化します。小さく焦点の合ったPR、「なぜ」を語る説明、危険箇所の明示。さらにエージェントには「自信のない箇所」を明示出力させ、ハーネスがそこを追加検証や人間レビューへ振り分けます。偽の自信より較正された不確実性の方が価値が高いです。 🔍 解説 エージェントの生成速度が上がるほど、ボトルネックは「コードを書く」から「コードをレビューする」に移ります。巨大なPR、説明のない変更、自信満々だが実は不確かな実装。これらはレビュアーの時間を爆発的に消費します。可読性をSLO（サービスレベル目標）として扱い、PRサイズ・説明の有無・変更理由の明記を測定・最適化することで、全体のスループットが向上します。また、エージェントに「ここは自信がない」「この部分は人間に確認してほしい」と明示させることで、レビュアーは重要な箇所に集中できます。これは自律エージェントの信頼性を高める最も見落とされがちな施策です。 🛠 実践方法 ・PRテンプレートに「変更理由」「確信度（高/中/低）」「レビュー重点箇所」の欄を設け、エージェントに必ず記入させます ・PRサイズの上限を設定し、超過した場合は分割を強制します ・エージェントの出力に「自信のない箇所」のマーカーを要求し、ハーネスがそこを追加検証へ振り分けます ・レビュー時間をPR単位で計測し、レビュー時間が長い原因（巨大差分・説明不足等）を特定して改善します 💼 ユースケース ・issue-to-PRエージェントが、PRに変更理由と確信度マーカーを含める場面 ・コードレビューエージェントが、低確信の瑣末指摘を抑制し、人間が見落とす種別に集中する場面 ・マイグレーションで、各ユニットのPRを小さく焦点を絞り、レビュアーの負荷を分散する場面 ⚠ 落とし穴 可読性を追求しすぎると、エージェントの出力が過度に保守的になります。また、「不確実性の表明」がノイズになるリスクもあります。「すべてに自信がない」と表明するエージェントは役に立ちません。較正が重要で、本当に不確かな箇所だけを正確にマークできることが価値です。レビュー時間の測定も忘れずに。PRスパムや巨大差分がレビュー帯域を圧迫していないかを定量的に把握することが改善の出発点です。 #HarnessEngineering# #CodeReview#

# Claude Codeの機能と実践的な使い方 🚀 PRやIssueで「@/claude」とメンションするだけで、修正・実装・レビューが自動で走る。Claude CodeはCIの中で動くAI同僚になります。 📌 タイトルと機能のURL タイトル: GitHub Actions URL: 📝 概要 Claude Code GitHub Actionsは、Claude CodeをGitHubワークフローに統合する公式アクションです。任意のPRやIssueで「@/claude」とメンションすると、Claudeがコードを分析してプルリクエストを作成したり、機能を実装したり、バグを修正したりします。Claude Agent SDKの上に構築されており、定型作業の自動化に向いています。 🔧 機能の説明 ・コメント内の「@/claude」メンションに応答するインタラクティブモードと、プロンプトを与えて即実行する自動化モードを、設定に応じて自動判別します。 ・リポジトリルートのCLAUDE.mdを尊重し、プロジェクト標準やコードパターンに沿って動作します。 ・コードはGitHubのランナー上で実行され、デフォルトでSonnetを使用します（Opus 4.8も指定可能）。 ・直接Claude APIに加え、Amazon BedrockやGoogle Vertex AIでの利用にも対応します。 🛠 実践的な使い方 ・最も簡単な導入は、ターミナルでclaudeを起動し「/install-github-app」を実行する方法です。GitHubアプリとシークレットの設定をガイドしてくれます（リポジトリ管理者権限が必要）。 ・手動セットアップでは、Claude GitHubアプリ（ ・アクションは「anthropics/claude-code-action@v1」を使用します。「prompt」で指示を、「claude_args」でCLI引数を渡せます。 ・claude_argsの例: --max-turns 5 / --model claude-sonnet-4-6 / --mcp-config /path/to/config.json ・コメント例: 「@/claude implement this feature based on the issue description」「@/claude fix the TypeError in the user dashboard component」 🎯 ユースケース ・IssueにメンションしてそのままPRを自動作成し、要件をコードに落とし込む。 ・PR上で「@/claude このセキュリティ問題をレビューして」と定型レビューを依頼する。 ・schedule（cron）トリガーで、前日のコミットやオープンIssueの日次サマリーを自動生成する。 ・code-reviewプラグインを組み込み、PRの更新ごとにスキルを自動実行する。 ⚠️ 注意点 ・APIキーは絶対にリポジトリに直接コミットせず、必ずGitHub Secrets（secrets.ANTHROPIC_API_KEY）で参照してください。 ・GitHub Actionsの実行時間とAPIトークンの両方でコストが発生します。--max-turnsやタイムアウトで暴走を防ぎましょう。 ・反応しない場合は、コメントが「/claude」ではなく「@/claude」になっているか、アプリ導入とシークレット設定を確認します。 ・v1.0はベータから破壊的変更があり、mode削除・direct_prompt→prompt・各CLIオプションのclaude_args移行が必要です。 #ClaudeCode# #CICD#

🔍 TL;DR: 汎用AIエージェントのコードレビューにありがちな見落としやズレを、Alibaba社内実績のハイブリッド設計で解決したCLIツールです。 タイトル: alibaba/open-code-review URL: 📌 ポイント ⚙️ 精度が必要な部分はハード制約、判断が必要な部分だけAIに任せる設計 📝 Gitディフから行単位の構造化レビューコメントを生成 🕵️ 未知のコードベース向けにフルファイルスキャンモードも搭載 🛡 NPE・スレッドセーフティ・XSS・SQLインジェクションなど多言語ルール内蔵 🔌 Claude Code、Codex、Cursorなどにプラグインで統合可能 📊 50リポジトリ・200PRのベンチマークでClaude Codeより高いPrecision/F1 💰 トークン消費は比較対象の約1/9 数千人規模の社内運用で鍛えられた精度が、そのままOSSで使えるのは魅力的だと思います。 #コードレビュー# #AIエージェント#

AIコードレビューでトークンを燃やしていませんか？🔥 コードを構造グラフ化して、関連ファイルだけ読ませることで、トークンを中央値82倍削減するツールです。 タイトル: tirth8205/code-review-graph URL: 🔥 概要 Tree-sitterでコードベースの構造マップ（グラフ）をローカルに永続化する、ローカルファーストのコードインテリジェンスツールです。AIアシスタントが、リポジトリ全体ではなく文脈的に関連するファイルだけを読んでレビューできるようにします。 ❓ 解決する課題 AIコードレビューツールは、レビューのたびにコードベースの大部分を読み直し、大量のトークンを無駄にします。 ・特に大規模モノレポでは、コンテキストが膨れ上がりコストもレイテンシも悪化します ・変更の影響範囲をスキャンするのに、プロジェクト全体を読む必要がありました 💡 方法論と仕組み 3段階のパイプラインで動きます。 ・パース：Tree-sitterがASTを作り、関数・クラス・import・呼び出し関係を抽出 ・グラフ保存：ノードとエッジをSQLiteに永続化（外部DB不要） ・分析：変更時に影響範囲（blast-radius）分析で、影響する呼び出し元・依存先・テストを辿り最小限の文脈を返す 多言語対応、増分更新は2秒未満、MCP連携（30ツール）、GitHub Action、D3.js可視化を備えます。 📊 実験結果 / 実績 ・トークン効率：38倍〜528倍の削減（6リポジトリで中央値約82倍） ・影響予測のF1スコア：平均0.71 ・CLI例：フル文脈12,921トークン→グラフ文脈762トークン（約94%削減） #コードレビュー# #AIエージェント#

# Antigravityの機能と実践的な使い方 🚀 「いつものレビュー手順」をエージェントに毎回説明するのはもう終わり。Skills は知識を1ファイルに固めて再利用可能にします。 📌 タイトルと機能のURL タイトル: Skills URL: 📝 概要 Skills は、エージェントの能力を拡張する再利用可能な知識パッケージです。中心となる SKILL.md にスキルの内容・使うべき場面・実行手順を記述することで、コンテキストウィンドウを圧迫せずにタスクを一貫したやり方で実行させられます。 🔧 機能の説明 Skills の核は SKILL.md という1つの Markdown ファイルです。 ・SKILL.md はスキルの「脳」であり、「これは何か」「いつ使うか」「どう実行するか」をエージェントに伝えます ・必須ファイルは SKILL.md のみですが、スクリプト・例・リソース用ディレクトリなどを同梱できます ・グローバルスコープ ~/.gemini/antigravity/skills/ に置いたスキルは、そのマシンの全プロジェクトで利用できます ・「Format JSON」「Generate UUIDs」「Review Code Style」など、汎用ユーティリティの共有に向いています ・小さな Markdown を書くだけで、よく使うプロンプトをチーム向けの再利用可能なコマンドに変えられます 🛠 実践的な使い方 ・code-review スキルを用意し、PR レビューやコード品質チェックの際にバグ・スタイル・ベストプラクティスを自動で確認させます ・チーム共通のレビュー手順を SKILL.md に落とし込み、~/.gemini/antigravity/skills/ に配置して標準化します ・スクリプトや例を resources としてスキルに同梱し、手順を具体化します ・プロジェクト固有の作法はワークスペーススコープ、汎用ユーティリティはグローバルスコープと使い分けます 🎯 ユースケース ・チームのコードレビュー基準を code-review スキルとして標準化する ・JSON 整形や UUID 生成といった頻出の小タスクをスキル化して即呼び出す ・デバッグの定石手順をスキルに蓄積し、誰が使っても同じ品質で実行する ・社内の作法やチェックリストを SKILL.md にまとめ、新メンバーへ自然に展開する ⚠️ 注意点 ・必須は SKILL.md のみですが、「いつ使うか」を明確に書かないとエージェントが適切に発火しません ・グローバルスコープに置くと全プロジェクトへ影響するため、汎用性の低いものはワークスペース側に置くのが無難です ・スキルはコンテキストを節約する設計思想なので、1スキルに詰め込みすぎず役割を絞ると効果的です #Antigravity# #AIcoding#