@k2works/claude-code-booster 4.4.1 → 4.5.0

package/lib/assets/.claude/skills/analyzing-review/SKILL.md

@@ -1,174 +1,174 @@
----
-name: analyzing-review
-description: 分析成果物のマルチパースペクティブレビューを実施。XP エージェント（プロダクトマネージャー、アーキテクト、インタラクションデザイナー、テスター、ユーザー代表）を並列起動し、専門的視点からフィードバックを収集・統合する。「分析ドキュメントをレビューしたい」「要件定義をレビューして」「アーキテクチャ設計のレビューをお願い」「設計ドキュメントにフィードバックがほしい」「分析結果を検証したい」「ユースケースをチェックして」といった場面で発動する。分析フェーズの成果物に対するレビュー依頼があれば積極的に使用すること。
----
-
-# 分析成果物レビュー
-
-分析フェーズの成果物（要件定義、アーキテクチャ設計、データモデル、ドメインモデル、UI 設計、テスト戦略、非機能要件、運用要件など）を複数の XP エージェントで並列レビューし、多角的なフィードバックを統合する。
-
-## レビューの価値
-
-分析成果物のレビューは、開発フェーズに入る前に問題を発見する最も効果的な手段。1 人の視点では見落としがちな矛盾や不足を、異なる専門性を持つエージェントが同時に検証することで、手戻りコストを大幅に削減できる。
-
-## レビューエージェント
-
-各エージェントは独自の専門的視点でレビューを行う。全エージェントを並列起動し、独立したフィードバックを収集する。
-
-| エージェント | 視点 | 着眼点 |
-|:---|:---|:---|
-| `xp-product-manager` | ビジネス価値 | 要件の完全性、ビジネス価値との整合性、ストーリーの INVEST 基準、優先順位の妥当性 |
-| `xp-architect` | 技術的実現性 | アーキテクチャの妥当性、非機能要件の実現可能性、技術的リスク、変更容易性 |
-| `xp-interaction-designer` | ユーザー体験 | UI/UX の一貫性、ユーザーの心理モデルとの整合、アクセシビリティ、画面遷移の自然さ |
-| `xp-tester` | テスト可能性 | 要件のテスト可能性、受入基準の明確さ、エッジケースの網羅性、テスト戦略との整合 |
-| `xp-user-representative` | 利用者視点 | 実際の業務での使いやすさ、業務フローとの整合性、ユーザーが本当に必要としている機能か |
-
-## レビュー対象と重点エージェント
-
-成果物の種類に応じて、特に重要なエージェントが異なる。ただし全エージェントを起動して多角的な視点を確保する。
-
-| 成果物 | 重点エージェント |
-|:---|:---|
-| 要件定義・ユースケース | xp-product-manager, xp-user-representative, xp-tester |
-| アーキテクチャ設計 | xp-architect, xp-tester |
-| データモデル・ドメインモデル | xp-architect, xp-product-manager |
-| UI 設計 | xp-interaction-designer, xp-user-representative |
-| テスト戦略 | xp-tester, xp-architect |
-| 非機能要件・運用要件 | xp-architect, xp-tester |
-
-## レビューワークフロー
-
-### 1. レビュー対象の特定
-
-レビュー対象のドキュメントを特定する。ユーザーが明示的に指定しない場合は `docs/design/` 配下を確認し、対象を提案する。
-
-### 2. エージェントの並列起動
-
-Agent ツールを使い、5 つのエージェントを **同一メッセージで並列起動** する。各エージェントには以下を指示する。
-
-```
-あなたは {エージェント名} です。
-.claude/agents/{エージェント名}.md の定義に従ってレビューしてください。
-
-## レビュー対象
-{ドキュメントパスとその内容の要約}
-
-## レビュー対象の種類
-{成果物カテゴリ: 要件定義 / アーキテクチャ設計 / データモデル / UI 設計 等}
-
-## レビュー観点
-{エージェント固有の着眼点}
-
-## 出力形式
-以下の形式でフィードバックを返してください：
-
-### 評価サマリー
-（1-2 文で全体評価）
-
-### 良い点
-- （具体的に）
-
-### 改善提案
-- 【重要度: 高/中/低】（具体的な改善提案と理由）
-
-### 懸念事項
-- （リスクや見落とされている観点）
-
-### スコープ外の発見
-- （レビュー対象外だが報告すべき問題）
-```
-
-#### Agent ツールが利用できない場合のフォールバック
-
-Agent ツールが利用できない環境では、5 つの視点を逐次的にシミュレートする。各エージェントの定義ファイル（`.claude/agents/{エージェント名}.md`）を読み、その視点でレビューを順次実施する。出力形式は同一のテンプレートに従う。
-
-### 3. フィードバックの統合
-
-全エージェントのフィードバックを受け取った後、以下の形式で統合レポートを作成する。
-
-```markdown
-## レビュー結果
-
-### レビュー対象
-- {ドキュメント名}
-
-### 総合評価
-（全エージェントの評価を統合した 2-3 文の評価）
-
-### 改善提案（重要度順）
-
-#### 高
-| # | 提案 | 指摘元 | 理由 |
-|---|------|--------|------|
-
-#### 中
-| # | 提案 | 指摘元 | 理由 |
-|---|------|--------|------|
-
-#### 低
-| # | 提案 | 指摘元 | 理由 |
-|---|------|--------|------|
-
-### 矛盾事項
-
-複数エージェントの指摘が相反する場合、ここに記載する。
-
-| # | 視点 A | 視点 B | 論点 | 推奨判断 |
-|---|--------|--------|------|----------|
-
-### エージェント別フィードバック詳細
-
-<details>
-<summary>xp-product-manager（高: N / 中: N / 低: N）</summary>
-（フィードバック全文）
-</details>
-
-<details>
-<summary>xp-architect（高: N / 中: N / 低: N）</summary>
-（フィードバック全文）
-</details>
-
-<details>
-<summary>xp-interaction-designer（高: N / 中: N / 低: N）</summary>
-（フィードバック全文）
-</details>
-
-<details>
-<summary>xp-tester（高: N / 中: N / 低: N）</summary>
-（フィードバック全文）
-</details>
-
-<details>
-<summary>xp-user-representative（高: N / 中: N / 低: N）</summary>
-（フィードバック全文）
-</details>
-```
-
-### 4. 改善アクションの提案
-
-統合レポートに基づき、具体的な改善アクションを提案する。改善は重要度「高」から着手することを推奨する。
-
-### 5. レビュー結果の保存
-
-統合レポートを `docs/review/{対象名}_review_{YYYYMMDD}.md` に保存する。過去のレビュー結果と比較できるようにし、改善のトレーサビリティを確保する。
-
-## レビュー完了条件
-
-以下をすべて満たした場合にレビュー完了とする。
-
-- 全エージェントのフィードバックが収集済み
-- 統合レポートが作成済み
-- 重要度「高」の指摘について対応方針（修正する / 許容する / 保留する）が決定済み
-- レビュー結果がドキュメントとして保存済み
-
-## 注意事項
-
-- レビューは成果物の品質向上が目的であり、批判が目的ではない
-- レビュー対象が複数ドキュメントにまたがる場合は、関連性の高いものをまとめてレビューする
-- TDD サイクルの遵守状況（テストが先に書かれているか）もレビュー観点に含める
-
-## 関連スキル
-
-- `orchestrating-analysis` — 分析フェーズの全体ワークフロー
-- `analyzing-*` — 各分析工程のスキル
-- `git-commit` — レビュー結果の保存後のコミット
+---
+name: analyzing-review
+description: 分析成果物のマルチパースペクティブレビューを実施。XP エージェント（プロダクトマネージャー、アーキテクト、インタラクションデザイナー、テスター、ユーザー代表）を並列起動し、専門的視点からフィードバックを収集・統合する。「分析ドキュメントをレビューしたい」「要件定義をレビューして」「アーキテクチャ設計のレビューをお願い」「設計ドキュメントにフィードバックがほしい」「分析結果を検証したい」「ユースケースをチェックして」といった場面で発動する。分析フェーズの成果物に対するレビュー依頼があれば積極的に使用すること。
+---
+
+# 分析成果物レビュー
+
+分析フェーズの成果物（要件定義、アーキテクチャ設計、データモデル、ドメインモデル、UI 設計、テスト戦略、非機能要件、運用要件など）を複数の XP エージェントで並列レビューし、多角的なフィードバックを統合する。
+
+## レビューの価値
+
+分析成果物のレビューは、開発フェーズに入る前に問題を発見する最も効果的な手段。1 人の視点では見落としがちな矛盾や不足を、異なる専門性を持つエージェントが同時に検証することで、手戻りコストを大幅に削減できる。
+
+## レビューエージェント
+
+各エージェントは独自の専門的視点でレビューを行う。全エージェントを並列起動し、独立したフィードバックを収集する。
+
+| エージェント | 視点 | 着眼点 |
+|:---|:---|:---|
+| `xp-product-manager` | ビジネス価値 | 要件の完全性、ビジネス価値との整合性、ストーリーの INVEST 基準、優先順位の妥当性 |
+| `xp-architect` | 技術的実現性 | アーキテクチャの妥当性、非機能要件の実現可能性、技術的リスク、変更容易性 |
+| `xp-interaction-designer` | ユーザー体験 | UI/UX の一貫性、ユーザーの心理モデルとの整合、アクセシビリティ、画面遷移の自然さ |
+| `xp-tester` | テスト可能性 | 要件のテスト可能性、受入基準の明確さ、エッジケースの網羅性、テスト戦略との整合 |
+| `xp-user-representative` | 利用者視点 | 実際の業務での使いやすさ、業務フローとの整合性、ユーザーが本当に必要としている機能か |
+
+## レビュー対象と重点エージェント
+
+成果物の種類に応じて、特に重要なエージェントが異なる。ただし全エージェントを起動して多角的な視点を確保する。
+
+| 成果物 | 重点エージェント |
+|:---|:---|
+| 要件定義・ユースケース | xp-product-manager, xp-user-representative, xp-tester |
+| アーキテクチャ設計 | xp-architect, xp-tester |
+| データモデル・ドメインモデル | xp-architect, xp-product-manager |
+| UI 設計 | xp-interaction-designer, xp-user-representative |
+| テスト戦略 | xp-tester, xp-architect |
+| 非機能要件・運用要件 | xp-architect, xp-tester |
+
+## レビューワークフロー
+
+### 1. レビュー対象の特定
+
+レビュー対象のドキュメントを特定する。ユーザーが明示的に指定しない場合は `docs/design/` 配下を確認し、対象を提案する。
+
+### 2. エージェントの並列起動
+
+Agent ツールを使い、5 つのエージェントを **同一メッセージで並列起動** する。各エージェントには以下を指示する。
+
+```
+あなたは {エージェント名} です。
+.claude/agents/{エージェント名}.md の定義に従ってレビューしてください。
+
+## レビュー対象
+{ドキュメントパスとその内容の要約}
+
+## レビュー対象の種類
+{成果物カテゴリ: 要件定義 / アーキテクチャ設計 / データモデル / UI 設計 等}
+
+## レビュー観点
+{エージェント固有の着眼点}
+
+## 出力形式
+以下の形式でフィードバックを返してください：
+
+### 評価サマリー
+（1-2 文で全体評価）
+
+### 良い点
+- （具体的に）
+
+### 改善提案
+- 【重要度: 高/中/低】（具体的な改善提案と理由）
+
+### 懸念事項
+- （リスクや見落とされている観点）
+
+### スコープ外の発見
+- （レビュー対象外だが報告すべき問題）
+```
+
+#### Agent ツールが利用できない場合のフォールバック
+
+Agent ツールが利用できない環境では、5 つの視点を逐次的にシミュレートする。各エージェントの定義ファイル（`.claude/agents/{エージェント名}.md`）を読み、その視点でレビューを順次実施する。出力形式は同一のテンプレートに従う。
+
+### 3. フィードバックの統合
+
+全エージェントのフィードバックを受け取った後、以下の形式で統合レポートを作成する。
+
+```markdown
+## レビュー結果
+
+### レビュー対象
+- {ドキュメント名}
+
+### 総合評価
+（全エージェントの評価を統合した 2-3 文の評価）
+
+### 改善提案（重要度順）
+
+#### 高
+| # | 提案 | 指摘元 | 理由 |
+|---|------|--------|------|
+
+#### 中
+| # | 提案 | 指摘元 | 理由 |
+|---|------|--------|------|
+
+#### 低
+| # | 提案 | 指摘元 | 理由 |
+|---|------|--------|------|
+
+### 矛盾事項
+
+複数エージェントの指摘が相反する場合、ここに記載する。
+
+| # | 視点 A | 視点 B | 論点 | 推奨判断 |
+|---|--------|--------|------|----------|
+
+### エージェント別フィードバック詳細
+
+<details>
+<summary>xp-product-manager（高: N / 中: N / 低: N）</summary>
+（フィードバック全文）
+</details>
+
+<details>
+<summary>xp-architect（高: N / 中: N / 低: N）</summary>
+（フィードバック全文）
+</details>
+
+<details>
+<summary>xp-interaction-designer（高: N / 中: N / 低: N）</summary>
+（フィードバック全文）
+</details>
+
+<details>
+<summary>xp-tester（高: N / 中: N / 低: N）</summary>
+（フィードバック全文）
+</details>
+
+<details>
+<summary>xp-user-representative（高: N / 中: N / 低: N）</summary>
+（フィードバック全文）
+</details>
+```
+
+### 4. 改善アクションの提案
+
+統合レポートに基づき、具体的な改善アクションを提案する。改善は重要度「高」から着手することを推奨する。
+
+### 5. レビュー結果の保存
+
+統合レポートを `docs/review/{対象名}_review_{YYYYMMDD}.md` に保存する。過去のレビュー結果と比較できるようにし、改善のトレーサビリティを確保する。
+
+## レビュー完了条件
+
+以下をすべて満たした場合にレビュー完了とする。
+
+- 全エージェントのフィードバックが収集済み
+- 統合レポートが作成済み
+- 重要度「高」の指摘について対応方針（修正する / 許容する / 保留する）が決定済み
+- レビュー結果がドキュメントとして保存済み
+
+## 注意事項
+
+- レビューは成果物の品質向上が目的であり、批判が目的ではない
+- レビュー対象が複数ドキュメントにまたがる場合は、関連性の高いものをまとめてレビューする
+- TDD サイクルの遵守状況（テストが先に書かれているか）もレビュー観点に含める
+
+## 関連スキル
+
+- `orchestrating-analysis` — 分析フェーズの全体ワークフロー
+- `analyzing-*` — 各分析工程のスキル
+- `git-commit` — レビュー結果の保存後のコミット