@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.
Files changed (44) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +24 -25
  3. package/dist/scripts/config-interactive.d.ts +1 -1
  4. package/dist/scripts/config-interactive.d.ts.map +1 -1
  5. package/dist/scripts/config-interactive.js +4 -4
  6. package/dist/scripts/config-interactive.js.map +1 -1
  7. package/dist/scripts/confluence-sync.js +2 -2
  8. package/dist/scripts/confluence-sync.js.map +1 -1
  9. package/dist/scripts/create-project.d.ts +2 -2
  10. package/dist/scripts/create-project.js +2 -2
  11. package/dist/scripts/jira-sync.js +3 -3
  12. package/dist/scripts/jira-sync.js.map +1 -1
  13. package/dist/scripts/utils/__tests__/config-loader.test.d.ts +5 -0
  14. package/dist/scripts/utils/__tests__/config-loader.test.d.ts.map +1 -0
  15. package/dist/scripts/utils/__tests__/config-loader.test.js +201 -0
  16. package/dist/scripts/utils/__tests__/config-loader.test.js.map +1 -0
  17. package/dist/scripts/utils/__tests__/config-validator.test.js +29 -16
  18. package/dist/scripts/utils/__tests__/config-validator.test.js.map +1 -1
  19. package/dist/scripts/utils/config-loader.d.ts +4 -0
  20. package/dist/scripts/utils/config-loader.d.ts.map +1 -1
  21. package/dist/scripts/utils/config-loader.js +24 -2
  22. package/dist/scripts/utils/config-loader.js.map +1 -1
  23. package/dist/scripts/utils/config-validator.js +8 -9
  24. package/dist/scripts/utils/config-validator.js.map +1 -1
  25. package/dist/src/cli.js +2 -2
  26. package/dist/src/cli.js.map +1 -1
  27. package/docs/config-reference.md +76 -197
  28. package/docs/customization-guide.md +61 -9
  29. package/docs/multi-project.md +157 -25
  30. package/docs/new-project-setup.md +36 -36
  31. package/docs/quick-reference.md +23 -20
  32. package/docs/setup.md +5 -3
  33. package/env.example +3 -1
  34. package/package.json +1 -1
  35. package/scripts/config-interactive.ts +4 -3
  36. package/scripts/confluence-sync.ts +2 -2
  37. package/scripts/create-project.ts +4 -4
  38. package/scripts/jira-sync.ts +3 -3
  39. package/scripts/setup-existing.sh +1 -1
  40. package/scripts/utils/__tests__/config-loader.test.ts +254 -0
  41. package/scripts/utils/__tests__/config-validator.test.ts +32 -16
  42. package/scripts/utils/config-loader.ts +30 -2
  43. package/scripts/utils/config-validator.ts +8 -8
  44. 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
-