@sk8metal/michi-cli 0.8.7 → 0.11.0

package/templates/claude/commands/michi-multi-repo/spec-review.md

@@ -0,0 +1,261 @@
+---
+description: Multi-Repoプロジェクトのクロスリポジトリ仕様レビューを実行
+allowed-tools: Task, Bash, Read, Write, Edit, Glob, Grep
+argument-hint: <project-name> [--focus api|data|event|deps|test|all]
+---
+
+# Multi-Repo Cross-Repository Review
+
+<background_information>
+- **Mission**: 複数リポジトリにまたがる仕様の整合性を検証
+- **Success Criteria**:
+  - 全リポジトリの仕様を収集・分析
+  - API契約、データモデル、イベントスキーマの整合性を検証
+  - 品質ゲート判定を実行
+  - 修正が必要な箇所を明確に報告
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の全リポジトリを対象に、クロスリポジトリレビューを実行します。
+
+## 引数解析
+
+引数の形式:
+```
+/michi-multi-repo:spec-review <project-name> [--focus <focus>]
+```
+
+パラメータ:
+- **$1**: プロジェクト名（必須）
+- **--focus**: レビュー観点（オプション、デフォルト: all）
+  - `api`: API契約整合性のみ
+  - `data`: データモデル整合性のみ
+  - `event`: イベントスキーマ整合性のみ
+  - `deps`: 依存関係整合性のみ
+  - `test`: テスト仕様整合性のみ
+  - `all`: 全観点（デフォルト）
+
+## Execution Steps
+
+### Step 1: コンテキスト読み込み
+
+1. `.michi/config.json` からプロジェクト情報取得
+   - プロジェクト名
+   - 登録リポジトリ一覧
+
+2. 各リポジトリの `localPath` を取得
+
+3. 親プロジェクトの仕様を読み込み
+   - `docs/michi/$1/overview/requirements.md`
+   - `docs/michi/$1/overview/architecture.md`
+
+### Step 2: localPath 検証
+
+各リポジトリについて以下を確認:
+- localPathが設定されているか
+- ディレクトリが存在するか
+- Gitリポジトリか (`.git/`ディレクトリ確認)
+- Michiがセットアップ済みか (`.kiro/project.json`確認)
+- 仕様ファイルが存在するか
+
+**検証失敗時の対応**:
+- localPath未設定: 警告を出力し、スキップ
+- ディレクトリ不存在: エラーを出力し、スキップ
+- Michi未セットアップ: 警告を出力し、スキップ
+- 仕様ファイル不存在: 警告を出力し、利用可能情報でレビュー続行
+
+### Step 3: サブエージェント起動
+
+cross-repo-reviewerサブエージェントを使用して、以下のプロジェクトをレビューしてください：
+
+- PROJECT_NAME: $1
+- REPOSITORIES:
+  - {repo1.name}: {repo1.localPath}
+  - {repo2.name}: {repo2.localPath}
+  - ...
+- REVIEW_FOCUS: {指定されたfocus}
+
+品質ゲート判定結果をレポートしてください。
+
+### Step 4: レビューレポート出力
+
+出力先: `docs/michi/$1/reviews/cross-repo-review-{timestamp}.md`
+
+レポート形式:
+
+```markdown
+## Multi-Repo Cross-Repository Review Report
+
+**プロジェクト**: $1
+**レビュー日時**: {timestamp}
+**対象リポジトリ**: {count}件
+**レビュー観点**: {focus}
+
+---
+
+### サマリー
+
+| カテゴリ | ステータス | 問題件数 |
+|---------|----------|---------|
+| API契約整合性 | ✅/⚠️/❌ | N件 |
+| データモデル整合性 | ✅/⚠️/❌ | N件 |
+| イベントスキーマ整合性 | ✅/⚠️/❌ | N件 |
+| 依存関係整合性 | ✅/⚠️/❌ | N件 |
+| テスト仕様整合性 | ✅/⚠️/❌ | N件 |
+
+---
+
+### 検出された問題
+
+#### 🔴 BLOCK (修正必須)
+
+（cross-repo-reviewerが検出した重大な不整合）
+
+#### 🟡 WARN (修正推奨)
+
+（cross-repo-reviewerが検出した軽微な不整合）
+
+---
+
+### 品質ゲート判定
+
+**判定**: ❌ 不合格 / ⚠️ 条件付き合格 / ✅ 合格
+
+**理由**: {判定理由}
+
+---
+
+### 次のアクション
+
+1. BLOCK問題の修正
+2. `/michi-multi-repo:spec-review $1` を再実行
+3. 合格後、各リポジトリで実装を開始
+```
+
+### Step 5: 判定結果の表示
+
+**合格時（✅ PASS）**:
+```markdown
+🎉 品質ゲート合格
+
+全リポジトリの仕様が整合性基準を満たしています。
+
+### 次のステップ
+
+1. 各リポジトリでタスク生成:
+   各リポジトリで `/michi:spec-tasks {feature}` を実行
+
+2. 全リポジトリで実装を開始:
+   `/michi-multi-repo:impl-all $1`
+
+3. CI/CD設定:
+   `michi multi-repo:ci-status $1` でCI結果を監視
+```
+
+**条件付き合格時（⚠️ WARN）**:
+```markdown
+⚠️ 品質ゲート条件付き合格
+
+WARN問題が検出されましたが、修正は任意です。
+
+### 検出された問題
+- {WARN問題のリスト}
+
+### 次のステップ（選択可能）
+
+A) WARN問題を修正してから実装開始（推奨）
+   - 各リポジトリのdesign.mdを修正
+   - `/michi-multi-repo:spec-review $1` を再実行
+
+B) そのまま実装開始
+   - `/michi-multi-repo:impl-all $1`
+```
+
+**不合格時（❌ BLOCK）**:
+```markdown
+❌ 品質ゲート不合格
+
+BLOCK問題が検出されました。修正が必須です。
+
+### BLOCK問題
+- {BLOCK問題のリスト}
+
+### 対処方法
+
+1. 該当リポジトリのdesign.mdを修正
+2. `/michi-multi-repo:spec-review $1` を再実行
+3. 合格後に実装を開始
+
+**注意**: BLOCK問題を未解決のまま実装を開始すると、サービス間通信が失敗する可能性があります。
+```
+
+## Important Constraints
+- 読み取り操作のみ（各リポジトリへの書き込みは行わない）
+- localPath未設定のリポジトリはスキップ（警告を出力）
+- 大規模リポジトリの場合は主要ファイルのみ分析
+
+</instructions>
+
+## Tool Guidance
+- **Task**: cross-repo-reviewerサブエージェント起動に使用
+- **Read**: プロジェクト仕様、各リポジトリ仕様の読み込み
+- **Write**: レビューレポートの出力
+- **Glob/Grep**: 仕様ファイルの検索
+
+## Output Description
+
+日本語で以下の情報を出力してください:
+
+1. **レビュー対象リポジトリ一覧**: 各リポジトリのlocalPathと仕様状態
+2. **検出された問題**: BLOCK/WARN分類と詳細
+3. **品質ゲート判定結果**: 合格/不合格と理由
+4. **次のアクション**: 修正が必要な場合の具体的な手順
+
+## Safety & Fallback
+
+### Error Scenarios
+
+- **プロジェクト未登録**:
+  ```
+  エラー: プロジェクト '$1' が見つかりません。
+  ```
+
+- **親プロジェクト仕様未作成**:
+  ```
+  エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md
+
+  先に親プロジェクトの設計を作成してください:
+  /michi-multi-repo:spec-design $1
+  ```
+
+- **localPath未設定**:
+  ```
+  警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
+  ```
+
+- **Michi未セットアップ**:
+  ```
+  ⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
+
+  セットアップコマンド:
+  cd {localPath} && npx @sk8metal/michi-cli@latest init
+
+  セットアップ完了後、このコマンドを再実行してください。
+  ```
+
+- **仕様ファイル不存在**:
+  ```
+  警告: リポジトリ '{name}' に仕様ファイルがありません。
+
+  仕様を展開してください:
+  /michi-multi-repo:propagate-specs $1
+  ```
+
+### Fallback Strategy
+- localPath未設定: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
+- 仕様ファイル不存在: 警告を出力し、利用可能な情報でレビュー
+- 通信エラー: リトライ後、該当リポジトリをスキップ
+
+think hard

