@sk8metal/michi-cli 0.0.4 → 0.0.5
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 +18 -0
- package/README.md +24 -25
- package/dist/scripts/config-interactive.d.ts +1 -1
- package/dist/scripts/config-interactive.d.ts.map +1 -1
- package/dist/scripts/config-interactive.js +4 -4
- package/dist/scripts/config-interactive.js.map +1 -1
- package/dist/scripts/confluence-sync.js +2 -2
- package/dist/scripts/confluence-sync.js.map +1 -1
- package/dist/scripts/create-project.d.ts +2 -2
- package/dist/scripts/create-project.js +2 -2
- package/dist/scripts/jira-sync.js +3 -3
- package/dist/scripts/jira-sync.js.map +1 -1
- package/dist/scripts/utils/__tests__/config-loader.test.d.ts +5 -0
- package/dist/scripts/utils/__tests__/config-loader.test.d.ts.map +1 -0
- package/dist/scripts/utils/__tests__/config-loader.test.js +201 -0
- package/dist/scripts/utils/__tests__/config-loader.test.js.map +1 -0
- package/dist/scripts/utils/__tests__/config-validator.test.js +29 -16
- package/dist/scripts/utils/__tests__/config-validator.test.js.map +1 -1
- package/dist/scripts/utils/config-loader.d.ts +4 -0
- package/dist/scripts/utils/config-loader.d.ts.map +1 -1
- package/dist/scripts/utils/config-loader.js +24 -2
- package/dist/scripts/utils/config-loader.js.map +1 -1
- package/dist/scripts/utils/config-validator.js +8 -9
- package/dist/scripts/utils/config-validator.js.map +1 -1
- package/dist/src/cli.js +2 -2
- package/dist/src/cli.js.map +1 -1
- package/docs/config-reference.md +76 -197
- package/docs/customization-guide.md +61 -9
- package/docs/multi-project.md +157 -25
- package/docs/new-project-setup.md +36 -36
- package/docs/quick-reference.md +23 -20
- package/docs/setup.md +5 -3
- package/env.example +3 -1
- package/package.json +1 -1
- package/scripts/config-interactive.ts +4 -3
- package/scripts/confluence-sync.ts +2 -2
- package/scripts/create-project.ts +4 -4
- package/scripts/jira-sync.ts +3 -3
- package/scripts/setup-existing.sh +1 -1
- package/scripts/utils/__tests__/config-loader.test.ts +254 -0
- package/scripts/utils/__tests__/config-validator.test.ts +32 -16
- package/scripts/utils/config-loader.ts +30 -2
- package/scripts/utils/config-validator.ts +8 -8
- package/docs/testing.md +0 -202
package/docs/testing.md
DELETED
|
@@ -1,202 +0,0 @@
|
|
|
1
|
-
# テスト・検証ガイド
|
|
2
|
-
|
|
3
|
-
> **凡例について**: `<feature>` などの記号の意味は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
|
|
4
|
-
|
|
5
|
-
## E2Eテストシナリオ
|
|
6
|
-
|
|
7
|
-
### シナリオ1: 単一機能の完全フロー
|
|
8
|
-
|
|
9
|
-
新機能「ユーザー認証」を要件定義からリリースまで実行:
|
|
10
|
-
|
|
11
|
-
#### Step 1: 要件定義
|
|
12
|
-
```bash
|
|
13
|
-
# 凡例
|
|
14
|
-
/kiro:spec-init <機能説明>
|
|
15
|
-
/kiro:spec-requirements <feature>
|
|
16
|
-
jj commit -m "docs: <feature> 要件定義"
|
|
17
|
-
jj git push
|
|
18
|
-
npm run confluence:sync <feature> requirements
|
|
19
|
-
|
|
20
|
-
# 具体例
|
|
21
|
-
/kiro:spec-init OAuth 2.0を使ったユーザー認証機能
|
|
22
|
-
/kiro:spec-requirements user-auth
|
|
23
|
-
jj commit -m "docs: ユーザー認証 要件定義"
|
|
24
|
-
jj git push
|
|
25
|
-
npm run confluence:sync user-auth requirements
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
**確認ポイント**:
|
|
29
|
-
- [ ] `.kiro/specs/user-auth/requirements.md` が生成された
|
|
30
|
-
- [ ] Confluenceページが作成された
|
|
31
|
-
- [ ] ラベル `project:michi, requirements, user-auth` が付与された
|
|
32
|
-
- [ ] 企画・部長にメンション通知が届いた
|
|
33
|
-
|
|
34
|
-
#### Step 2: 設計
|
|
35
|
-
```bash
|
|
36
|
-
# 凡例
|
|
37
|
-
/kiro:spec-design <feature>
|
|
38
|
-
jj commit -m "docs: <feature> 設計"
|
|
39
|
-
jj git push
|
|
40
|
-
npm run confluence:sync <feature> design
|
|
41
|
-
npm run excel:sync <feature>
|
|
42
|
-
|
|
43
|
-
# 具体例
|
|
44
|
-
/kiro:spec-design user-auth
|
|
45
|
-
jj commit -m "docs: ユーザー認証 設計"
|
|
46
|
-
jj git push
|
|
47
|
-
npm run confluence:sync user-auth design
|
|
48
|
-
npm run excel:sync user-auth
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
**確認ポイント**:
|
|
52
|
-
- [ ] `.kiro/specs/user-auth/design.md` が生成された
|
|
53
|
-
- [ ] 見積もりセクションが含まれている
|
|
54
|
-
- [ ] Confluenceページが作成された(親: 要件定義)
|
|
55
|
-
- [ ] Excelファイルが出力された
|
|
56
|
-
|
|
57
|
-
#### Step 3: タスク分割
|
|
58
|
-
```bash
|
|
59
|
-
# 凡例
|
|
60
|
-
/kiro:spec-tasks <feature>
|
|
61
|
-
jj commit -m "docs: <feature> タスク分割"
|
|
62
|
-
jj git push
|
|
63
|
-
npm run jira:sync <feature>
|
|
64
|
-
|
|
65
|
-
# 具体例
|
|
66
|
-
/kiro:spec-tasks user-auth
|
|
67
|
-
jj commit -m "docs: ユーザー認証 タスク分割"
|
|
68
|
-
jj git push
|
|
69
|
-
npm run jira:sync user-auth
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
**確認ポイント**:
|
|
73
|
-
- [ ] `.kiro/specs/user-auth/tasks.md` が生成された
|
|
74
|
-
- [ ] JIRA Epicが作成された
|
|
75
|
-
- [ ] JIRA Storyが作成された(複数)
|
|
76
|
-
- [ ] Epic-Storyリンクが設定された
|
|
77
|
-
|
|
78
|
-
#### Step 4: 実装
|
|
79
|
-
```
|
|
80
|
-
/kiro:spec-impl user-auth FE-1,BE-1
|
|
81
|
-
jj commit -m "feat: ユーザー認証実装 [MICHI-123]"
|
|
82
|
-
jj bookmark create michi/feature/user-auth -r '@-'
|
|
83
|
-
jj git push --bookmark michi/feature/user-auth --allow-new
|
|
84
|
-
npm run github:create-pr michi/feature/user-auth
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
**確認ポイント**:
|
|
88
|
-
- [ ] テストが先に書かれた(TDD)
|
|
89
|
-
- [ ] コードが実装された
|
|
90
|
-
- [ ] PRが作成された
|
|
91
|
-
- [ ] JIRA ステータスが "In Review" に更新された
|
|
92
|
-
|
|
93
|
-
### シナリオ2: マルチプロジェクト横断テスト
|
|
94
|
-
|
|
95
|
-
3つのプロジェクトで同時に要件定義を実施:
|
|
96
|
-
|
|
97
|
-
```bash
|
|
98
|
-
# プロジェクトA
|
|
99
|
-
cd customer-a-service-1
|
|
100
|
-
/kiro:spec-requirements payment-feature
|
|
101
|
-
npm run confluence:sync payment-feature
|
|
102
|
-
|
|
103
|
-
# プロジェクトB
|
|
104
|
-
cd ../customer-b-api
|
|
105
|
-
/kiro:spec-requirements user-api
|
|
106
|
-
npm run confluence:sync user-api
|
|
107
|
-
|
|
108
|
-
# プロジェクトC(Michi)
|
|
109
|
-
cd ../michi
|
|
110
|
-
/kiro:spec-requirements integration-hub
|
|
111
|
-
npm run confluence:sync integration-hub
|
|
112
|
-
|
|
113
|
-
# 横断確認
|
|
114
|
-
npm run project:list
|
|
115
|
-
npm run project:dashboard
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
**確認ポイント**:
|
|
119
|
-
- [ ] 3つのプロジェクトすべてでページ作成成功
|
|
120
|
-
- [ ] Confluenceダッシュボードに3プロジェクト表示
|
|
121
|
-
- [ ] ラベルでフィルタリング可能
|
|
122
|
-
- [ ] JIRAダッシュボードに3プロジェクト表示
|
|
123
|
-
|
|
124
|
-
## チームフィードバック収集
|
|
125
|
-
|
|
126
|
-
### フィードバック項目
|
|
127
|
-
|
|
128
|
-
#### 使いやすさ
|
|
129
|
-
- [ ] Cursorコマンドは直感的か?
|
|
130
|
-
- [ ] ドキュメントは理解しやすいか?
|
|
131
|
-
- [ ] エラーメッセージは明確か?
|
|
132
|
-
|
|
133
|
-
#### 効率性
|
|
134
|
-
- [ ] 要件定義の時間短縮できたか?
|
|
135
|
-
- [ ] Confluence/JIRA連携は手間を減らしたか?
|
|
136
|
-
- [ ] 全体の開発スピードは向上したか?
|
|
137
|
-
|
|
138
|
-
#### 品質
|
|
139
|
-
- [ ] AIが生成する仕様書の品質は十分か?
|
|
140
|
-
- [ ] テンプレートは実務に適しているか?
|
|
141
|
-
- [ ] 見積もりの精度は妥当か?
|
|
142
|
-
|
|
143
|
-
### フィードバック方法
|
|
144
|
-
|
|
145
|
-
GitHub Issuesで収集:
|
|
146
|
-
```bash
|
|
147
|
-
gh issue create --title "フィードバック: <内容>" --body "<詳細>"
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
ラベル:
|
|
151
|
-
- `feedback:usability`: 使いやすさ
|
|
152
|
-
- `feedback:efficiency`: 効率性
|
|
153
|
-
- `feedback:quality`: 品質
|
|
154
|
-
|
|
155
|
-
## 継続的改善
|
|
156
|
-
|
|
157
|
-
### Week 1-2: パイロット運用
|
|
158
|
-
- 1プロジェクトで全フロー実行
|
|
159
|
-
- 問題点を記録
|
|
160
|
-
- フィードバック収集
|
|
161
|
-
|
|
162
|
-
### Week 3-4: 改善
|
|
163
|
-
- テンプレート調整
|
|
164
|
-
- スクリプト改善
|
|
165
|
-
- ドキュメント更新
|
|
166
|
-
|
|
167
|
-
### Week 5-6: 横展開
|
|
168
|
-
- 2-3プロジェクトに展開
|
|
169
|
-
- チーム全体でフィードバック
|
|
170
|
-
|
|
171
|
-
### Week 7-8: 最適化
|
|
172
|
-
- ベストプラクティス確立
|
|
173
|
-
- 自動化範囲の拡大
|
|
174
|
-
- ツールの安定化
|
|
175
|
-
|
|
176
|
-
## メトリクス
|
|
177
|
-
|
|
178
|
-
### 効率化指標
|
|
179
|
-
|
|
180
|
-
| 指標 | 導入前 | 導入後 | 改善率 |
|
|
181
|
-
|------|--------|--------|--------|
|
|
182
|
-
| 要件定義時間 | 3日 | 0.5日 | 83% |
|
|
183
|
-
| 設計時間 | 5日 | 1日 | 80% |
|
|
184
|
-
| タスク分割時間 | 2日 | 0.5日 | 75% |
|
|
185
|
-
| ドキュメント作成 | 2日 | 0.2日 | 90% |
|
|
186
|
-
|
|
187
|
-
### 品質指標
|
|
188
|
-
|
|
189
|
-
| 指標 | 目標値 | 測定方法 |
|
|
190
|
-
|------|--------|---------|
|
|
191
|
-
| 仕様書の完成度 | 90%以上 | レビュースコア |
|
|
192
|
-
| 見積もり精度 | ±20%以内 | 実績との比較 |
|
|
193
|
-
| テストカバレッジ | 95%以上 | 自動測定 |
|
|
194
|
-
|
|
195
|
-
## 次のステップ
|
|
196
|
-
|
|
197
|
-
1. パイロットプロジェクトでE2Eテスト実行
|
|
198
|
-
2. フィードバック収集
|
|
199
|
-
3. 改善実施
|
|
200
|
-
4. 他プロジェクトに横展開
|
|
201
|
-
5. ベストプラクティス確立
|
|
202
|
-
|