菜单
開発成果物のマルチパースペクティブレビューを実施。XP エージェント（プログラマー、テスター、アーキテクト、テクニカルライター、ユーザー代表）を並列起動し、コード品質・テスト品質・設計整合性・ドキュメント品質・利用者視点からフィードバックを収集・統合する。「コードレビューして」「PR をレビューして」「実装をチェックして」「テストコードをレビューして」「この変更をレビューしてほしい」「コードの品質を確認して」といった場面で発動する。開発成果物に対するレビュー依頼があれば積極的に使用すること。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | developing-review |
| description | 開発成果物のマルチパースペクティブレビューを実施。XP エージェント（プログラマー、テスター、アーキテクト、テクニカルライター、ユーザー代表）を並列起動し、コード品質・テスト品質・設計整合性・ドキュメント品質・利用者視点からフィードバックを収集・統合する。「コードレビューして」「PR をレビューして」「実装をチェックして」「テストコードをレビューして」「この変更をレビューしてほしい」「コードの品質を確認して」といった場面で発動する。開発成果物に対するレビュー依頼があれば積極的に使用すること。 |
開発フェーズの成果物（プロダクションコード、テストコード、PR、リファクタリング結果など）を複数の XP エージェントで並列レビューし、多角的なフィードバックを統合する。
コードレビューは単なるバグ発見の手段ではない。設計の妥当性、テストの十分性、将来の変更容易性、ドキュメントとの整合性、そして実際のユーザーにとっての価値を同時に検証することで、「変更を楽に安全にできて役に立つソフトウェア」を維持する。
| エージェント | 視点 | 着眼点 |
|---|---|---|
xp-programmer | コード品質 | SOLID 原則、DRY、命名、可読性、TDD サイクルの遵守、シンプルな設計 |
xp-tester | テスト品質 | テストカバレッジ、境界値、エッジケース、テストの信頼性、テストピラミッドのバランス |
xp-architect | 設計整合性 | アーキテクチャとの整合、依存関係の方向、変更容易性、技術的負債の蓄積 |
xp-technical-writer | ドキュメント品質 | API ドキュメント、コメントの適切さ、README の更新必要性、機能の理解しやすさ |
xp-user-representative | 利用者視点 | 実装された機能がユーザーの期待に合っているか、業務フローとの整合、使い勝手 |
ユーザーのリクエストに応じてレビュー範囲を決定する。
| リクエスト | レビュー範囲 |
|---|---|
| 「PR をレビュー」 | git diff で変更差分を取得 |
| 「このファイルをレビュー」 | 指定ファイルの全体 |
| 「最近の変更をレビュー」 | git log + git diff で直近の変更を取得 |
| 「実装をレビュー」 | 指定された機能に関連するファイル群 |
レビュー対象のコードを特定し、変更内容を把握する。
git diff でベースブランチとの差分を取得Agent ツールを使い、5 つのエージェントを 同一メッセージで並列起動 する。各エージェントには以下を指示する。
あなたは {エージェント名} です。
.claude/agents/{エージェント名}.md の定義に従ってレビューしてください。
## レビュー対象
{変更差分 / ファイル内容}
## 関連コンテキスト
{関連する設計ドキュメント、テストファイル、ユーザーストーリー}
## レビュー観点
{エージェント固有の着眼点}
## 出力形式
以下の形式でフィードバックを返してください：
### 評価サマリー
（1-2 文で全体評価）
### 良い点
- （具体的に）
### 改善提案
- 【重要度: 高/中/低】（ファイル:行番号）（具体的な改善提案と理由）
### 懸念事項
- （潜在的なバグ、セキュリティリスク、パフォーマンス問題など）
### スコープ外の発見
- （レビュー対象外だが報告すべき問題）
Agent ツールが利用できない環境では、5 つの視点を逐次的にシミュレートする。各エージェントの定義ファイル（.claude/agents/{エージェント名}.md）を読み、その視点でレビューを順次実施する。出力形式は同一のテンプレートに従う。
全エージェントのフィードバックを受け取った後、以下の形式で統合レポートを作成する。
## コードレビュー結果
### レビュー対象
- {ファイル名 / PR 番号}
### 総合評価
（全エージェントの評価を統合した 2-3 文の評価）
### 改善提案（重要度順）
#### 高（マージ前に対応すべき）
| # | 提案 | 箇所 | 指摘元 | 理由 |
|---|------|------|--------|------|
#### 中（対応推奨）
| # | 提案 | 箇所 | 指摘元 | 理由 |
|---|------|------|--------|------|
#### 低（改善の余地あり）
| # | 提案 | 箇所 | 指摘元 | 理由 |
|---|------|------|--------|------|
### 矛盾事項
複数エージェントの指摘が相反する場合、ここに記載する。
| # | 視点 A | 視点 B | 論点 | 推奨判断 |
|---|--------|--------|------|----------|
### エージェント別フィードバック詳細
<details>
<summary>xp-programmer（高: N / 中: N / 低: N）</summary>
（フィードバック全文）
</details>
<details>
<summary>xp-tester（高: N / 中: N / 低: N）</summary>
（フィードバック全文）
</details>
<details>
<summary>xp-architect（高: N / 中: N / 低: N）</summary>
（フィードバック全文）
</details>
<details>
<summary>xp-technical-writer（高: N / 中: N / 低: N）</summary>
（フィードバック全文）
</details>
<details>
<summary>xp-user-representative（高: N / 中: N / 低: N）</summary>
（フィードバック全文）
</details>
重要度「高」の指摘は具体的な修正コードを提案する。修正を適用するかはユーザーの判断に委ねる。
統合レポートを docs/review/{対象名}_review_{YYYYMMDD}.md に保存する。過去のレビュー結果と比較できるようにし、改善のトレーサビリティを確保する。
以下をすべて満たした場合にレビュー完了とする。
orchestrating-development — 開発フェーズの全体ワークフローdeveloping-backend — バックエンド TDD 開発developing-frontend — フロントエンド TDD 開発git-commit — レビュー結果の保存後のコミットMarp Markdown スライドデッキの作成・拡張・再生成を支援。PlantUML 図表、AI 画像バリアント、漫画画像バリアント、PPTX/HTML 出力に対応。`tmp/k2works-wiki/スライド/YYYYMMDD` などの日本語技術スライドフォルダの構築・更新、コードサンプル追加、ビジュアル要約スライド追加、`スライド.images.md` / `スライド.images.ai.md` / `スライド.images.ai.manga.md` の生成、Marp HTML/PPTX デッキの再生成時に使用。
テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。
ビジネスアーキテクチャ分析を支援。要件定義の前段階として、ビジネスモデルキャンバス、バリューストリーム、ケイパビリティマップ、組織マップ、情報マップ、ビジネスシナリオを作成。「ビジネスモデルを整理したい」「バリューストリームを描きたい」「ケイパビリティマップを作りたい」「事業構造を分析したい」「ビジネスアーキテクチャを分析したい」「BA 分析をしたい」といった場面で発動する。ビジネスの全体像を理解してからシステム要件に落とし込むことで、本当に必要な機能を見極められる。
企業事例（ケーススタディ）の与件文作成を支援。経営戦略・マーケティング・生産管理・財務会計の 4 パターンから選択し、テンプレートのプレースホルダに対応する質問に回答することで与件文を生成する。「企業事例を作りたい」「ケーススタディを書きたい」「与件文を作成したい」「診断士試験の事例問題を作りたい」「仮想企業の事例を整理したい」といった場面で発動する。事例テンプレートに沿って体系的にヒアリングすることで、論理的整合性のある与件文を効率的に作成できる。
企業事例（与件文）を基に企業戦略・事業戦略・機能戦略の 3 階層を体系的に立案。環境分析（SWOT・VRIO・BMC）から始めて、ドメイン定義・成長戦略・競争戦略・価値連鎖・ケイパビリティマップまで、PlantUML を活用した可視化ドキュメントを作成する。「戦略を立案したい」「企業戦略を作りたい」「事業戦略を策定したい」「SWOT 分析をしたい」「VRIO 分析をしたい」「成長戦略を考えたい」「競争戦略を立てたい」「価値連鎖を分析したい」「ケイパビリティマップを作りたい」「診断士試験の戦略分析をしたい」「企業事例から戦略を導出したい」といった場面で発動する。事例と戦略をセットで扱うことで、経営コンサルティングの提案書や中小企業診断士の答案に相当する体系的な戦略ドキュメントを作成できる。
インセプションデッキの作成を支援。プロジェクトの「なぜ」「何を」「どうやって」を 10 の問いで整理し、チーム全体の認識を揃える。「インセプションデッキを作りたい」「プロジェクトの方向性を整理したい」「10 の問いに答えたい」「チームの認識を揃えたい」「プロジェクトを立ち上げる」といった場面で発動する。プロジェクトの方向性を最初に揃えておくことで、後工程での手戻りを大幅に減らせる。