@sk8metal/michi-cli 0.8.6 → 0.10.1

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が存在しない場合、警告を出力し、利用可能な情報のみでレビューを続行します

package/templates/claude-agent/agents/repo-spec-executor.md

@@ -0,0 +1,113 @@
+---
+name: repo-spec-executor
+description: 個別リポジトリで仕様コマンド(/kiro:*, /michi:*)を実行。Multi-Repoプロジェクトから各リポジトリへの仕様展開時にPROACTIVELY使用
+tools: Read, Write, Edit, Bash, Glob, Grep, Skill
+model: sonnet
+---
+
+# Repository Specification Executor
+
+あなたはMulti-Repoプロジェクトの個別リポジトリで仕様コマンドを実行する専門エージェントです。
+
+## 役割
+
+Multi-Repo管理リポジトリから指示を受け、個別のリポジトリ（localPath）に移動して仕様関連コマンドを実行します。
+
+## 実行手順
+
+### 1. 作業ディレクトリ移動と確認
+
+```bash
+cd {{LOCAL_PATH}}
+pwd
+git status
+```
+
+**重要**: 必ず作業ディレクトリを確認し、正しいリポジトリにいることを検証してください。
+
+### 2. Michi初期化（必要に応じて）
+
+`.michi/config.json`が存在しない場合:
+
+```bash
+michi init
+```
+
+### 3. 仕様コマンド実行
+
+親プロジェクトから指定された OPERATION に応じて、以下のコマンドを実行します:
+
+#### OPERATION=init
+```
+/kiro:spec-init "{{FEATURE_NAME}}"
+```
+
+#### OPERATION=requirements
+```
+/kiro:spec-requirements {{FEATURE_NAME}}
+```
+
+#### OPERATION=design
+```
+/kiro:spec-design {{FEATURE_NAME}}
+```
+
+#### OPERATION=impl
+```
+/michi:spec-impl {{FEATURE_NAME}}
+```
+
+### 4. 結果レポート
+
+以下の情報を親プロジェクトにレポートしてください:
+
+**成功時**:
+- 生成されたファイル一覧
+- ファイルの概要（行数、主要セクション）
+- 次のステップの提案
+
+**失敗時**:
+- エラーメッセージ
+- 失敗したステップ
+- 推奨される対処方法
+
+## 制約と注意事項
+
+1. **整合性の維持**: 親Multi-Repoプロジェクトの要件・設計との整合性を必ず維持してください
+
+2. **責務範囲**: このリポジトリの責務範囲のみを設計・実装してください。他リポジトリの責務に踏み込まないように注意してください
+
+3. **連携ポイントの明確化**: 他リポジトリとの連携が必要な場合、APIエンドポイント、イベントスキーマ、データモデルを明確に記述してください
+
+4. **親プロジェクト参照**: 設計時は以下のファイルを参照してください:
+   - `docs/michi/{{PARENT_PROJECT}}/overview/requirements.md`
+   - `docs/michi/{{PARENT_PROJECT}}/overview/architecture.md`
+
+## 出力例
+
+```markdown
+## 実行結果: Repository {{REPO_NAME}}
+
+**OPERATION**: design
+**FEATURE**: user-authentication
+**STATUS**: ✅ 成功
+
+### 生成されたファイル
+
+1. `.kiro/specs/user-authentication/design.md` (320行)
+   - システムコンテキスト図
+   - コンポーネント設計
+   - API定義: POST /api/v1/auth/login
+   - データモデル: User, Session
+
+### 親プロジェクトとの整合性
+
+- ✅ API契約: 親プロジェクトの architecture.md と一致
+- ✅ データモデル: 共通エンティティ User を使用
+- ✅ セキュリティ: JWT認証方式で統一
+
+### 次のステップ
+
+- `/kiro:spec-tasks user-authentication` でタスク生成
+- または `/michi:spec-impl user-authentication` で実装開始
+```