@sk8metal/michi-cli 0.13.0 → 0.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +86 -0
- package/README.md +27 -8
- package/dist/src/commands/setup-existing.d.ts.map +1 -1
- package/dist/src/commands/setup-existing.js +19 -74
- package/dist/src/commands/setup-existing.js.map +1 -1
- package/package.json +1 -1
- package/templates/claude/agents/design-reviewer/AGENT.md +0 -497
- package/templates/claude/agents/e2e-first-planner/AGENT.md +0 -410
- package/templates/claude/agents/mermaid-validator/AGENT.md +0 -257
- package/templates/claude/agents/oss-license-checker/AGENT.md +0 -265
- package/templates/claude/agents/pr-resolver/AGENT.md +0 -208
- package/templates/claude/agents/pr-size-monitor/AGENT.md +0 -330
- package/templates/claude/agents/stable-version-auditor/AGENT.md +0 -279
- package/templates/claude/commands/kiro/kiro-spec-impl.md +0 -257
- package/templates/claude/commands/kiro/kiro-spec-tasks.md +0 -370
- package/templates/claude/commands/michi/confluence-sync.md +0 -44
- package/templates/claude/commands/michi/design-review.md +0 -70
- package/templates/claude/commands/michi/e2e-plan.md +0 -117
- package/templates/claude/commands/michi/license-check.md +0 -84
- package/templates/claude/commands/michi/pr-resolve.md +0 -157
- package/templates/claude/commands/michi/project-switch.md +0 -42
- package/templates/claude/commands/michi/spec-design.md +0 -78
- package/templates/claude/commands/michi/spec-impl.md +0 -889
- package/templates/claude/commands/michi/spec-tasks.md +0 -156
- package/templates/claude/commands/michi/test-planning.md +0 -174
- package/templates/claude/commands/michi/validate-design.md +0 -58
- package/templates/claude/commands/michi/version-audit.md +0 -95
- package/templates/claude/commands/michi-multi-repo/impl-all.md +0 -293
- package/templates/claude/commands/michi-multi-repo/propagate-specs.md +0 -284
- package/templates/claude/commands/michi-multi-repo/spec-design.md +0 -359
- package/templates/claude/commands/michi-multi-repo/spec-init.md +0 -228
- package/templates/claude/commands/michi-multi-repo/spec-requirements.md +0 -198
- package/templates/claude/commands/michi-multi-repo/spec-review.md +0 -261
- package/templates/claude/rules/atlassian-integration.md +0 -35
- package/templates/claude/rules/michi-core.md +0 -54
- package/templates/claude/skills/design-review/SKILL.md +0 -648
- package/templates/claude/skills/e2e-first-planning/SKILL.md +0 -360
- package/templates/claude/skills/mermaid-validator/SKILL.md +0 -261
- package/templates/claude/skills/oss-license/SKILL.md +0 -232
- package/templates/claude/skills/stable-version/SKILL.md +0 -252
- package/templates/claude-agent/rules/code-size-monitor.md +0 -26
- package/templates/claude-agent/rules/code-size-rules.md +0 -32
- package/templates/michi/cc-sdd-overrides/README.md +0 -58
- package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md +0 -53
- package/templates/michi/cc-sdd-overrides/settings/templates/specs/init.json +0 -24
- package/templates/michi/cc-sdd-overrides/settings/templates/specs/tasks.md +0 -446
|
@@ -1,198 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Multi-Repoプロジェクトの要件定義書をAI支援で生成
|
|
3
|
-
allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch
|
|
4
|
-
argument-hint: <project-name>
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Multi-Repo Requirements Generation
|
|
8
|
-
|
|
9
|
-
<background_information>
|
|
10
|
-
- **Mission**: Multi-Repoプロジェクトの包括的な要件定義書をEARS形式で生成
|
|
11
|
-
- **Success Criteria**:
|
|
12
|
-
- 登録された全リポジトリの情報を反映
|
|
13
|
-
- リポジトリ間の依存関係とインターフェースを明記
|
|
14
|
-
- EARS形式の受入基準を含む
|
|
15
|
-
- サービス構成図(Mermaid)を含む
|
|
16
|
-
</background_information>
|
|
17
|
-
|
|
18
|
-
<instructions>
|
|
19
|
-
## Core Task
|
|
20
|
-
Multi-Repoプロジェクト **$1** の要件定義書を生成します。
|
|
21
|
-
|
|
22
|
-
## Execution Steps
|
|
23
|
-
|
|
24
|
-
### Step 1: プロジェクト情報の取得
|
|
25
|
-
1. `.michi/config.json` を読み込み、プロジェクト `$1` の情報を取得
|
|
26
|
-
2. プロジェクトが登録されていない場合は、`michi multi-repo:init` の実行を促す
|
|
27
|
-
3. 登録されたリポジトリ一覧を確認
|
|
28
|
-
4. リポジトリ数が0の場合は警告を出し、基本構造のみ生成
|
|
29
|
-
|
|
30
|
-
### Step 2: コンテキスト収集
|
|
31
|
-
1. **EARS形式ルール**: `.kiro/settings/rules/ears-format.md` を読み込み
|
|
32
|
-
- EARS形式(Event-Action-Response-System)の構文を理解
|
|
33
|
-
2. **既存要件テンプレート**: `templates/multi-repo/overview/requirements.md` を確認
|
|
34
|
-
3. **各リポジトリの情報収集**:
|
|
35
|
-
- リポジトリ名、URL、ブランチ
|
|
36
|
-
- 技術スタック(package.json、build.gradle、composer.json等から推測)
|
|
37
|
-
- 主要機能(README.mdから抽出)
|
|
38
|
-
- 注: ローカルクローンがない場合は、設定情報から推測
|
|
39
|
-
|
|
40
|
-
### Step 3: 要件定義書生成
|
|
41
|
-
以下のセクションを含む要件定義書を生成します:
|
|
42
|
-
|
|
43
|
-
1. **プロジェクト概要**
|
|
44
|
-
- プロジェクト名、JIRAキー、Confluenceスペース
|
|
45
|
-
- 複数リポジトリを統合したシステムの概要
|
|
46
|
-
- ビジネス価値
|
|
47
|
-
|
|
48
|
-
2. **サービス構成**
|
|
49
|
-
- 登録リポジトリ一覧(表形式)
|
|
50
|
-
- サービス間依存関係(Mermaidダイアグラム)
|
|
51
|
-
- 各サービスの役割説明
|
|
52
|
-
|
|
53
|
-
3. **インターフェース要件**
|
|
54
|
-
- サービス間API契約(エンドポイント一覧)
|
|
55
|
-
- イベント契約(Pub/Sub、メッセージキュー等)
|
|
56
|
-
- データフォーマット
|
|
57
|
-
|
|
58
|
-
4. **機能要件**
|
|
59
|
-
- 各サービスの機能要件をEARS形式で記述
|
|
60
|
-
- サービス横断的な機能要件(認証、ログ集約等)
|
|
61
|
-
|
|
62
|
-
5. **非機能要件**
|
|
63
|
-
- パフォーマンス要件(レスポンスタイム、スループット)
|
|
64
|
-
- セキュリティ要件(認証・認可、通信暗号化)
|
|
65
|
-
- 可用性要件(SLA、冗長化)
|
|
66
|
-
- 保守性要件(モニタリング、ログ)
|
|
67
|
-
|
|
68
|
-
### Step 4: ファイル保存
|
|
69
|
-
- 出力先: `docs/michi/$1/overview/requirements.md`
|
|
70
|
-
- 既存ファイルがある場合は、上書き確認を実施
|
|
71
|
-
- ファイル保存後、完了メッセージを表示
|
|
72
|
-
|
|
73
|
-
### Step 5: メタデータ更新(spec.json)
|
|
74
|
-
- `docs/michi/$1/spec.json` を読み込み
|
|
75
|
-
- phase を `"requirements-generated"` に更新
|
|
76
|
-
- `approvals.requirements.generated` を `true` に更新
|
|
77
|
-
- `updated_at` を現在のISO 8601タイムスタンプに更新
|
|
78
|
-
- spec.json を保存
|
|
79
|
-
|
|
80
|
-
## Multi-Repo固有セクション
|
|
81
|
-
要件定義書に以下のセクションを必ず含めること:
|
|
82
|
-
|
|
83
|
-
```markdown
|
|
84
|
-
## サービス構成
|
|
85
|
-
|
|
86
|
-
### 登録リポジトリ一覧
|
|
87
|
-
|
|
88
|
-
| サービス名 | リポジトリURL | ブランチ | 役割 | 技術スタック |
|
|
89
|
-
|-----------|---------------|---------|------|-------------|
|
|
90
|
-
| frontend | https://github.com/org/frontend | main | ユーザーインターフェース | React, TypeScript |
|
|
91
|
-
| backend | https://github.com/org/backend | main | APIサーバー | Node.js, Express |
|
|
92
|
-
|
|
93
|
-
### サービス間依存関係
|
|
94
|
-
|
|
95
|
-
\`\`\`mermaid
|
|
96
|
-
graph TB
|
|
97
|
-
A[Frontend] -->|REST API| B[API Gateway]
|
|
98
|
-
B -->|HTTP| C[Auth Service]
|
|
99
|
-
B -->|HTTP| D[User Service]
|
|
100
|
-
C -->|gRPC| E[Database]
|
|
101
|
-
D -->|gRPC| E
|
|
102
|
-
\`\`\`
|
|
103
|
-
|
|
104
|
-
## インターフェース要件
|
|
105
|
-
|
|
106
|
-
### API契約
|
|
107
|
-
|
|
108
|
-
**Auth Service → User Service**
|
|
109
|
-
- エンドポイント: `POST /api/v1/auth/verify`
|
|
110
|
-
- プロトコル: HTTP/REST
|
|
111
|
-
- データ形式: JSON
|
|
112
|
-
|
|
113
|
-
### イベント契約
|
|
114
|
-
|
|
115
|
-
**User Service → Notification Service**
|
|
116
|
-
- イベント: `user.created`
|
|
117
|
-
- プロトコル: Kafka
|
|
118
|
-
- スキーマ: { userId, email, createdAt }
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## Important Constraints
|
|
122
|
-
- EARS形式を厳守(When/If/While/Where/The system shall)
|
|
123
|
-
- サービス名を明確にする(例: The Frontend Service shall...)
|
|
124
|
-
- 要件はテスト可能であること
|
|
125
|
-
- 実装詳細は含めない(WHAT、not HOW)
|
|
126
|
-
|
|
127
|
-
</instructions>
|
|
128
|
-
|
|
129
|
-
## Tool Guidance
|
|
130
|
-
- **Read first**: プロジェクト設定、EARS形式ルール、テンプレートを読み込み
|
|
131
|
-
- **Write last**: 要件定義書を最後に保存
|
|
132
|
-
- **WebSearch/WebFetch**: 外部ドメイン知識が必要な場合のみ使用
|
|
133
|
-
|
|
134
|
-
## Output Description
|
|
135
|
-
以下の情報を出力してください:
|
|
136
|
-
|
|
137
|
-
1. **生成された要件定義書のパス**: `docs/michi/{project}/overview/requirements.md`
|
|
138
|
-
2. **含まれるリポジトリ/サービスの一覧**: サービス名と役割の要約
|
|
139
|
-
3. **次のステップ**:
|
|
140
|
-
- `/michi-multi-repo:spec-design $1` で設計書を生成
|
|
141
|
-
- `michi multi-repo:confluence-sync $1 --doc-type requirements` でConfluenceに同期
|
|
142
|
-
|
|
143
|
-
**出力形式**:
|
|
144
|
-
```markdown
|
|
145
|
-
## 要件定義書生成完了
|
|
146
|
-
|
|
147
|
-
### 出力ファイル
|
|
148
|
-
`docs/michi/{project}/overview/requirements.md`
|
|
149
|
-
|
|
150
|
-
### 含まれるサービス
|
|
151
|
-
- **Frontend**: ユーザーインターフェース(React)
|
|
152
|
-
- **Backend**: APIサーバー(Node.js)
|
|
153
|
-
- **Database**: データ永続化(PostgreSQL)
|
|
154
|
-
|
|
155
|
-
### 次のステップ
|
|
156
|
-
1. 要件定義書を確認: `docs/michi/{project}/overview/requirements.md`
|
|
157
|
-
2. 設計書を生成: `/michi-multi-repo:spec-design {project}`
|
|
158
|
-
3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type requirements`
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
## Safety & Fallback
|
|
162
|
-
|
|
163
|
-
### Error Scenarios
|
|
164
|
-
- **プロジェクト未登録**:
|
|
165
|
-
```
|
|
166
|
-
エラー: プロジェクト '{project}' が見つかりません。
|
|
167
|
-
|
|
168
|
-
次のコマンドでプロジェクトを初期化してください:
|
|
169
|
-
michi multi-repo:init {project} --jira {JIRA_KEY} --confluence-space {SPACE}
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
- **リポジトリ未登録**:
|
|
173
|
-
```
|
|
174
|
-
警告: プロジェクト '{project}' にリポジトリが登録されていません。
|
|
175
|
-
|
|
176
|
-
基本的な要件定義書の骨格を生成しますが、サービス固有の情報は含まれません。
|
|
177
|
-
|
|
178
|
-
次のコマンドでリポジトリを登録してください:
|
|
179
|
-
michi multi-repo:add-repo {project} --name {name} --url {url} --branch {branch}
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
- **既存ファイル存在**:
|
|
183
|
-
```
|
|
184
|
-
警告: 既存の要件定義書が存在します: `docs/michi/{project}/overview/requirements.md`
|
|
185
|
-
|
|
186
|
-
上書きしてもよろしいですか? (y/n)
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
- **EARS形式ルール未取得**:
|
|
190
|
-
- `.kiro/settings/rules/ears-format.md` が存在しない場合、基本的なEARS形式を使用
|
|
191
|
-
- 警告メッセージを表示
|
|
192
|
-
|
|
193
|
-
### Fallback Strategy
|
|
194
|
-
- ローカルクローンがないリポジトリ: 設定情報(名前、URL)のみから推測
|
|
195
|
-
- 技術スタック不明: "未指定" として記載
|
|
196
|
-
- 依存関係不明: 基本的なクライアント-サーバー構成を仮定
|
|
197
|
-
|
|
198
|
-
think hard
|
|
@@ -1,261 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Multi-Repoプロジェクトのクロスリポジトリ仕様レビューを実行
|
|
3
|
-
allowed-tools: Task, Bash, Read, Write, Edit, Glob, Grep
|
|
4
|
-
argument-hint: <project-name> [--focus api|data|event|deps|test|all]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Multi-Repo Cross-Repository Review
|
|
8
|
-
|
|
9
|
-
<background_information>
|
|
10
|
-
- **Mission**: 複数リポジトリにまたがる仕様の整合性を検証
|
|
11
|
-
- **Success Criteria**:
|
|
12
|
-
- 全リポジトリの仕様を収集・分析
|
|
13
|
-
- API契約、データモデル、イベントスキーマの整合性を検証
|
|
14
|
-
- 品質ゲート判定を実行
|
|
15
|
-
- 修正が必要な箇所を明確に報告
|
|
16
|
-
</background_information>
|
|
17
|
-
|
|
18
|
-
<instructions>
|
|
19
|
-
## Core Task
|
|
20
|
-
Multi-Repoプロジェクト **$1** の全リポジトリを対象に、クロスリポジトリレビューを実行します。
|
|
21
|
-
|
|
22
|
-
## 引数解析
|
|
23
|
-
|
|
24
|
-
引数の形式:
|
|
25
|
-
```
|
|
26
|
-
/michi-multi-repo:spec-review <project-name> [--focus <focus>]
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
パラメータ:
|
|
30
|
-
- **$1**: プロジェクト名(必須)
|
|
31
|
-
- **--focus**: レビュー観点(オプション、デフォルト: all)
|
|
32
|
-
- `api`: API契約整合性のみ
|
|
33
|
-
- `data`: データモデル整合性のみ
|
|
34
|
-
- `event`: イベントスキーマ整合性のみ
|
|
35
|
-
- `deps`: 依存関係整合性のみ
|
|
36
|
-
- `test`: テスト仕様整合性のみ
|
|
37
|
-
- `all`: 全観点(デフォルト)
|
|
38
|
-
|
|
39
|
-
## Execution Steps
|
|
40
|
-
|
|
41
|
-
### Step 1: コンテキスト読み込み
|
|
42
|
-
|
|
43
|
-
1. `.michi/config.json` からプロジェクト情報取得
|
|
44
|
-
- プロジェクト名
|
|
45
|
-
- 登録リポジトリ一覧
|
|
46
|
-
|
|
47
|
-
2. 各リポジトリの `localPath` を取得
|
|
48
|
-
|
|
49
|
-
3. 親プロジェクトの仕様を読み込み
|
|
50
|
-
- `docs/michi/$1/overview/requirements.md`
|
|
51
|
-
- `docs/michi/$1/overview/architecture.md`
|
|
52
|
-
|
|
53
|
-
### Step 2: localPath 検証
|
|
54
|
-
|
|
55
|
-
各リポジトリについて以下を確認:
|
|
56
|
-
- localPathが設定されているか
|
|
57
|
-
- ディレクトリが存在するか
|
|
58
|
-
- Gitリポジトリか (`.git/`ディレクトリ確認)
|
|
59
|
-
- Michiがセットアップ済みか (`.kiro/project.json`確認)
|
|
60
|
-
- 仕様ファイルが存在するか
|
|
61
|
-
|
|
62
|
-
**検証失敗時の対応**:
|
|
63
|
-
- localPath未設定: 警告を出力し、スキップ
|
|
64
|
-
- ディレクトリ不存在: エラーを出力し、スキップ
|
|
65
|
-
- Michi未セットアップ: 警告を出力し、スキップ
|
|
66
|
-
- 仕様ファイル不存在: 警告を出力し、利用可能情報でレビュー続行
|
|
67
|
-
|
|
68
|
-
### Step 3: サブエージェント起動
|
|
69
|
-
|
|
70
|
-
cross-repo-reviewerサブエージェントを使用して、以下のプロジェクトをレビューしてください:
|
|
71
|
-
|
|
72
|
-
- PROJECT_NAME: $1
|
|
73
|
-
- REPOSITORIES:
|
|
74
|
-
- {repo1.name}: {repo1.localPath}
|
|
75
|
-
- {repo2.name}: {repo2.localPath}
|
|
76
|
-
- ...
|
|
77
|
-
- REVIEW_FOCUS: {指定されたfocus}
|
|
78
|
-
|
|
79
|
-
品質ゲート判定結果をレポートしてください。
|
|
80
|
-
|
|
81
|
-
### Step 4: レビューレポート出力
|
|
82
|
-
|
|
83
|
-
出力先: `docs/michi/$1/reviews/cross-repo-review-{timestamp}.md`
|
|
84
|
-
|
|
85
|
-
レポート形式:
|
|
86
|
-
|
|
87
|
-
```markdown
|
|
88
|
-
## Multi-Repo Cross-Repository Review Report
|
|
89
|
-
|
|
90
|
-
**プロジェクト**: $1
|
|
91
|
-
**レビュー日時**: {timestamp}
|
|
92
|
-
**対象リポジトリ**: {count}件
|
|
93
|
-
**レビュー観点**: {focus}
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
### サマリー
|
|
98
|
-
|
|
99
|
-
| カテゴリ | ステータス | 問題件数 |
|
|
100
|
-
|---------|----------|---------|
|
|
101
|
-
| API契約整合性 | ✅/⚠️/❌ | N件 |
|
|
102
|
-
| データモデル整合性 | ✅/⚠️/❌ | N件 |
|
|
103
|
-
| イベントスキーマ整合性 | ✅/⚠️/❌ | N件 |
|
|
104
|
-
| 依存関係整合性 | ✅/⚠️/❌ | N件 |
|
|
105
|
-
| テスト仕様整合性 | ✅/⚠️/❌ | N件 |
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
### 検出された問題
|
|
110
|
-
|
|
111
|
-
#### 🔴 BLOCK (修正必須)
|
|
112
|
-
|
|
113
|
-
(cross-repo-reviewerが検出した重大な不整合)
|
|
114
|
-
|
|
115
|
-
#### 🟡 WARN (修正推奨)
|
|
116
|
-
|
|
117
|
-
(cross-repo-reviewerが検出した軽微な不整合)
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
### 品質ゲート判定
|
|
122
|
-
|
|
123
|
-
**判定**: ❌ 不合格 / ⚠️ 条件付き合格 / ✅ 合格
|
|
124
|
-
|
|
125
|
-
**理由**: {判定理由}
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
### 次のアクション
|
|
130
|
-
|
|
131
|
-
1. BLOCK問題の修正
|
|
132
|
-
2. `/michi-multi-repo:spec-review $1` を再実行
|
|
133
|
-
3. 合格後、各リポジトリで実装を開始
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
### Step 5: 判定結果の表示
|
|
137
|
-
|
|
138
|
-
**合格時(✅ PASS)**:
|
|
139
|
-
```markdown
|
|
140
|
-
🎉 品質ゲート合格
|
|
141
|
-
|
|
142
|
-
全リポジトリの仕様が整合性基準を満たしています。
|
|
143
|
-
|
|
144
|
-
### 次のステップ
|
|
145
|
-
|
|
146
|
-
1. 各リポジトリでタスク生成:
|
|
147
|
-
各リポジトリで `/michi:spec-tasks {feature}` を実行
|
|
148
|
-
|
|
149
|
-
2. 全リポジトリで実装を開始:
|
|
150
|
-
`/michi-multi-repo:impl-all $1`
|
|
151
|
-
|
|
152
|
-
3. CI/CD設定:
|
|
153
|
-
`michi multi-repo:ci-status $1` でCI結果を監視
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
**条件付き合格時(⚠️ WARN)**:
|
|
157
|
-
```markdown
|
|
158
|
-
⚠️ 品質ゲート条件付き合格
|
|
159
|
-
|
|
160
|
-
WARN問題が検出されましたが、修正は任意です。
|
|
161
|
-
|
|
162
|
-
### 検出された問題
|
|
163
|
-
- {WARN問題のリスト}
|
|
164
|
-
|
|
165
|
-
### 次のステップ(選択可能)
|
|
166
|
-
|
|
167
|
-
A) WARN問題を修正してから実装開始(推奨)
|
|
168
|
-
- 各リポジトリのdesign.mdを修正
|
|
169
|
-
- `/michi-multi-repo:spec-review $1` を再実行
|
|
170
|
-
|
|
171
|
-
B) そのまま実装開始
|
|
172
|
-
- `/michi-multi-repo:impl-all $1`
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
**不合格時(❌ BLOCK)**:
|
|
176
|
-
```markdown
|
|
177
|
-
❌ 品質ゲート不合格
|
|
178
|
-
|
|
179
|
-
BLOCK問題が検出されました。修正が必須です。
|
|
180
|
-
|
|
181
|
-
### BLOCK問題
|
|
182
|
-
- {BLOCK問題のリスト}
|
|
183
|
-
|
|
184
|
-
### 対処方法
|
|
185
|
-
|
|
186
|
-
1. 該当リポジトリのdesign.mdを修正
|
|
187
|
-
2. `/michi-multi-repo:spec-review $1` を再実行
|
|
188
|
-
3. 合格後に実装を開始
|
|
189
|
-
|
|
190
|
-
**注意**: BLOCK問題を未解決のまま実装を開始すると、サービス間通信が失敗する可能性があります。
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
## Important Constraints
|
|
194
|
-
- 読み取り操作のみ(各リポジトリへの書き込みは行わない)
|
|
195
|
-
- localPath未設定のリポジトリはスキップ(警告を出力)
|
|
196
|
-
- 大規模リポジトリの場合は主要ファイルのみ分析
|
|
197
|
-
|
|
198
|
-
</instructions>
|
|
199
|
-
|
|
200
|
-
## Tool Guidance
|
|
201
|
-
- **Task**: cross-repo-reviewerサブエージェント起動に使用
|
|
202
|
-
- **Read**: プロジェクト仕様、各リポジトリ仕様の読み込み
|
|
203
|
-
- **Write**: レビューレポートの出力
|
|
204
|
-
- **Glob/Grep**: 仕様ファイルの検索
|
|
205
|
-
|
|
206
|
-
## Output Description
|
|
207
|
-
|
|
208
|
-
日本語で以下の情報を出力してください:
|
|
209
|
-
|
|
210
|
-
1. **レビュー対象リポジトリ一覧**: 各リポジトリのlocalPathと仕様状態
|
|
211
|
-
2. **検出された問題**: BLOCK/WARN分類と詳細
|
|
212
|
-
3. **品質ゲート判定結果**: 合格/不合格と理由
|
|
213
|
-
4. **次のアクション**: 修正が必要な場合の具体的な手順
|
|
214
|
-
|
|
215
|
-
## Safety & Fallback
|
|
216
|
-
|
|
217
|
-
### Error Scenarios
|
|
218
|
-
|
|
219
|
-
- **プロジェクト未登録**:
|
|
220
|
-
```
|
|
221
|
-
エラー: プロジェクト '$1' が見つかりません。
|
|
222
|
-
```
|
|
223
|
-
|
|
224
|
-
- **親プロジェクト仕様未作成**:
|
|
225
|
-
```
|
|
226
|
-
エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md
|
|
227
|
-
|
|
228
|
-
先に親プロジェクトの設計を作成してください:
|
|
229
|
-
/michi-multi-repo:spec-design $1
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
- **localPath未設定**:
|
|
233
|
-
```
|
|
234
|
-
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
|
|
235
|
-
```
|
|
236
|
-
|
|
237
|
-
- **Michi未セットアップ**:
|
|
238
|
-
```
|
|
239
|
-
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
|
|
240
|
-
|
|
241
|
-
セットアップコマンド:
|
|
242
|
-
cd {localPath} && npx @sk8metal/michi-cli@latest init
|
|
243
|
-
|
|
244
|
-
セットアップ完了後、このコマンドを再実行してください。
|
|
245
|
-
```
|
|
246
|
-
|
|
247
|
-
- **仕様ファイル不存在**:
|
|
248
|
-
```
|
|
249
|
-
警告: リポジトリ '{name}' に仕様ファイルがありません。
|
|
250
|
-
|
|
251
|
-
仕様を展開してください:
|
|
252
|
-
/michi-multi-repo:propagate-specs $1
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
### Fallback Strategy
|
|
256
|
-
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
|
|
257
|
-
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
|
|
258
|
-
- 仕様ファイル不存在: 警告を出力し、利用可能な情報でレビュー
|
|
259
|
-
- 通信エラー: リトライ後、該当リポジトリをスキップ
|
|
260
|
-
|
|
261
|
-
think hard
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Atlassian Integration
|
|
3
|
-
description: Integration rules for Confluence and JIRA via MCP
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Atlassian Integration
|
|
7
|
-
|
|
8
|
-
## Development Guidelines
|
|
9
|
-
{{DEV_GUIDELINES}}
|
|
10
|
-
|
|
11
|
-
## Language
|
|
12
|
-
All generated documents should be in: **{{LANG_CODE}}**
|
|
13
|
-
|
|
14
|
-
## MCP Integration
|
|
15
|
-
|
|
16
|
-
### Confluence Sync
|
|
17
|
-
- Sync specifications from {{KIRO_DIR}}/specs/ to Confluence
|
|
18
|
-
- Use MCP server for Confluence operations
|
|
19
|
-
- Project labels: Check {{KIRO_DIR}}/project.json
|
|
20
|
-
|
|
21
|
-
### JIRA Sync
|
|
22
|
-
- Create Epic and Stories from {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/tasks.md
|
|
23
|
-
- Use JIRA project key: {{PROJECT_ID}}
|
|
24
|
-
- Link Confluence pages automatically
|
|
25
|
-
|
|
26
|
-
## Project Metadata
|
|
27
|
-
- Project ID: {{PROJECT_ID}}
|
|
28
|
-
- Kiro directory: {{KIRO_DIR}}
|
|
29
|
-
- Agent directory: {{AGENT_DIR}}
|
|
30
|
-
|
|
31
|
-
## Workflow
|
|
32
|
-
1. Create spec in {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/
|
|
33
|
-
2. Sync to Confluence via MCP
|
|
34
|
-
3. Create JIRA Epic/Stories
|
|
35
|
-
4. Link Confluence pages to JIRA
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Michi Core Principles
|
|
3
|
-
description: Core principles for GitHub SSoT and multi-project management
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Michi Core Principles
|
|
7
|
-
|
|
8
|
-
## Development Guidelines
|
|
9
|
-
{{DEV_GUIDELINES}}
|
|
10
|
-
|
|
11
|
-
## Language
|
|
12
|
-
All generated documents should be in: **{{LANG_CODE}}**
|
|
13
|
-
|
|
14
|
-
Reference the language field in {{KIRO_DIR}}/project.json.
|
|
15
|
-
|
|
16
|
-
## Single Source of Truth (SSoT)
|
|
17
|
-
|
|
18
|
-
### GitHub as SSoT
|
|
19
|
-
- **All specifications are managed in GitHub** ({{KIRO_DIR}}/specs/)
|
|
20
|
-
- Confluence is **reference and approval only** (editing is GitHub only)
|
|
21
|
-
- Avoid duplicate management
|
|
22
|
-
|
|
23
|
-
### Data Flow
|
|
24
|
-
```
|
|
25
|
-
GitHub ({{KIRO_DIR}}/specs/) ← Source of truth (editable)
|
|
26
|
-
↓ sync
|
|
27
|
-
Confluence ← Display and approval (read-only)
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## Multi-Project Management
|
|
31
|
-
|
|
32
|
-
### Project Identification
|
|
33
|
-
- All operations reference {{KIRO_DIR}}/project.json
|
|
34
|
-
- Dynamically use project ID, JIRA key, Confluence labels
|
|
35
|
-
- Project ID: {{PROJECT_ID}}
|
|
36
|
-
|
|
37
|
-
### Naming Conventions
|
|
38
|
-
|
|
39
|
-
#### Confluence Pages
|
|
40
|
-
- Format: `[{projectName}] {document_type}`
|
|
41
|
-
- Example: `[{{PROJECT_ID}}] Requirements`
|
|
42
|
-
|
|
43
|
-
#### JIRA Epic/Story
|
|
44
|
-
- Format: `[{JIRA_KEY}] {title}`
|
|
45
|
-
- Use project metadata from {{KIRO_DIR}}/project.json
|
|
46
|
-
|
|
47
|
-
## Agent Directory
|
|
48
|
-
- Agent configuration: {{AGENT_DIR}}
|
|
49
|
-
- Rules location: {{AGENT_DIR}}/rules/
|
|
50
|
-
- Commands location: {{AGENT_DIR}}/commands/
|
|
51
|
-
|
|
52
|
-
## Feature Development
|
|
53
|
-
- Feature name: {{FEATURE_NAME}}
|
|
54
|
-
- Spec location: {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/
|