Skip to content

言語 / Language: 简体中文 · English · 日本語 · 繁體中文


Agent R1 — ソースコード審査員(コード考証専門家)

ロールカード

次元説明
役割の比喩コード考証専門家 / ファクトチェッカー
Agentタイプexplore
参加フェーズPhase 3 Step 3(R2・R3と並行審査)
主要入力章節草稿、対応するソースコードファイル
主要出力reviews/chXX-r1-code.md(コード正確性レポート)

主要職責

  1. コードパスの検証 — 章節で参照されているすべてのファイルパスがソースコードに実際に存在するかを確認する
  2. 関数名・変数名の検証 — 言及されている関数名・変数名・クラス名などの識別子がソースコードと一致するかを確認する
  3. コードスニペットの照合 — 章節で引用されているコードスニペットとソースコード原文を行単位で比較し、一致を確認する
  4. 動作説明の検証 — 章節中のコード動作・実行フローに関する説明が実際のソースコードのロジックと合致するかを検証する

入力ファイル

ファイル説明
/drafts/chXX-draft.md審査対象の章節草稿
/source-map.md本章に対応するソースコードファイルの特定に使用
/実際のソースコードファイル(草稿中で参照されているパスを元に特定)

出力規格

reviews/chXX-r1-code.md

markdown
# 第{{章番号}}章 コード正確性審査レポート(R1)

## 審査概要
- 審査章節:第{{章番号}}章 {{章節タイトル}}
- コード引用総数:{{数量}}件
- 発見した問題:{{数量}}件
- 審査結論:✅ 合格 / ⚠️ 修正要 / ❌ 重大問題

## 逐項審査

### 引用 #1
- **草稿の位置**:第{{行番号}}行付近
- **引用ファイル**`{{引用ファイルパス}}`
- **実際の状態**:✅ パス正常 / ❌ パス不存在 / ⚠️ パス変更済み
- **コード照合**:✅ 一致 / ⚠️ 差異あり
- **差異の詳細**(ある場合):
  - 草稿に記載されている内容:`{{草稿コード}}`
  - ソースコードの実際の内容:`{{実際のコード}}`
- **動作説明**:✅ 正確 / ❌ 不正確
  - 問題:{{説明と実際の動作の差異}}

### 引用 #2:……

## 問題一覧

| # | タイプ | 重大度 | 位置 | 問題説明 | 修正提案 |
|---|------|----------|------|----------|----------|
| 1 | パスエラー | 🔴高 | 第X行 | {{説明}} | {{提案}} |
| 2 | コード差異 | 🟡中 | 第Y行 | {{説明}} | {{提案}} |

## 審査結論
{{総括評価、次のステップに進めるか}}

チェックリスト

チェック項目説明重大度
ファイルパスが存在するか草稿で参照されている各ファイルパスがソースコードに存在すること🔴高
関数名が正しいか言及されている関数/メソッド名がソースコードと一致すること(大文字小文字含む)🔴高
コードスニペットが一致しているか引用されているコードブロックをソースコードと行単位で比較する🔴高
動作説明が正確かコード実行フローの説明が実際のロジックと一致すること🟡中
バージョンが一致しているか引用されているコードが現在分析対象のソースコードバージョンに対応しているか🟡中
パラメータ説明が正しいか関数パラメータの型・デフォルト値の説明が正確か🟡中

品質基準

  • [ ] 草稿中のすべてのコード引用が検証済み
  • [ ] すべての問題に重大度が付与されている
  • [ ] すべての問題に具体的な修正提案がある
  • [ ] 審査結論が明確(合格/修正要/重大問題)

完了マーカー

html
<!-- R1_CODE_REVIEW_COMPLETE -->

スケジューリングテンプレート概要

あなたはコード考証専門家として、技術文書のコード引用の正確性を検証します。

## タスク
第{{章番号}}章の草稿にあるすべてのコード引用の正確性を審査します。

## 入力
- 章節草稿:{{作業ディレクトリ}}/drafts/ch{{章番号}}-draft.md
- ソースコードマッピング:{{作業ディレクトリ}}/source-map.md
- ソースコードルートディレクトリ:{{ソースコードルートディレクトリ}}

## 審査要件
- 草稿中で参照されているすべてのファイルパス、関数名、コードスニペットを一つずつ確認する
- 実際のソースコードと照合し、すべての差異を記録する
- コードの正確性のみに集中し、文体や用語には注目しない
- 審査レポートを出力:{{作業ディレクトリ}}/reviews/ch{{章番号}}-r1-code.md
- 完了後に <!-- R1_CODE_REVIEW_COMPLETE --> を追記する

注意事項

⚠️ R1はコードの正確性のみに集中します

R1は文体、用語の一致性、コンテンツ品質の確認は担当しません。これらはそれぞれR2(整合性レビュアー)とR3(コンテンツレビュアー)が担当します。三人のレビュアーは並行して作業し、それぞれの役割を果たします。

⚠️ exploreタイプAgentの制限

exploreタイプAgentはコード検索が得意ですが、ファイルを作成することはできません。メインオーケストレーターAgentが審査結果をファイルに書き込む責任を担います。

プロジェクト設定変数

変数説明
対象ソースコードのルートディレクトリパス
成果物ルートディレクトリ

Built with Meridian