@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,293 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
|
|
3
|
-
allowed-tools: Task, Bash, Read, Write, Glob, Grep
|
|
4
|
-
argument-hint: <project-name> [--tasks <task-numbers>]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Multi-Repo Implementation (All Repositories)
|
|
8
|
-
|
|
9
|
-
<background_information>
|
|
10
|
-
- **Mission**: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
|
|
11
|
-
- **Success Criteria**:
|
|
12
|
-
- 全リポジトリでTDD実装サイクルが完了
|
|
13
|
-
- テストカバレッジ95%以上
|
|
14
|
-
- 品質自動化(Lint/Type-check)パス
|
|
15
|
-
- PR作成可能な状態
|
|
16
|
-
</background_information>
|
|
17
|
-
|
|
18
|
-
<instructions>
|
|
19
|
-
## Core Task
|
|
20
|
-
Multi-Repoプロジェクト **$1** の全リポジトリで `/michi:spec-impl` を並行実行します。
|
|
21
|
-
|
|
22
|
-
## 引数解析
|
|
23
|
-
|
|
24
|
-
引数の形式:
|
|
25
|
-
```
|
|
26
|
-
/michi-multi-repo:impl-all <project-name> [--tasks <task-numbers>]
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
パラメータ:
|
|
30
|
-
- **$1**: プロジェクト名(必須)
|
|
31
|
-
- **--tasks**: 実行するタスク番号(オプション)
|
|
32
|
-
- 例: `--tasks 1,2,3` → タスク1-3のみ実行
|
|
33
|
-
- 省略時: 全タスクを実行
|
|
34
|
-
|
|
35
|
-
## Execution Steps
|
|
36
|
-
|
|
37
|
-
### Step 1: 前提条件確認
|
|
38
|
-
|
|
39
|
-
1. `docs/michi/$1/reviews/` に最新のレビューレポートが存在するか確認
|
|
40
|
-
|
|
41
|
-
2. 最新レビューの品質ゲート判定を確認
|
|
42
|
-
```bash
|
|
43
|
-
grep "品質ゲート判定" docs/michi/$1/reviews/cross-repo-review-*.md | tail -1
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
3. **判定が「不合格」の場合**:
|
|
47
|
-
```
|
|
48
|
-
❌ エラー: 品質ゲート不合格
|
|
49
|
-
|
|
50
|
-
BLOCK問題が未解決です。実装を開始できません。
|
|
51
|
-
|
|
52
|
-
次のアクション:
|
|
53
|
-
1. BLOCK問題を修正
|
|
54
|
-
2. `/michi-multi-repo:spec-review $1` を再実行
|
|
55
|
-
3. 合格後に再度このコマンドを実行
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
4. **判定が「条件付き合格」の場合**:
|
|
59
|
-
```
|
|
60
|
-
⚠️ 警告: 品質ゲート条件付き合格
|
|
61
|
-
|
|
62
|
-
WARN問題が検出されています。このまま実装を開始しますか? (y/n)
|
|
63
|
-
|
|
64
|
-
推奨: WARN問題を修正してから実装開始
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### Step 2: コンテキスト読み込み
|
|
68
|
-
|
|
69
|
-
1. `.michi/config.json` からプロジェクト情報取得
|
|
70
|
-
|
|
71
|
-
2. 登録リポジトリの一覧を取得
|
|
72
|
-
|
|
73
|
-
3. 各リポジトリの `localPath` を取得
|
|
74
|
-
|
|
75
|
-
4. 各リポジトリのタスクファイル確認
|
|
76
|
-
- `{localPath}/.kiro/specs/{feature}/tasks.md`
|
|
77
|
-
|
|
78
|
-
### Step 2.5: localPath 検証
|
|
79
|
-
|
|
80
|
-
各リポジトリについて以下を確認:
|
|
81
|
-
|
|
82
|
-
- ✅ localPathが設定されているか
|
|
83
|
-
- ✅ ディレクトリが存在するか
|
|
84
|
-
- ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
|
|
85
|
-
- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
|
|
86
|
-
- ⚠️ 設定されたブランチと現在のブランチが一致するか
|
|
87
|
-
- ⚠️ 未コミット変更がないか
|
|
88
|
-
|
|
89
|
-
**検証失敗時の対応**:
|
|
90
|
-
- localPath未設定: 警告を出力し、該当リポジトリをスキップ
|
|
91
|
-
- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
|
|
92
|
-
- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
|
|
93
|
-
- ブランチ不一致: 警告を出力(続行可能)
|
|
94
|
-
- 未コミット変更: 警告を出力(続行可能)
|
|
95
|
-
|
|
96
|
-
### Step 3: チェックポイント確認
|
|
97
|
-
|
|
98
|
-
`docs/michi/$1/.checkpoint-impl.json` の存在を確認
|
|
99
|
-
|
|
100
|
-
存在する場合:
|
|
101
|
-
```
|
|
102
|
-
⚠️ チェックポイントファイルが見つかりました
|
|
103
|
-
|
|
104
|
-
前回の実装が中断された可能性があります。
|
|
105
|
-
|
|
106
|
-
次のアクション:
|
|
107
|
-
A) チェックポイントから再開(未完了リポジトリのみ処理)
|
|
108
|
-
B) 最初から実行(チェックポイント削除)
|
|
109
|
-
C) キャンセル
|
|
110
|
-
|
|
111
|
-
選択 (A/B/C): _
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### Step 4: サブエージェント並行起動
|
|
115
|
-
|
|
116
|
-
**並行実行数**: 最大3並列
|
|
117
|
-
|
|
118
|
-
repo-spec-executorサブエージェントを使用して、以下のリポジトリで実装を並行実行してください:
|
|
119
|
-
|
|
120
|
-
**Repository 1**: {repo1.name}
|
|
121
|
-
- LOCAL_PATH: {repo1.localPath}
|
|
122
|
-
- PARENT_PROJECT: $1
|
|
123
|
-
- FEATURE_NAME: {feature}
|
|
124
|
-
- OPERATION: impl
|
|
125
|
-
- TASKS: {指定されたtask-numbers または "all"}
|
|
126
|
-
|
|
127
|
-
**Repository 2**: {repo2.name}
|
|
128
|
-
- LOCAL_PATH: {repo2.localPath}
|
|
129
|
-
- PARENT_PROJECT: $1
|
|
130
|
-
- FEATURE_NAME: {feature}
|
|
131
|
-
- OPERATION: impl
|
|
132
|
-
- TASKS: {指定されたtask-numbers または "all"}
|
|
133
|
-
|
|
134
|
-
(以下、登録されている全リポジトリ)
|
|
135
|
-
|
|
136
|
-
**重要**: 各サブエージェントの完了を待ち、結果を集約してください。
|
|
137
|
-
|
|
138
|
-
### Step 5: 結果集約とレポート
|
|
139
|
-
|
|
140
|
-
各リポジトリの実行結果を集約:
|
|
141
|
-
|
|
142
|
-
| リポジトリ | タスク進捗 | カバレッジ | Lint | Build | ステータス |
|
|
143
|
-
|-----------|----------|-----------|------|-------|----------|
|
|
144
|
-
| frontend | 5/5 | 96% | ✅ | ✅ | ✅ 完了 |
|
|
145
|
-
| backend | 8/8 | 98% | ✅ | ✅ | ✅ 完了 |
|
|
146
|
-
| shared | 3/3 | 95% | ✅ | ✅ | ✅ 完了 |
|
|
147
|
-
|
|
148
|
-
**成功件数**: 3/3
|
|
149
|
-
**全体カバレッジ**: 96.3%
|
|
150
|
-
|
|
151
|
-
### Step 6: チェックポイント保存(失敗時)
|
|
152
|
-
|
|
153
|
-
失敗したリポジトリがある場合、チェックポイントを保存:
|
|
154
|
-
|
|
155
|
-
```json
|
|
156
|
-
{
|
|
157
|
-
"projectName": "$1",
|
|
158
|
-
"operation": "impl",
|
|
159
|
-
"repositories": {
|
|
160
|
-
"frontend": {
|
|
161
|
-
"status": "completed",
|
|
162
|
-
"tasksCompleted": 5,
|
|
163
|
-
"tasksTotal": 5,
|
|
164
|
-
"coverage": 96,
|
|
165
|
-
"completedAt": "2025-12-23T11:00:00Z"
|
|
166
|
-
},
|
|
167
|
-
"backend": {
|
|
168
|
-
"status": "failed",
|
|
169
|
-
"tasksCompleted": 3,
|
|
170
|
-
"tasksTotal": 8,
|
|
171
|
-
"error": "Test failed: auth.test.ts",
|
|
172
|
-
"failedAt": "2025-12-23T11:10:00Z"
|
|
173
|
-
}
|
|
174
|
-
},
|
|
175
|
-
"savedAt": "2025-12-23T11:11:00Z"
|
|
176
|
-
}
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
保存先: `docs/michi/$1/.checkpoint-impl.json`
|
|
180
|
-
|
|
181
|
-
### Step 7: 次のアクション案内
|
|
182
|
-
|
|
183
|
-
**全成功時**:
|
|
184
|
-
```markdown
|
|
185
|
-
🎉 全リポジトリで実装が完了しました
|
|
186
|
-
|
|
187
|
-
### 実装サマリー
|
|
188
|
-
|
|
189
|
-
| 指標 | 結果 |
|
|
190
|
-
|------|------|
|
|
191
|
-
| 完了リポジトリ | 3/3 |
|
|
192
|
-
| 全体カバレッジ | 96.3% |
|
|
193
|
-
| Lint/Build | ✅ All Pass |
|
|
194
|
-
|
|
195
|
-
### 次のステップ
|
|
196
|
-
|
|
197
|
-
1. 各リポジトリでPR作成:
|
|
198
|
-
各リポジトリで `/pr` コマンドを実行
|
|
199
|
-
|
|
200
|
-
2. CI結果を監視:
|
|
201
|
-
`michi multi-repo:ci-status $1`
|
|
202
|
-
|
|
203
|
-
3. PRマージ後、リリース準備:
|
|
204
|
-
- Confluenceリリース手順書作成
|
|
205
|
-
- JIRAリリースチケット起票
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
**一部失敗時**:
|
|
209
|
-
```markdown
|
|
210
|
-
⚠️ 一部のリポジトリで失敗しました
|
|
211
|
-
|
|
212
|
-
### 失敗したリポジトリ
|
|
213
|
-
- backend: Test failed: auth.test.ts (タスク3/8完了)
|
|
214
|
-
|
|
215
|
-
### 対処方法
|
|
216
|
-
|
|
217
|
-
1. 失敗箇所を確認:
|
|
218
|
-
```bash
|
|
219
|
-
cd {backend.localPath}
|
|
220
|
-
npm test auth.test.ts
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
2. 修正後、チェックポイントから再開:
|
|
224
|
-
`/michi-multi-repo:impl-all $1`
|
|
225
|
-
(失敗したリポジトリのみ処理されます)
|
|
226
|
-
```
|
|
227
|
-
|
|
228
|
-
## Important Constraints
|
|
229
|
-
- spec-review合格が前提(BLOCK問題がないこと)
|
|
230
|
-
- 並行実行は最大3リポジトリ
|
|
231
|
-
- TDDサイクル(RED-GREEN-REFACTOR)を遵守
|
|
232
|
-
- テストカバレッジ95%以上を維持
|
|
233
|
-
- 各リポジトリは独立して処理(依存関係なし)
|
|
234
|
-
|
|
235
|
-
</instructions>
|
|
236
|
-
|
|
237
|
-
## Tool Guidance
|
|
238
|
-
- **Task**: repo-spec-executorサブエージェント起動に使用
|
|
239
|
-
- **Read**: config.json、レビューレポート、タスクファイル読み込み
|
|
240
|
-
- **Write**: チェックポイント保存
|
|
241
|
-
- **Bash**: Git操作、カバレッジ確認
|
|
242
|
-
|
|
243
|
-
## Output Description
|
|
244
|
-
|
|
245
|
-
日本語で以下の情報を出力してください:
|
|
246
|
-
|
|
247
|
-
1. **処理対象リポジトリ一覧**: 各リポジトリのタスク進捗
|
|
248
|
-
2. **実行結果サマリー**: 成功/失敗件数、全体カバレッジ
|
|
249
|
-
3. **各リポジトリの詳細結果**: カバレッジ、Lint/Build結果、エラー内容
|
|
250
|
-
4. **次のアクション**: 成功時/失敗時の推奨ステップ
|
|
251
|
-
|
|
252
|
-
## Safety & Fallback
|
|
253
|
-
|
|
254
|
-
### Error Scenarios
|
|
255
|
-
|
|
256
|
-
- **品質ゲート不合格**:
|
|
257
|
-
```
|
|
258
|
-
エラー: 品質ゲート不合格のため、実装を開始できません。
|
|
259
|
-
|
|
260
|
-
`/michi-multi-repo:spec-review $1` を実行し、BLOCK問題を解決してください。
|
|
261
|
-
```
|
|
262
|
-
|
|
263
|
-
- **タスクファイル不存在**:
|
|
264
|
-
```
|
|
265
|
-
エラー: リポジトリ '{name}' にタスクファイルがありません: .kiro/specs/{feature}/tasks.md
|
|
266
|
-
|
|
267
|
-
タスクを生成してください:
|
|
268
|
-
cd {localPath}
|
|
269
|
-
/michi:spec-tasks {feature}
|
|
270
|
-
```
|
|
271
|
-
|
|
272
|
-
- **localPath未設定**:
|
|
273
|
-
```
|
|
274
|
-
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
|
|
275
|
-
```
|
|
276
|
-
|
|
277
|
-
- **Michi未セットアップ**:
|
|
278
|
-
```
|
|
279
|
-
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
|
|
280
|
-
|
|
281
|
-
セットアップコマンド:
|
|
282
|
-
cd {localPath} && npx @sk8metal/michi-cli@latest init
|
|
283
|
-
|
|
284
|
-
セットアップ完了後、このコマンドを再実行してください。
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
### Fallback Strategy
|
|
288
|
-
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
|
|
289
|
-
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
|
|
290
|
-
- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
|
|
291
|
-
- テスト失敗: 自動修正を試行(最大3回)、失敗時はチェックポイント保存
|
|
292
|
-
|
|
293
|
-
think hard
|
|
@@ -1,284 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Multi-Repoプロジェクトから各リポジトリへ仕様を展開(並行実行)
|
|
3
|
-
allowed-tools: Task, Bash, Read, Write, Glob, Grep, AskUserQuestion
|
|
4
|
-
argument-hint: <project-name> [--operation init|requirements|design|all]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Multi-Repo Spec Propagation
|
|
8
|
-
|
|
9
|
-
<background_information>
|
|
10
|
-
- **Mission**: Multi-Repoプロジェクトの仕様を各リポジトリに展開
|
|
11
|
-
- **Success Criteria**:
|
|
12
|
-
- 全リポジトリで指定されたOPERATIONが完了
|
|
13
|
-
- 各リポジトリの仕様が親プロジェクトと整合性を保つ
|
|
14
|
-
- エラーハンドリングとチェックポイント保存
|
|
15
|
-
</background_information>
|
|
16
|
-
|
|
17
|
-
<instructions>
|
|
18
|
-
## Core Task
|
|
19
|
-
Multi-Repoプロジェクト **$1** の全リポジトリに対して、仕様コマンドを並行実行します。
|
|
20
|
-
|
|
21
|
-
## 引数解析
|
|
22
|
-
|
|
23
|
-
引数の形式:
|
|
24
|
-
```
|
|
25
|
-
/michi-multi-repo:propagate-specs <project-name> [--operation <operation>]
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
パラメータ:
|
|
29
|
-
- **$1**: プロジェクト名(必須)
|
|
30
|
-
- **--operation**: 実行する操作(オプション、デフォルト: all)
|
|
31
|
-
- `init`: /michi:spec-init
|
|
32
|
-
- `requirements`: /kiro:spec-requirements
|
|
33
|
-
- `design`: /michi:spec-design
|
|
34
|
-
- `all`: /michi:spec-init → /kiro:spec-requirements → /michi:spec-design を順次実行
|
|
35
|
-
|
|
36
|
-
## Execution Steps
|
|
37
|
-
|
|
38
|
-
### Step 1: コンテキスト読み込み
|
|
39
|
-
|
|
40
|
-
1. `.michi/config.json` からプロジェクト情報取得
|
|
41
|
-
```bash
|
|
42
|
-
cat .michi/config.json | grep -A 20 '"name": "$1"'
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
2. 登録リポジトリの一覧を取得
|
|
46
|
-
|
|
47
|
-
3. 各リポジトリの `localPath` を取得
|
|
48
|
-
|
|
49
|
-
4. 親プロジェクトの仕様ファイルを確認
|
|
50
|
-
- `docs/michi/$1/overview/requirements.md` (OPERATION=design以降で必要)
|
|
51
|
-
- `docs/michi/$1/overview/architecture.md` (OPERATION=design以降で必要)
|
|
52
|
-
|
|
53
|
-
### Step 2: localPath 検証
|
|
54
|
-
|
|
55
|
-
各リポジトリについて以下を確認:
|
|
56
|
-
|
|
57
|
-
- ✅ localPathが設定されているか
|
|
58
|
-
- ✅ ディレクトリが存在するか
|
|
59
|
-
- ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
|
|
60
|
-
- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
|
|
61
|
-
- ⚠️ 設定されたブランチと現在のブランチが一致するか
|
|
62
|
-
- ⚠️ 未コミット変更がないか
|
|
63
|
-
|
|
64
|
-
**検証失敗時の対応**:
|
|
65
|
-
- localPath未設定: 警告を出力し、該当リポジトリをスキップ
|
|
66
|
-
- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
|
|
67
|
-
- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
|
|
68
|
-
- ブランチ不一致: 警告を出力(続行可能)
|
|
69
|
-
- 未コミット変更: 警告を出力(続行可能)
|
|
70
|
-
|
|
71
|
-
### Step 3: チェックポイント確認
|
|
72
|
-
|
|
73
|
-
`docs/michi/$1/.checkpoint.json` の存在を確認
|
|
74
|
-
|
|
75
|
-
存在する場合:
|
|
76
|
-
```text
|
|
77
|
-
⚠️ チェックポイントファイルが見つかりました: docs/michi/$1/.checkpoint.json
|
|
78
|
-
|
|
79
|
-
前回の実行が中断された可能性があります。
|
|
80
|
-
|
|
81
|
-
次のアクション:
|
|
82
|
-
A) チェックポイントから再開(未完了リポジトリのみ処理)
|
|
83
|
-
B) 最初から実行(チェックポイント削除)
|
|
84
|
-
C) キャンセル
|
|
85
|
-
|
|
86
|
-
選択 (A/B/C): _
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
### Step 3.5: 実行確認
|
|
90
|
-
|
|
91
|
-
以下のリポジトリで仕様生成を自動実行します:
|
|
92
|
-
|
|
93
|
-
| リポジトリ | localPath | 実行コマンド |
|
|
94
|
-
|-----------|----------|-------------|
|
|
95
|
-
{各リポジトリの情報を表示}
|
|
96
|
-
|
|
97
|
-
**AskUserQuestionツールで確認:**
|
|
98
|
-
```
|
|
99
|
-
この内容で仕様生成を自動実行しますか?
|
|
100
|
-
|
|
101
|
-
実行されるコマンド:
|
|
102
|
-
- /michi:spec-init "{project description}"
|
|
103
|
-
- /kiro:spec-requirements {feature}
|
|
104
|
-
- /michi:spec-design {feature}
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
選択肢:
|
|
108
|
-
- はい、実行する(推奨)
|
|
109
|
-
- いいえ、キャンセル
|
|
110
|
-
|
|
111
|
-
### Step 4: 並行実行
|
|
112
|
-
|
|
113
|
-
**並行実行数**: 最大3並列
|
|
114
|
-
|
|
115
|
-
**重要**: general-purposeエージェントを使用して、以下のリポジトリで仕様コマンドを並行実行してください:
|
|
116
|
-
|
|
117
|
-
各リポジトリに対してTaskツール(subagent_type: general-purpose)を起動:
|
|
118
|
-
|
|
119
|
-
**Repository**: {repo.name}
|
|
120
|
-
- 作業ディレクトリ: {repo.localPath}
|
|
121
|
-
- 親プロジェクト参照:
|
|
122
|
-
- requirements.md: {親プロジェクトパス}/docs/michi/$1/overview/requirements.md
|
|
123
|
-
- architecture.md: {親プロジェクトパス}/docs/michi/$1/overview/architecture.md
|
|
124
|
-
|
|
125
|
-
実行コマンド(順次):
|
|
126
|
-
1. `/michi:spec-init "{project description}"`
|
|
127
|
-
2. `/kiro:spec-requirements {feature}`
|
|
128
|
-
3. `/michi:spec-design {feature}`
|
|
129
|
-
|
|
130
|
-
親プロジェクトの設計との整合性を維持し、このリポジトリの責務範囲のみを設計してください。
|
|
131
|
-
|
|
132
|
-
**重要**: 全リポジトリのエージェント完了を待ち、結果を集約してください。
|
|
133
|
-
|
|
134
|
-
### Step 5: 結果集約とレポート
|
|
135
|
-
|
|
136
|
-
各リポジトリの実行結果を集約:
|
|
137
|
-
|
|
138
|
-
| リポジトリ | OPERATION | ステータス | 詳細 |
|
|
139
|
-
|-----------|----------|----------|------|
|
|
140
|
-
| frontend | design | ✅ 成功 | design.md生成完了 |
|
|
141
|
-
| backend | design | ✅ 成功 | design.md生成完了 |
|
|
142
|
-
| shared | design | ❌ 失敗 | localPath未設定 |
|
|
143
|
-
|
|
144
|
-
**成功件数**: 2/3
|
|
145
|
-
**失敗件数**: 1/3
|
|
146
|
-
|
|
147
|
-
### Step 6: チェックポイント保存(失敗時)
|
|
148
|
-
|
|
149
|
-
失敗したリポジトリがある場合、チェックポイントを保存:
|
|
150
|
-
|
|
151
|
-
```json
|
|
152
|
-
{
|
|
153
|
-
"projectName": "$1",
|
|
154
|
-
"operation": "{operation}",
|
|
155
|
-
"repositories": {
|
|
156
|
-
"frontend": {
|
|
157
|
-
"status": "completed",
|
|
158
|
-
"completedAt": "2025-12-23T10:30:00Z"
|
|
159
|
-
},
|
|
160
|
-
"backend": {
|
|
161
|
-
"status": "completed",
|
|
162
|
-
"completedAt": "2025-12-23T10:31:00Z"
|
|
163
|
-
},
|
|
164
|
-
"shared": {
|
|
165
|
-
"status": "failed",
|
|
166
|
-
"error": "localPath未設定"
|
|
167
|
-
}
|
|
168
|
-
},
|
|
169
|
-
"savedAt": "2025-12-23T10:32:00Z"
|
|
170
|
-
}
|
|
171
|
-
```
|
|
172
|
-
|
|
173
|
-
保存先: `docs/michi/$1/.checkpoint.json`
|
|
174
|
-
|
|
175
|
-
### Step 7: 次のアクション案内
|
|
176
|
-
|
|
177
|
-
**全成功時**:
|
|
178
|
-
```markdown
|
|
179
|
-
🎉 全リポジトリで仕様展開が完了しました
|
|
180
|
-
|
|
181
|
-
### 次のステップ
|
|
182
|
-
|
|
183
|
-
1. クロスリポジトリレビューを実行:
|
|
184
|
-
`/michi-multi-repo:spec-review $1`
|
|
185
|
-
|
|
186
|
-
2. 合格後、各リポジトリでタスク生成:
|
|
187
|
-
各リポジトリで `/michi:spec-tasks {feature}` を実行
|
|
188
|
-
|
|
189
|
-
3. 実装を開始:
|
|
190
|
-
`/michi-multi-repo:impl-all $1`
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
**一部失敗時**:
|
|
194
|
-
```markdown
|
|
195
|
-
⚠️ 一部のリポジトリで失敗しました
|
|
196
|
-
|
|
197
|
-
### 失敗したリポジトリ
|
|
198
|
-
- shared: localPath未設定
|
|
199
|
-
|
|
200
|
-
### 対処方法
|
|
201
|
-
1. localPathを設定:
|
|
202
|
-
`michi multi-repo:add-repo $1 --name shared --localPath /path/to/repo`
|
|
203
|
-
|
|
204
|
-
2. チェックポイントから再開:
|
|
205
|
-
`/michi-multi-repo:propagate-specs $1 --operation {operation}`
|
|
206
|
-
(失敗したリポジトリのみ処理されます)
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
## Important Constraints
|
|
210
|
-
- 並行実行は最大3リポジトリ
|
|
211
|
-
- 各リポジトリは独立して処理(依存関係なし)
|
|
212
|
-
- localPath未設定のリポジトリはスキップ
|
|
213
|
-
- エラー発生時もチェックポイントを保存し、再開可能にする
|
|
214
|
-
|
|
215
|
-
</instructions>
|
|
216
|
-
|
|
217
|
-
## Tool Guidance
|
|
218
|
-
- **Task**: repo-spec-executorサブエージェント起動に使用
|
|
219
|
-
- **Read**: config.json、親プロジェクト仕様の読み込み
|
|
220
|
-
- **Write**: チェックポイント保存
|
|
221
|
-
- **Bash**: localPath検証、Git操作
|
|
222
|
-
|
|
223
|
-
## Output Description
|
|
224
|
-
|
|
225
|
-
日本語で以下の情報を出力してください:
|
|
226
|
-
|
|
227
|
-
1. **処理対象リポジトリ一覧**: 各リポジトリのlocalPathと検証結果
|
|
228
|
-
2. **実行結果サマリー**: 成功/失敗件数
|
|
229
|
-
3. **各リポジトリの詳細結果**: 生成されたファイル、エラー内容
|
|
230
|
-
4. **次のアクション**: 成功時/失敗時の推奨ステップ
|
|
231
|
-
|
|
232
|
-
## Safety & Fallback
|
|
233
|
-
|
|
234
|
-
### Error Scenarios
|
|
235
|
-
|
|
236
|
-
- **プロジェクト未登録**:
|
|
237
|
-
```
|
|
238
|
-
エラー: プロジェクト '$1' が見つかりません。
|
|
239
|
-
|
|
240
|
-
次のコマンドでプロジェクトを初期化してください:
|
|
241
|
-
michi multi-repo:init $1 --jira {JIRA_KEY} --confluence-space {SPACE}
|
|
242
|
-
```
|
|
243
|
-
|
|
244
|
-
- **リポジトリ未登録**:
|
|
245
|
-
```
|
|
246
|
-
警告: プロジェクト '$1' にリポジトリが登録されていません。
|
|
247
|
-
|
|
248
|
-
次のコマンドでリポジトリを登録してください:
|
|
249
|
-
michi multi-repo:add-repo $1 --name {name} --url {url} --localPath {path}
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
- **localPath未設定**:
|
|
253
|
-
```
|
|
254
|
-
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
|
|
255
|
-
|
|
256
|
-
localPathを設定するには:
|
|
257
|
-
michi multi-repo:add-repo $1 --name {name} --localPath /path/to/repo
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
- **Michi未セットアップ**:
|
|
261
|
-
```
|
|
262
|
-
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
|
|
263
|
-
|
|
264
|
-
セットアップコマンド:
|
|
265
|
-
cd {localPath} && npx @sk8metal/michi-cli@latest init
|
|
266
|
-
|
|
267
|
-
セットアップ完了後、このコマンドを再実行してください。
|
|
268
|
-
```
|
|
269
|
-
|
|
270
|
-
- **親プロジェクト仕様未作成(OPERATION=design以降)**:
|
|
271
|
-
```
|
|
272
|
-
エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md
|
|
273
|
-
|
|
274
|
-
先に親プロジェクトの設計を作成してください:
|
|
275
|
-
/michi-multi-repo:spec-design $1
|
|
276
|
-
```
|
|
277
|
-
|
|
278
|
-
### Fallback Strategy
|
|
279
|
-
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
|
|
280
|
-
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
|
|
281
|
-
- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
|
|
282
|
-
- 全リポジトリ失敗: エラーレポート出力し、ユーザーに対処方法を案内
|
|
283
|
-
|
|
284
|
-
think hard
|