package/templates/claude/skills/mermaid-validator/SKILL.md

@@ -0,0 +1,261 @@
+---
+name: mermaid-validator
+description: |
+  Mermaid図の構文検証と修正を行うスキル。
+  architecture.md生成時のパースエラーを防止。
+allowed-tools: Bash, Read, Grep, Glob, WebFetch, Edit, Write
+---
+
+# Mermaid Validator スキル
+
+## 目的
+
+Mermaid図の構文エラーを検出し、自動修正を行うことで、ドキュメント生成時のパースエラーを防止する。
+
+## 対象ファイル
+
+### 自動検証対象
+
+- `docs/**/architecture.md`
+- `docs/**/design.md`
+- `docs/**/sequence.md`
+- `*.md` (Mermaid図を含むすべてのMarkdownファイル)
+
+### 主な検証ポイント
+
+1. **構文エラー検出**
+   - 未閉じの括弧、引用符
+   - 無効なキーワード
+   - インデントの問題
+
+2. **C4モデル構文検証**
+   - `C4Context`, `C4Container`, `C4Component` の正しい使用
+   - `Person()`, `System()`, `Rel()` の引数チェック
+
+3. **シーケンス図検証**
+   - `participant` 宣言の確認
+   - 矢印記法（`->>`, `-->>`, `->>`）の正しい使用
+
+4. **グラフ構文検証**
+   - ノード定義の正しい記法
+   - サブグラフの構文チェック
+
+## Mermaid構文クイックリファレンス
+
+### C4モデル
+
+```mermaid
+C4Context
+    title System Context Diagram
+
+    Person(user, "User", "エンドユーザー")
+    System(system, "System Name", "システム説明")
+    System_Ext(external, "External System", "外部システム")
+
+    Rel(user, system, "Uses", "HTTPS")
+    Rel(system, external, "Integrates", "REST/HTTPS")
+```
+
+**注意点**:
+- `C4Context` の後に改行が必要
+- `title` は必須ではないが推奨
+- `Rel()` の引数は必ず4つ（from, to, label, technology）
+
+### シーケンス図
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Frontend
+    participant Backend
+
+    User->>Frontend: リクエスト
+    Frontend->>Backend: API呼び出し
+    Backend-->>Frontend: レスポンス
+    Frontend-->>User: 表示
+```
+
+**注意点**:
+- `participant` 宣言は必須ではないが推奨
+- `->>`（同期）、`-->>`（非同期）、`-x`（破棄）を区別
+- ラベルに日本語を含む場合、引用符は不要
+
+### グラフ（フローチャート）
+
+```mermaid
+graph TB
+    A[クライアント] --> B[APIゲートウェイ]
+    B --> C[バックエンドサービス]
+    C --> D[データベース]
+    C --> E[外部API]
+```
+
+**注意点**:
+- `graph TB`（上から下）、`graph LR`（左から右）
+- ノードラベルに日本語を含む場合、`[]` で囲む
+- `subgraph` はインデント必須
+
+### ER図
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        string id
+        string name
+        string email
+    }
+    ORDER {
+        string id
+        string userId
+        date createdAt
+    }
+```
+
+**注意点**:
+- リレーションシップ記法: `||--o{`（1対多）、`}o--o{`（多対多）
+- フィールド定義は `type name` の順
+
+## 検証方法
+
+### オンライン検証（推奨）
+
+```bash
+# Mermaid Live Editorで検証
+# https://mermaid.live/
+
+# または、mermaid-cliを使用
+npx @mermaid-js/mermaid-cli mmdc -i diagram.mmd -o diagram.svg
+```
+
+### 手動検証
+
+```bash
+# Markdownファイル内のMermaid図を抽出
+grep -A 50 '```mermaid' architecture.md > extracted-diagrams.txt
+
+# 構文エラーを目視確認
+cat extracted-diagrams.txt
+```
+
+## よくある構文エラーと修正方法
+
+### エラー1: C4モデルでタイトルが不正
+
+**誤り**:
+```mermaid
+C4Context
+title: System Context Diagram
+```
+
+**修正**:
+```mermaid
+C4Context
+    title System Context Diagram
+```
+
+### エラー2: シーケンス図で矢印記法が不正
+
+**誤り**:
+```mermaid
+sequenceDiagram
+    User->Frontend: リクエスト
+```
+
+**修正**:
+```mermaid
+sequenceDiagram
+    User->>Frontend: リクエスト
+```
+
+### エラー3: グラフでサブグラフのインデント不足
+
+**誤り**:
+```mermaid
+graph TB
+subgraph "Production"
+A[Pod 1]
+end
+```
+
+**修正**:
+```mermaid
+graph TB
+    subgraph "Production"
+        A[Pod 1]
+    end
+```
+
+### エラー4: ER図でリレーションシップ記法が不正
+
+**誤り**:
+```mermaid
+erDiagram
+    USER -> ORDER : places
+```
+
+**修正**:
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+```
+
+## 自動修正ルール
+
+### ルール1: インデント正規化
+
+- C4モデルの要素をインデント
+- サブグラフをインデント
+- ERDのフィールド定義をインデント
+
+### ルール2: 引用符の補完
+
+- 特殊文字を含むラベルに引用符を追加
+- ただし、日本語のみの場合は不要
+
+### ルール3: 矢印記法の統一
+
+- シーケンス図で `->>` に統一（同期呼び出し）
+- 非同期の場合は `-->>` を使用
+
+## CI/CDへの組み込み
+
+### GitHub Actions 例
+
+```yaml
+name: Mermaid Validation
+
+on:
+  pull_request:
+    paths:
+      - 'docs/**/*.md'
+      - '**/*.md'
+
+jobs:
+  validate-mermaid:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '20'
+
+      - name: Validate Mermaid Diagrams
+        run: |
+          npm install -g @mermaid-js/mermaid-cli
+          find . -name "*.md" -exec sh -c '
+            grep -l "```mermaid" "$1" && {
+              echo "Validating $1"
+              mmdc -i "$1" -o /tmp/test.svg || exit 1
+            }
+          ' _ {} \;
+```
+
+## 参考資料
+
+- [Mermaid公式ドキュメント](https://mermaid.js.org/)
+- [Mermaid Live Editor](https://mermaid.live/)
+- [C4モデルガイド](https://c4model.com/)
+- [Mermaid CLI](https://github.com/mermaid-js/mermaid-cli)

package/templates/claude-agent/agents/cross-repo-reviewer.md

@@ -0,0 +1,194 @@
+---
+name: cross-repo-reviewer
+description: 複数リポジトリ間の仕様整合性をレビュー。API契約、データモデル、イベントスキーマの一貫性をチェック。Multi-Repoプロジェクトのspec-review時にPROACTIVELY使用
+tools: Read, Glob, Grep
+model: sonnet
+---
+
+# Cross-Repository Reviewer
+
+あなたはMulti-Repoプロジェクトの横断的な仕様レビューを行う専門エージェントです。
+
+## 役割
+
+複数のリポジトリにまたがる仕様ファイルを読み込み、サービス間のインターフェース整合性を検証し、品質ゲート判定を行います。
+
+## レビュー観点
+
+### 1. API契約整合性
+
+**チェック項目**:
+- エンドポイントパスの一致（呼び出し側と提供側）
+- HTTPメソッドの一致
+- リクエストボディ構造の一致
+- レスポンスボディ構造の一致
+- ステータスコード定義の一致
+
+**検出パターン**:
+- 呼び出し元が期待するAPIが提供側で未定義
+- リクエスト/レスポンスの型不一致
+- 必須フィールドの不一致
+
+### 2. データモデル整合性
+
+**チェック項目**:
+- エンティティ定義の一致
+- フィールド名・型の一致
+- 必須/オプショナル属性の一致
+- 列挙型の値リスト一致
+
+**検出パターン**:
+- 同一概念に異なるフィールド名（userId vs user_id）
+- 型の不一致（string vs number）
+- 外部キー参照の不整合
+
+### 3. イベントスキーマ整合性
+
+**チェック項目**:
+- イベント名/トピック名の一致
+- ペイロード構造の一致
+- メタデータ（タイムスタンプ、バージョン）の一致
+
+**検出パターン**:
+- Publisher側とSubscriber側のイベント名不一致
+- ペイロードフィールドの欠落
+- スキーマバージョン不一致
+
+### 4. 依存関係整合性
+
+**チェック項目**:
+- サービス間依存方向の妥当性
+- バージョン要件の整合性
+- 障害影響範囲の明確さ
+
+### 5. テスト仕様整合性
+
+**チェック項目**:
+- 統合テスト境界の明確さ
+- E2Eシナリオの網羅性
+- 契約テスト（Contract Testing）の実施
+
+## 品質ゲート判定
+
+### 判定基準
+
+#### 🔴 BLOCK（重大な不整合 - 即時修正必須）
+- API契約の不一致（エンドポイント、スキーマ）
+- 必須要件の欠落
+- セキュリティ設計の不整合
+
+#### 🟡 WARN（軽微な不整合 - 修正推奨）
+- 命名規則の不統一
+- 推奨設計パターンからの逸脱
+- ドキュメント不足
+
+#### 🟢 PASS（問題なし）
+- 全チェック項目が基準を満たす
+
+### 判定ロジック
+
+```
+if (BLOCK問題が1件以上):
+    品質ゲート判定 = ❌ 不合格
+elif (WARN問題のみ):
+    品質ゲート判定 = ⚠️ 条件付き合格
+else:
+    品質ゲート判定 = ✅ 合格
+```
+
+## 実行フロー
+
+### Phase 1: 情報収集
+
+各リポジトリ（{{REPOSITORIES}}）について:
+
+1. requirements.md を読み込み
+2. design.md を読み込み
+3. test-specs/ を読み込み
+4. API定義、データモデル、イベントスキーマを抽出
+
+### Phase 2: 整合性分析
+
+収集した情報を統合し、以下を分析:
+
+1. **サービス間API呼び出しマトリックス**
+   - 呼び出し元 → 呼び出し先のペアを洗い出し
+   - 各ペアでAPI契約を検証
+
+2. **共有データモデル一覧**
+   - 複数サービスで使用されるエンティティを特定
+   - 定義の一貫性を検証
+
+3. **イベントフローダイアグラム**
+   - Publisher → Subscriber の関係を図示
+   - スキーマの一貫性を検証
+
+### Phase 3: レポート生成
+
+`docs/michi/{{PROJECT_NAME}}/reviews/cross-repo-review-{timestamp}.md` にレポートを出力
+
+## 出力形式
+
+```markdown
+## Multi-Repo Cross-Repository Review Report
+
+**プロジェクト**: {{PROJECT_NAME}}
+**レビュー日時**: {timestamp}
+**対象リポジトリ**: {count}件
+
+---
+
+### サマリー
+
+| カテゴリ | ステータス | 問題件数 |
+|---------|----------|---------|
+| API契約整合性 | ✅/⚠️/❌ | N件 |
+| データモデル整合性 | ✅/⚠️/❌ | N件 |
+| イベントスキーマ整合性 | ✅/⚠️/❌ | N件 |
+| 依存関係整合性 | ✅/⚠️/❌ | N件 |
+| テスト仕様整合性 | ✅/⚠️/❌ | N件 |
+
+---
+
+### 検出された問題
+
+#### 🔴 BLOCK (修正必須)
+
+##### Issue 1: [API-001] エンドポイント不整合
+- **発生箇所**: Frontend → Backend
+- **詳細**: `POST /api/v1/users` が Backend 設計書に未定義
+- **影響**: ユーザー作成フローが動作不可
+- **推奨アクション**: Backend の design.md にエンドポイント定義を追加
+
+#### 🟡 WARN (修正推奨)
+
+##### Issue 2: [DATA-001] フィールド名不一致
+- **発生箇所**: User Service ↔ Notification Service
+- **詳細**: `userId` (User Service) vs `user_id` (Notification Service)
+- **影響**: イベント処理時のマッピングエラー
+- **推奨アクション**: 命名規則を統一（camelCase推奨）
+
+---
+
+### 品質ゲート判定
+
+**判定**: ❌ 不合格 / ⚠️ 条件付き合格 / ✅ 合格
+
+**理由**: {判定理由}
+
+---
+
+### 次のアクション
+
+1. BLOCK問題の修正
+2. `/michi-multi-repo:spec-review {project}` を再実行
+3. 合格後、各リポジトリで実装を開始
+```
+
+## 重要な制約
+
+1. **読み取り専用**: このエージェントは仕様ファイルの読み取りのみを行います。ファイルの修正は行いません
+
+2. **localPath未設定時**: localPathが設定されていないリポジトリは警告を出力し、スキップします
+
+3. **仕様ファイル不在時**: design.mdが存在しない場合、警告を出力し、利用可能な情報のみでレビューを続行します