linear-review

Linear レビュー

リポジトリのルートをワークフローの参照元として使用します。以下を読み、従ってください。

• agents/reviewer.md
• docs/reviewer.md
• docs/agent-required-passes.md
• docs/workflow.md
• templates/linear-review-finding-footer.md
• schemas/linear-ai.review-ledger.v1.schema.yaml
• templates/linear-bug-issue.md
• templates/linear-feature-issue.md

対象範囲

引数がない場合、対象リポジトリ全体をレビューします。ベース参照、PR、または HEAD~n を指定する引数がある場合、そのベースとの差分コードのみをレビューします。

開始時の選択肢

並行作業を開始する前に、推奨されるデフォルトとともに、重大度のしきい値（--min、デフォルトはなし）、トリアージモード（デフォルトはハイブリッド、一覧表形式、または一件ずつ）、引き継ぎモード（デフォルトはドラフトのみ、またはドラフト＋改善）を確認します。

レビューの並列実行

agents/reviewer.md に従って、レビューを独立した並列サブエージェントに割り当てます。推論レーンは5つ（正確性、セキュリティ、保守性、パフォーマンス、テスト）、仕様レーンは差分モードで準備済みの計画がある場合のみ、ツールを使用するレーンは2つ（不要なコード、依存関係の健全性）です。各レビュアーは読み取り専用で、担当する観点は1つとし、状態を共有せず、agents/reviewer.md で定義された形式で指摘事項を返します。

重複排除

docs/reviewer.md に従って、各指摘事項のフィンガープリントを作成します。フィンガープリントが .linear-ai/review-ledger.yaml で ignored または ticketed として記録されている指摘事項、および linear-ai:review-finding フッターを含む未解決の Linear 課題とフィンガープリントが一致する指摘事項を除外します。重複排除の件数を報告します。

トリアージと課題

残った指摘事項を、選択されたトリアージモードで、docs/reviewer.md の確信度を考慮したデフォルトに従って重大度別に提示します。新しい課題の対象チームとプロジェクトがセッション中に明確になっていない場合は、課題を作成するチームとプロジェクトを確認します。選択された指摘事項ごとに、linear-create-issue の規約に従って Linear 課題を作成します。バグ、セキュリティ、サイレント障害の指摘には bug を適用し、それ以外には機能テンプレートを使用します。llm-refine を追加し、linear-ai:review-finding フッターを追記して、フィンガープリントを課題 ID とともに ticketed として台帳に記録します。ユーザーが明示的に無視した指摘事項に限り、台帳に ignored エントリーを記録します。保留中の指摘事項は記録しません。

Claim Lock

linear-review はリポジトリ全体を対象とし、in-use クレームは取得しません。作成した課題には、その後、通常の Claim Lock Rule が適用されます。

Linear MCP 契約

重複排除のため、list_issues／search_documentation を使って linear-ai:review-finding フッターを含む未解決の課題を検索します。指摘事項の課題を作成してフッターを追加するには save_issue を使い、改善に引き継ぐ場合は list_comments を使います。Linear MCP の書き込みツールを利用できない場合、課題を作成したと主張してはいけません。正確な課題本文、ラベル、フッターを含む REQUIRED_LINEAR_MUTATIONS を出力し、ローカル台帳への記録は引き続き行います。

ステップ完了時の引き継ぎ

ドラフトのみの引き継ぎでは、課題を作成した後に停止し、linear-refine または linear-batch-refine を推奨します。ドラフト＋改善の場合、作成した課題を対象に linear-refine（または linear-batch-refine）へ引き継ぎ、各指摘事項の根拠と修正案を改善のコンテキストとして渡します。

レビューのステップが完了したら、変更内容、重複排除の件数、作成した課題、台帳への記録、現在の Linear ラベル／ステータス、推奨される次のステップを報告します。このレビューのステップに追加することがあるか尋ねます。何もなければ、次に推奨するスキルを示して確認を待ち、自動実行はしません。