@sk8metal/michi-cli 0.8.6 → 0.8.7
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 +25 -0
- package/README.md +3 -3
- package/dist/scripts/constants/environments.js +3 -3
- package/dist/scripts/constants/environments.js.map +1 -1
- package/docs/michi-development/testing/manual-verification-other-tools.md +10 -8
- package/docs/user-guide/getting-started/new-repository-setup.md +4 -3
- package/docs/user-guide/guides/migration-guide.md +138 -0
- package/docs/user-guide/guides/multi-repo-guide.md +130 -10
- package/package.json +1 -1
- package/scripts/constants/__tests__/environments.test.ts +3 -3
- package/scripts/constants/environments.ts +3 -3
- package/templates/claude/commands/{michi_multi_repo → michi-multi-repo}/spec-design.md +3 -3
- package/templates/claude/commands/{michi_multi_repo → michi-multi-repo}/spec-init.md +6 -6
- package/templates/claude/commands/{michi_multi_repo → michi-multi-repo}/spec-requirements.md +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- **Multi-Repo AIコマンド名変更**: `michi_multi_repo:*` → `michi-multi-repo:*`
|
|
13
|
+
- `/michi-multi-repo:spec-init`: プロジェクト初期化コマンド(旧: `/michi_multi_repo:spec-init`)
|
|
14
|
+
- `/michi-multi-repo:spec-requirements`: 要件定義書生成コマンド(旧: `/michi_multi_repo:spec-requirements`)
|
|
15
|
+
- `/michi-multi-repo:spec-design`: 設計書生成コマンド(旧: `/michi_multi_repo:spec-design`)
|
|
16
|
+
- **理由**: Claude Codeのスキル検出でアンダースコアが正しく処理されない問題に対応
|
|
17
|
+
- **`michi init` コマンドの配布先修正**
|
|
18
|
+
- `commandsDir` を `.claude/commands/kiro` から `.claude/commands` に変更
|
|
19
|
+
- これにより `kiro/`, `michi/`, `michi-multi-repo/` が正しい階層にコピーされるようになった
|
|
20
|
+
- **影響**: 既存の二重ネスト(`.claude/commands/kiro/kiro/`)問題を解決
|
|
21
|
+
|
|
22
|
+
### Fixed
|
|
23
|
+
|
|
24
|
+
- **Multi-Repo AIコマンドがユーザープロジェクトにコピーされない問題を修正**
|
|
25
|
+
- `environments.ts` の設定により、`templates/claude/commands/` が `/kiro` サブディレクトリにコピーされていた
|
|
26
|
+
- 修正により、各コマンドディレクトリ(`kiro/`, `michi/`, `michi-multi-repo/`)が `.claude/commands/` 直下に正しく配置されるようになった
|
|
27
|
+
- **存在しない `michi config:init` コマンドの参照を修正**
|
|
28
|
+
- spec-init.md のエラーメッセージで参照されていた `michi config:init` を `michi init` に修正
|
|
29
|
+
- **注意**: `michi config:init` コマンドは実装されておらず、正しくは `michi init` を使用
|
|
30
|
+
|
|
31
|
+
### Added
|
|
32
|
+
|
|
33
|
+
- **マイグレーションガイド**: v0.8.6 → v0.8.7 の移行手順を文書化(docs/user-guide/guides/migration-guide.md)
|
|
34
|
+
|
|
10
35
|
## [0.8.6] - 2025-12-22
|
|
11
36
|
|
|
12
37
|
### Fixed
|
package/README.md
CHANGED
|
@@ -467,17 +467,17 @@ APPROVAL_GATES_RELEASE=SM,部長
|
|
|
467
467
|
|
|
468
468
|
```bash
|
|
469
469
|
# 1. AIでプロジェクト初期化(プロジェクト説明から自動生成)
|
|
470
|
-
/
|
|
470
|
+
/michi-multi-repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
|
|
471
471
|
|
|
472
472
|
# 2. リポジトリ登録(CLIコマンド)
|
|
473
473
|
michi multi-repo:add-repo my-microservices --name frontend --url https://github.com/org/frontend --branch main
|
|
474
474
|
michi multi-repo:add-repo my-microservices --name backend --url https://github.com/org/backend --branch main
|
|
475
475
|
|
|
476
476
|
# 3. AIで要件定義書生成
|
|
477
|
-
/
|
|
477
|
+
/michi-multi-repo:spec-requirements my-microservices
|
|
478
478
|
|
|
479
479
|
# 4. AIで設計書生成(アーキテクチャ図含む)
|
|
480
|
-
/
|
|
480
|
+
/michi-multi-repo:spec-design my-microservices
|
|
481
481
|
|
|
482
482
|
# 5. Confluence同期
|
|
483
483
|
michi multi-repo:confluence-sync my-microservices
|
|
@@ -6,17 +6,17 @@
|
|
|
6
6
|
export const ENV_CONFIG = {
|
|
7
7
|
claude: {
|
|
8
8
|
rulesDir: '.claude/rules',
|
|
9
|
-
commandsDir: '.claude/commands
|
|
9
|
+
commandsDir: '.claude/commands',
|
|
10
10
|
templateSource: 'claude',
|
|
11
11
|
},
|
|
12
12
|
'claude-agent': {
|
|
13
13
|
rulesDir: '.claude/agents',
|
|
14
|
-
commandsDir: '.claude/commands
|
|
14
|
+
commandsDir: '.claude/commands',
|
|
15
15
|
templateSource: 'claude-agent',
|
|
16
16
|
},
|
|
17
17
|
cursor: {
|
|
18
18
|
rulesDir: '.cursor/rules',
|
|
19
|
-
commandsDir: '.cursor/commands
|
|
19
|
+
commandsDir: '.cursor/commands',
|
|
20
20
|
templateSource: 'cursor',
|
|
21
21
|
},
|
|
22
22
|
gemini: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"environments.js","sourceRoot":"","sources":["../../../scripts/constants/environments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,CAAC,MAAM,UAAU,GAA2C;IAChE,MAAM,EAAE;QACN,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,
|
|
1
|
+
{"version":3,"file":"environments.js","sourceRoot":"","sources":["../../../scripts/constants/environments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,CAAC,MAAM,UAAU,GAA2C;IAChE,MAAM,EAAE;QACN,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,kBAAkB;QAC/B,cAAc,EAAE,QAAQ;KACzB;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,kBAAkB;QAC/B,cAAc,EAAE,cAAc;KAC/B;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,kBAAkB;QAC/B,cAAc,EAAE,QAAQ;KACzB;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,oBAAoB;QACjC,cAAc,EAAE,QAAQ;KACzB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,OAAO;KACxB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,mBAAmB;QAC7B,WAAW,EAAE,sBAAsB;QACnC,cAAc,EAAE,OAAO;KACxB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAgB,EAAqB,EAAE;IAC1E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAsB,EAAE;IACxE,OAAO,GAAG,IAAI,UAAU,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAkB,EAAE;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAkB,CAAC;AAClD,CAAC,CAAC"}
|
|
@@ -83,7 +83,7 @@ npx tsx ~/Work/git/michi/src/cli.ts setup-existing --claude --lang ja
|
|
|
83
83
|
実行後、Michiのコマンドが追加されることを確認:
|
|
84
84
|
|
|
85
85
|
```bash
|
|
86
|
-
ls -la /tmp/michi-manual-test-claude-code/.claude/commands/
|
|
86
|
+
ls -la /tmp/michi-manual-test-claude-code/.claude/commands/michi
|
|
87
87
|
# Michiのコマンドが追加されている:
|
|
88
88
|
# michi-confluence-sync.md
|
|
89
89
|
# michi-project-switch.md
|
|
@@ -407,13 +407,15 @@ npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-b
|
|
|
407
407
|
├── .claude/
|
|
408
408
|
│ ├── CLAUDE.md
|
|
409
409
|
│ └── commands/
|
|
410
|
-
│ ├── kiro
|
|
411
|
-
│ ├── kiro-spec-
|
|
412
|
-
│ ├── kiro-spec-
|
|
413
|
-
│ ├── kiro-spec-
|
|
414
|
-
│ ├──
|
|
415
|
-
│
|
|
416
|
-
│ └── michi
|
|
410
|
+
│ ├── kiro/ (cc-sdd)
|
|
411
|
+
│ │ ├── kiro-spec-init.md
|
|
412
|
+
│ │ ├── kiro-spec-requirements.md
|
|
413
|
+
│ │ ├── kiro-spec-design.md
|
|
414
|
+
│ │ ├── kiro-spec-tasks.md
|
|
415
|
+
│ │ └── ... (cc-sdd提供の他のコマンド)
|
|
416
|
+
│ └── michi/ (Michi)
|
|
417
|
+
│ ├── michi-confluence-sync.md
|
|
418
|
+
│ └── michi-project-switch.md
|
|
417
419
|
└── .kiro/
|
|
418
420
|
└── specs/
|
|
419
421
|
└── java-calculator-webapp/
|
|
@@ -259,9 +259,10 @@ cp $MICHI_PATH/.cursor/rules/multi-project.mdc .cursor/rules/
|
|
|
259
259
|
cp $MICHI_PATH/.cursor/rules/github-ssot.mdc .cursor/rules/
|
|
260
260
|
cp $MICHI_PATH/.cursor/rules/atlassian-mcp.mdc .cursor/rules/
|
|
261
261
|
|
|
262
|
-
#
|
|
263
|
-
|
|
264
|
-
cp $MICHI_PATH/.cursor/commands/
|
|
262
|
+
# カスタムコマンドをコピー(v0.8.7以降の構造)
|
|
263
|
+
mkdir -p .cursor/commands/michi
|
|
264
|
+
cp $MICHI_PATH/.cursor/commands/michi/confluence-sync.md .cursor/commands/michi/
|
|
265
|
+
cp $MICHI_PATH/.cursor/commands/michi/project-switch.md .cursor/commands/michi/
|
|
265
266
|
|
|
266
267
|
# Steeringテンプレートをコピー
|
|
267
268
|
mkdir -p .kiro/steering
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
# Michi マイグレーションガイド
|
|
2
|
+
|
|
3
|
+
このドキュメントは、Michi の異なるバージョン間での移行手順を説明します。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## v0.8.6 → v0.8.7 (Unreleased)
|
|
8
|
+
|
|
9
|
+
### 重要な変更点
|
|
10
|
+
|
|
11
|
+
#### 1. Multi-Repo AIコマンド名の変更
|
|
12
|
+
|
|
13
|
+
**変更内容**:
|
|
14
|
+
- `/michi_multi_repo:*` → `/michi-multi-repo:*`
|
|
15
|
+
|
|
16
|
+
**影響を受けるコマンド**:
|
|
17
|
+
|
|
18
|
+
| 旧コマンド | 新コマンド |
|
|
19
|
+
|-----------|-----------|
|
|
20
|
+
| `/michi_multi_repo:spec-init` | `/michi-multi-repo:spec-init` |
|
|
21
|
+
| `/michi_multi_repo:spec-requirements` | `/michi-multi-repo:spec-requirements` |
|
|
22
|
+
| `/michi_multi_repo:spec-design` | `/michi-multi-repo:spec-design` |
|
|
23
|
+
|
|
24
|
+
**移行手順**:
|
|
25
|
+
1. スクリプトやドキュメントで `/michi_multi_repo:` を使用している箇所を `/michi-multi-repo:` に置換してください
|
|
26
|
+
2. 特に以下のファイルを確認:
|
|
27
|
+
- プロジェクトの README.md
|
|
28
|
+
- 開発ドキュメント
|
|
29
|
+
- 自動化スクリプト
|
|
30
|
+
|
|
31
|
+
#### 2. コマンド配布先の修正
|
|
32
|
+
|
|
33
|
+
**変更内容**:
|
|
34
|
+
- `michi init` コマンドが作成するディレクトリ構造が変更されました
|
|
35
|
+
|
|
36
|
+
**変更前**:
|
|
37
|
+
```
|
|
38
|
+
.claude/commands/kiro/
|
|
39
|
+
├── kiro/ # 二重ネスト(バグ)
|
|
40
|
+
├── michi/
|
|
41
|
+
└── michi_multi_repo/
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**変更後**:
|
|
45
|
+
```
|
|
46
|
+
.claude/commands/
|
|
47
|
+
├── kiro/ # 正しい階層
|
|
48
|
+
├── michi/
|
|
49
|
+
└── michi-multi-repo/
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
**移行手順**:
|
|
53
|
+
|
|
54
|
+
##### 既存プロジェクトの場合
|
|
55
|
+
|
|
56
|
+
1. **二重ネストディレクトリの削除**:
|
|
57
|
+
```bash
|
|
58
|
+
# プロジェクトルートで実行
|
|
59
|
+
rm -rf .claude/commands/kiro/kiro
|
|
60
|
+
rm -rf .claude/commands/kiro/michi
|
|
61
|
+
rm -rf .claude/commands/kiro/michi_multi_repo
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
2. **新しい構造でコマンドを再配置**:
|
|
65
|
+
```bash
|
|
66
|
+
# michi init を再実行(上書き確認なし)
|
|
67
|
+
michi init --claude
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
3. **確認**:
|
|
71
|
+
```bash
|
|
72
|
+
ls -la .claude/commands/
|
|
73
|
+
# 以下が表示されること:
|
|
74
|
+
# - kiro/
|
|
75
|
+
# - michi/
|
|
76
|
+
# - michi-multi-repo/
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
##### 新規プロジェクトの場合
|
|
80
|
+
|
|
81
|
+
v0.8.7 以降では、`michi init` を実行すると自動的に正しい構造が作成されます。
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
michi init --claude
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### その他の変更点
|
|
88
|
+
|
|
89
|
+
#### `michi config:init` コマンドの参照を修正
|
|
90
|
+
|
|
91
|
+
**問題**:
|
|
92
|
+
- spec-init.md のエラーメッセージで `michi config:init` コマンドが参照されていましたが、このコマンドは実装されていませんでした
|
|
93
|
+
|
|
94
|
+
**修正内容**:
|
|
95
|
+
- `michi config:init` → `michi init`
|
|
96
|
+
|
|
97
|
+
**影響**:
|
|
98
|
+
- エラーメッセージで正しいコマンドが案内されるようになりました
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## トラブルシューティング
|
|
103
|
+
|
|
104
|
+
### Q1: 既存の `.claude/commands/kiro/kiro/` が残っている
|
|
105
|
+
|
|
106
|
+
**回答**: 手動で削除してください:
|
|
107
|
+
```bash
|
|
108
|
+
rm -rf .claude/commands/kiro/kiro
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Q2: `/michi_multi_repo:*` コマンドが認識されなくなった
|
|
112
|
+
|
|
113
|
+
**回答**: v0.8.7 では `/michi-multi-repo:*` に変更されました。新しいコマンド名を使用してください。
|
|
114
|
+
|
|
115
|
+
### Q3: `michi init` を実行してもコマンドがコピーされない
|
|
116
|
+
|
|
117
|
+
**回答**:
|
|
118
|
+
1. Michi を最新版(v0.8.7以降)にアップデートしてください:
|
|
119
|
+
```bash
|
|
120
|
+
npm install -g michi-cli@latest
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
2. 再度 `michi init --claude` を実行してください
|
|
124
|
+
|
|
125
|
+
### Q4: 二重ネストディレクトリが残っているとどうなる?
|
|
126
|
+
|
|
127
|
+
**回答**:
|
|
128
|
+
- 機能的な問題はありませんが、混乱を招く可能性があります
|
|
129
|
+
- 新しい構造(`.claude/commands/kiro/`)が優先されます
|
|
130
|
+
- クリーンな状態にするため、削除を推奨します
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## 参考リンク
|
|
135
|
+
|
|
136
|
+
- [Multi-Repo管理ガイド](multi-repo-guide.md)
|
|
137
|
+
- [CHANGELOG](../../../CHANGELOG.md)
|
|
138
|
+
- [README](../../../README.md)
|
|
@@ -71,6 +71,126 @@ ATLASSIAN_API_TOKEN=your_atlassian_api_token
|
|
|
71
71
|
3. トークン名を入力して作成
|
|
72
72
|
4. トークンをコピーして環境変数に設定
|
|
73
73
|
|
|
74
|
+
### カスタムコマンド(スキル)の配布
|
|
75
|
+
|
|
76
|
+
Multi-Repo AI支援コマンドを使用するには、プロジェクトに `.claude/commands/` を配布する必要があります。
|
|
77
|
+
|
|
78
|
+
#### 初回セットアップ時
|
|
79
|
+
|
|
80
|
+
プロジェクトで初めて Michi を使用する場合、使用する環境に応じて以下のコマンドを実行してください:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
# Claude Code 環境の場合
|
|
84
|
+
michi init --claude
|
|
85
|
+
|
|
86
|
+
# Claude Code Subagents 環境の場合
|
|
87
|
+
michi init --claude-agent
|
|
88
|
+
|
|
89
|
+
# Cursor 環境の場合
|
|
90
|
+
michi init --cursor
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
#### 環境オプションの選択
|
|
94
|
+
|
|
95
|
+
| オプション | 環境 | ルールディレクトリ | 用途 |
|
|
96
|
+
|-----------|------|-------------------|------|
|
|
97
|
+
| `--claude` | Claude Code | `.claude/rules/` | 通常の Claude Code 使用 |
|
|
98
|
+
| `--claude-agent` | Claude Code Subagents | `.claude/agents/` | Claude Code Subagents 使用 |
|
|
99
|
+
| `--cursor` | Cursor IDE | `.cursor/rules/` | Cursor IDE 使用 |
|
|
100
|
+
|
|
101
|
+
**注意**: どの環境でも、コマンドディレクトリは `.claude/commands/` に統一されています(v0.8.7以降)。
|
|
102
|
+
|
|
103
|
+
#### ディレクトリ構造
|
|
104
|
+
|
|
105
|
+
**Claude Code (`--claude`) の場合**:
|
|
106
|
+
```
|
|
107
|
+
.claude/
|
|
108
|
+
├── rules/ # Michi のルールファイル
|
|
109
|
+
└── commands/ # カスタムコマンド(スキル)
|
|
110
|
+
├── kiro/ # kiro: 単一リポジトリ用コマンド
|
|
111
|
+
├── michi/ # michi: Michi拡張コマンド
|
|
112
|
+
└── michi-multi-repo/ # Multi-Repo AI支援コマンド
|
|
113
|
+
├── spec-init.md
|
|
114
|
+
├── spec-requirements.md
|
|
115
|
+
└── spec-design.md
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
**Claude Code Subagents (`--claude-agent`) の場合**:
|
|
119
|
+
```
|
|
120
|
+
.claude/
|
|
121
|
+
├── agents/ # Subagent 用ルールファイル
|
|
122
|
+
└── commands/ # カスタムコマンド(スキル)
|
|
123
|
+
├── kiro/
|
|
124
|
+
├── michi/
|
|
125
|
+
└── michi-multi-repo/
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
**Cursor IDE (`--cursor`) の場合**:
|
|
129
|
+
```
|
|
130
|
+
.cursor/
|
|
131
|
+
├── rules/ # Cursor 用ルールファイル
|
|
132
|
+
└── commands/ # カスタムコマンド(スキル)
|
|
133
|
+
├── kiro/
|
|
134
|
+
├── michi/
|
|
135
|
+
└── michi-multi-repo/
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
#### 既存プロジェクトへの追加
|
|
139
|
+
|
|
140
|
+
既に `.claude/` や `.cursor/` ディレクトリが存在するプロジェクトの場合も、`michi init` を再実行することで、不足しているコマンドが追加されます:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
# 使用している環境に応じて選択
|
|
144
|
+
michi init --claude # Claude Code 環境
|
|
145
|
+
michi init --claude-agent # Claude Code Subagents 環境
|
|
146
|
+
michi init --cursor # Cursor 環境
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
**注意**:
|
|
150
|
+
- 既存のファイルは上書きされます。カスタマイズしたファイルがある場合は、事前にバックアップを取ってください
|
|
151
|
+
- 環境オプション(`--claude`, `--claude-agent`, `--cursor`)は、初回セットアップ時と同じものを使用してください
|
|
152
|
+
|
|
153
|
+
#### コマンドが正しく配布されたか確認
|
|
154
|
+
|
|
155
|
+
以下のコマンドで、`.claude/commands/` の構造を確認できます:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
ls -la .claude/commands/
|
|
159
|
+
# 以下が表示されること:
|
|
160
|
+
# - kiro/
|
|
161
|
+
# - michi/
|
|
162
|
+
# - michi-multi-repo/
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
#### Multi-Repo AIコマンドの利用
|
|
166
|
+
|
|
167
|
+
配布後、Claude Code で以下のコマンドが利用可能になります:
|
|
168
|
+
|
|
169
|
+
| コマンド | 説明 |
|
|
170
|
+
|---------|------|
|
|
171
|
+
| `/michi-multi-repo:spec-init` | プロジェクト初期化(プロジェクト説明から自動生成) |
|
|
172
|
+
| `/michi-multi-repo:spec-requirements` | 要件定義書の自動生成 |
|
|
173
|
+
| `/michi-multi-repo:spec-design` | 設計書の自動生成 |
|
|
174
|
+
|
|
175
|
+
**使用例**:
|
|
176
|
+
```bash
|
|
177
|
+
# Chirper プロジェクトを初期化
|
|
178
|
+
/michi-multi-repo:spec-init "Twitter風SNSアプリケーション Chirper をオニオンアーキテクチャで構築" --jira PC --confluence-space MICHI
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
#### トラブルシューティング
|
|
182
|
+
|
|
183
|
+
**Q: コマンドが認識されない**
|
|
184
|
+
|
|
185
|
+
A: 以下を確認してください:
|
|
186
|
+
1. `.claude/commands/michi-multi-repo/` ディレクトリが存在するか
|
|
187
|
+
2. `michi init --claude` を実行したか
|
|
188
|
+
3. Claude Code を再起動してみる
|
|
189
|
+
|
|
190
|
+
**Q: 古いコマンド名 (`/michi_multi_repo:*`) を使っていた**
|
|
191
|
+
|
|
192
|
+
A: v0.8.7 以降では `/michi-multi-repo:*` に変更されました。詳細は [migration-guide.md](migration-guide.md) を参照してください。
|
|
193
|
+
|
|
74
194
|
## 基本的な使い方
|
|
75
195
|
|
|
76
196
|
### 1. プロジェクトの初期化
|
|
@@ -912,7 +1032,7 @@ Multi-Repoプロジェクトでは、AI支援による要件定義・設計書
|
|
|
912
1032
|
|
|
913
1033
|
### 前提条件
|
|
914
1034
|
|
|
915
|
-
- プロジェクトが初期化されていること(`/
|
|
1035
|
+
- プロジェクトが初期化されていること(`/michi-multi-repo:spec-init` または `michi multi-repo:init`)
|
|
916
1036
|
- 1つ以上のリポジトリが登録されていること(`michi multi-repo:add-repo`)
|
|
917
1037
|
|
|
918
1038
|
### 6. AIプロジェクト初期化(NEW)
|
|
@@ -920,12 +1040,12 @@ Multi-Repoプロジェクトでは、AI支援による要件定義・設計書
|
|
|
920
1040
|
Multi-Repoプロジェクトを AI支援で初期化します。`michi multi-repo:init` の代替コマンドです。
|
|
921
1041
|
|
|
922
1042
|
```bash
|
|
923
|
-
/
|
|
1043
|
+
/michi-multi-repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
|
|
924
1044
|
```
|
|
925
1045
|
|
|
926
1046
|
**例**:
|
|
927
1047
|
```bash
|
|
928
|
-
/
|
|
1048
|
+
/michi-multi-repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
|
|
929
1049
|
```
|
|
930
1050
|
|
|
931
1051
|
**機能**:
|
|
@@ -951,12 +1071,12 @@ Multi-Repoプロジェクトを AI支援で初期化します。`michi multi-rep
|
|
|
951
1071
|
プロジェクトの要件定義書をAI支援で自動生成します。
|
|
952
1072
|
|
|
953
1073
|
```bash
|
|
954
|
-
/
|
|
1074
|
+
/michi-multi-repo:spec-requirements <project-name>
|
|
955
1075
|
```
|
|
956
1076
|
|
|
957
1077
|
**例**:
|
|
958
1078
|
```bash
|
|
959
|
-
/
|
|
1079
|
+
/michi-multi-repo:spec-requirements my-microservices
|
|
960
1080
|
```
|
|
961
1081
|
|
|
962
1082
|
**生成される内容**:
|
|
@@ -973,12 +1093,12 @@ Multi-Repoプロジェクトを AI支援で初期化します。`michi multi-rep
|
|
|
973
1093
|
プロジェクトの技術設計書をAI支援で自動生成します。
|
|
974
1094
|
|
|
975
1095
|
```bash
|
|
976
|
-
/
|
|
1096
|
+
/michi-multi-repo:spec-design <project-name> [-y]
|
|
977
1097
|
```
|
|
978
1098
|
|
|
979
1099
|
**例**:
|
|
980
1100
|
```bash
|
|
981
|
-
/
|
|
1101
|
+
/michi-multi-repo:spec-design my-microservices
|
|
982
1102
|
```
|
|
983
1103
|
|
|
984
1104
|
**生成される内容**:
|
|
@@ -998,7 +1118,7 @@ Multi-Repoプロジェクトを AI支援で初期化します。`michi multi-rep
|
|
|
998
1118
|
|
|
999
1119
|
```bash
|
|
1000
1120
|
# 1. AI初期化(NEW - michi multi-repo:init の代替)
|
|
1001
|
-
/
|
|
1121
|
+
/michi-multi-repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
|
|
1002
1122
|
|
|
1003
1123
|
# 2. リポジトリ登録
|
|
1004
1124
|
michi multi-repo:add-repo my-microservices --name frontend --url https://github.com/myorg/frontend --branch main
|
|
@@ -1006,10 +1126,10 @@ michi multi-repo:add-repo my-microservices --name backend --url https://github.c
|
|
|
1006
1126
|
michi multi-repo:add-repo my-microservices --name database --url https://github.com/myorg/db-schema --branch main
|
|
1007
1127
|
|
|
1008
1128
|
# 3. AI要件定義書生成(NEW)
|
|
1009
|
-
/
|
|
1129
|
+
/michi-multi-repo:spec-requirements my-microservices
|
|
1010
1130
|
|
|
1011
1131
|
# 4. AI設計書生成(NEW)
|
|
1012
|
-
/
|
|
1132
|
+
/michi-multi-repo:spec-design my-microservices
|
|
1013
1133
|
|
|
1014
1134
|
# 5. Confluence同期
|
|
1015
1135
|
michi multi-repo:confluence-sync my-microservices --doc-type requirements
|
package/package.json
CHANGED
|
@@ -22,21 +22,21 @@ describe('environments', () => {
|
|
|
22
22
|
it('should have correct structure for claude', () => {
|
|
23
23
|
const config = ENV_CONFIG.claude;
|
|
24
24
|
expect(config.rulesDir).toBe('.claude/rules');
|
|
25
|
-
expect(config.commandsDir).toBe('.claude/commands
|
|
25
|
+
expect(config.commandsDir).toBe('.claude/commands');
|
|
26
26
|
expect(config.templateSource).toBe('claude');
|
|
27
27
|
});
|
|
28
28
|
|
|
29
29
|
it('should have correct structure for claude-agent', () => {
|
|
30
30
|
const config = ENV_CONFIG['claude-agent'];
|
|
31
31
|
expect(config.rulesDir).toBe('.claude/agents');
|
|
32
|
-
expect(config.commandsDir).toBe('.claude/commands
|
|
32
|
+
expect(config.commandsDir).toBe('.claude/commands');
|
|
33
33
|
expect(config.templateSource).toBe('claude-agent');
|
|
34
34
|
});
|
|
35
35
|
|
|
36
36
|
it('should have correct structure for cursor', () => {
|
|
37
37
|
const config = ENV_CONFIG.cursor;
|
|
38
38
|
expect(config.rulesDir).toBe('.cursor/rules');
|
|
39
|
-
expect(config.commandsDir).toBe('.cursor/commands
|
|
39
|
+
expect(config.commandsDir).toBe('.cursor/commands');
|
|
40
40
|
expect(config.templateSource).toBe('cursor');
|
|
41
41
|
});
|
|
42
42
|
|
|
@@ -21,17 +21,17 @@ export type Environment =
|
|
|
21
21
|
export const ENV_CONFIG: Record<Environment, EnvironmentConfig> = {
|
|
22
22
|
claude: {
|
|
23
23
|
rulesDir: '.claude/rules',
|
|
24
|
-
commandsDir: '.claude/commands
|
|
24
|
+
commandsDir: '.claude/commands',
|
|
25
25
|
templateSource: 'claude',
|
|
26
26
|
},
|
|
27
27
|
'claude-agent': {
|
|
28
28
|
rulesDir: '.claude/agents',
|
|
29
|
-
commandsDir: '.claude/commands
|
|
29
|
+
commandsDir: '.claude/commands',
|
|
30
30
|
templateSource: 'claude-agent',
|
|
31
31
|
},
|
|
32
32
|
cursor: {
|
|
33
33
|
rulesDir: '.cursor/rules',
|
|
34
|
-
commandsDir: '.cursor/commands
|
|
34
|
+
commandsDir: '.cursor/commands',
|
|
35
35
|
templateSource: 'cursor',
|
|
36
36
|
},
|
|
37
37
|
gemini: {
|
|
@@ -26,7 +26,7 @@ Multi-Repoプロジェクト **$1** の技術設計書を生成します。
|
|
|
26
26
|
- プロジェクト名、JIRAキー、Confluenceスペース
|
|
27
27
|
- 登録リポジトリ一覧
|
|
28
28
|
2. `docs/michi/$1/overview/requirements.md` から要件読み込み
|
|
29
|
-
- 要件定義書が存在しない場合は、先に `/
|
|
29
|
+
- 要件定義書が存在しない場合は、先に `/michi-multi-repo:spec-requirements $1` の実行を促す
|
|
30
30
|
3. `.kiro/settings/rules/design-principles.md` から設計原則取得(存在する場合)
|
|
31
31
|
4. `.kiro/settings/templates/specs/design.md` から構造参照(存在する場合)
|
|
32
32
|
|
|
@@ -246,7 +246,7 @@ sequenceDiagram
|
|
|
246
246
|
エラー: 要件定義書が見つかりません: `docs/michi/{project}/overview/requirements.md`
|
|
247
247
|
|
|
248
248
|
先に要件定義書を生成してください:
|
|
249
|
-
/
|
|
249
|
+
/michi-multi-repo:spec-requirements {project}
|
|
250
250
|
```
|
|
251
251
|
|
|
252
252
|
- **プロジェクト未登録**:
|
|
@@ -290,7 +290,7 @@ sequenceDiagram
|
|
|
290
290
|
4. **CI/CD設定**: `michi multi-repo:ci-status {project}` でCI結果を監視
|
|
291
291
|
|
|
292
292
|
**修正が必要な場合**:
|
|
293
|
-
- フィードバックを提供し、`/
|
|
293
|
+
- フィードバックを提供し、`/michi-multi-repo:spec-design $1` を再実行
|
|
294
294
|
- `-y` フラグで自動上書き可能
|
|
295
295
|
|
|
296
296
|
think hard
|
|
@@ -24,7 +24,7 @@ argument-hint: "<project-description>" --jira <JIRA_KEY> --confluence-space <SPA
|
|
|
24
24
|
|
|
25
25
|
引数の形式:
|
|
26
26
|
```
|
|
27
|
-
/
|
|
27
|
+
/michi-multi-repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
パラメータ:
|
|
@@ -171,12 +171,12 @@ docs/michi/{project-name}/
|
|
|
171
171
|
|
|
172
172
|
2. **AI要件定義書を生成**:
|
|
173
173
|
\`\`\`bash
|
|
174
|
-
/
|
|
174
|
+
/michi-multi-repo:spec-requirements {project}
|
|
175
175
|
\`\`\`
|
|
176
176
|
|
|
177
177
|
3. **AI設計書を生成**:
|
|
178
178
|
\`\`\`bash
|
|
179
|
-
/
|
|
179
|
+
/michi-multi-repo:spec-design {project}
|
|
180
180
|
\`\`\`
|
|
181
181
|
|
|
182
182
|
4. **Confluenceに同期**:
|
|
@@ -194,10 +194,10 @@ docs/michi/{project-name}/
|
|
|
194
194
|
エラー: 必須パラメータが不足しています。
|
|
195
195
|
|
|
196
196
|
使用方法:
|
|
197
|
-
/
|
|
197
|
+
/michi-multi-repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
|
|
198
198
|
|
|
199
199
|
例:
|
|
200
|
-
/
|
|
200
|
+
/michi-multi-repo:spec-init "マイクロサービスでECサイト構築" --jira MSV --confluence-space MSV
|
|
201
201
|
```
|
|
202
202
|
|
|
203
203
|
- **JIRAキーが不正**:
|
|
@@ -217,7 +217,7 @@ docs/michi/{project-name}/
|
|
|
217
217
|
|
|
218
218
|
Michiプロジェクトのルートディレクトリで実行してください。
|
|
219
219
|
または、次のコマンドで初期設定を行ってください:
|
|
220
|
-
michi
|
|
220
|
+
michi init
|
|
221
221
|
```
|
|
222
222
|
|
|
223
223
|
### Fallback Strategy
|
package/templates/claude/commands/{michi_multi_repo → michi-multi-repo}/spec-requirements.md
RENAMED
|
@@ -137,7 +137,7 @@ graph TB
|
|
|
137
137
|
1. **生成された要件定義書のパス**: `docs/michi/{project}/overview/requirements.md`
|
|
138
138
|
2. **含まれるリポジトリ/サービスの一覧**: サービス名と役割の要約
|
|
139
139
|
3. **次のステップ**:
|
|
140
|
-
- `/
|
|
140
|
+
- `/michi-multi-repo:spec-design $1` で設計書を生成
|
|
141
141
|
- `michi multi-repo:confluence-sync $1 --doc-type requirements` でConfluenceに同期
|
|
142
142
|
|
|
143
143
|
**出力形式**:
|
|
@@ -154,7 +154,7 @@ graph TB
|
|
|
154
154
|
|
|
155
155
|
### 次のステップ
|
|
156
156
|
1. 要件定義書を確認: `docs/michi/{project}/overview/requirements.md`
|
|
157
|
-
2. 設計書を生成: `/
|
|
157
|
+
2. 設計書を生成: `/michi-multi-repo:spec-design {project}`
|
|
158
158
|
3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type requirements`
|
|
159
159
|
```
|
|
160
160
|
|