@sk8metal/michi-cli 0.1.0 → 0.2.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.
Files changed (52) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +1 -0
  3. package/dist/scripts/__tests__/validate-phase.test.js +83 -0
  4. package/dist/scripts/__tests__/validate-phase.test.js.map +1 -1
  5. package/dist/scripts/config/config-schema.d.ts +14 -0
  6. package/dist/scripts/config/config-schema.d.ts.map +1 -1
  7. package/dist/scripts/config/config-schema.js +9 -0
  8. package/dist/scripts/config/config-schema.js.map +1 -1
  9. package/dist/scripts/phase-runner.d.ts.map +1 -1
  10. package/dist/scripts/phase-runner.js +2 -2
  11. package/dist/scripts/phase-runner.js.map +1 -1
  12. package/dist/scripts/validate-phase.d.ts.map +1 -1
  13. package/dist/scripts/validate-phase.js +18 -3
  14. package/dist/scripts/validate-phase.js.map +1 -1
  15. package/dist/src/__tests__/integration/setup/claude.test.js +82 -0
  16. package/dist/src/__tests__/integration/setup/claude.test.js.map +1 -1
  17. package/dist/src/cli.d.ts.map +1 -1
  18. package/dist/src/cli.js +1 -0
  19. package/dist/src/cli.js.map +1 -1
  20. package/dist/src/commands/setup-existing.d.ts +1 -0
  21. package/dist/src/commands/setup-existing.d.ts.map +1 -1
  22. package/dist/src/commands/setup-existing.js +33 -0
  23. package/dist/src/commands/setup-existing.js.map +1 -1
  24. package/docs/user-guide/guides/agent-skills-integration.md +217 -0
  25. package/docs/user-guide/guides/customization.md +2 -2
  26. package/docs/user-guide/guides/multi-project.md +2 -2
  27. package/docs/user-guide/guides/phase-automation.md +25 -25
  28. package/docs/user-guide/guides/workflow.md +8 -20
  29. package/docs/user-guide/reference/config.md +2 -2
  30. package/docs/user-guide/reference/tasks-template.md +2 -2
  31. package/docs/user-guide/testing/test-planning-flow.md +1 -1
  32. package/package.json +2 -3
  33. package/scripts/__tests__/validate-phase.test.ts +100 -0
  34. package/scripts/config/config-schema.ts +11 -0
  35. package/scripts/phase-runner.ts +12 -3
  36. package/scripts/validate-phase.ts +21 -3
  37. package/templates/claude/agents/design-reviewer/AGENT.md +497 -0
  38. package/templates/claude/agents/e2e-first-planner/AGENT.md +410 -0
  39. package/templates/claude/agents/oss-license-checker/AGENT.md +265 -0
  40. package/templates/claude/agents/pr-resolver/AGENT.md +196 -0
  41. package/templates/claude/agents/stable-version-auditor/AGENT.md +279 -0
  42. package/templates/claude/commands/kiro/kiro-spec-impl.md +13 -4
  43. package/templates/claude/commands/kiro/kiro-spec-tasks.md +17 -3
  44. package/templates/claude/commands/michi/design-review.md +66 -0
  45. package/templates/claude/commands/michi/e2e-plan.md +113 -0
  46. package/templates/claude/commands/michi/license-check.md +80 -0
  47. package/templates/claude/commands/michi/pr-resolve.md +153 -0
  48. package/templates/claude/commands/michi/version-audit.md +91 -0
  49. package/templates/claude/skills/design-review/SKILL.md +648 -0
  50. package/templates/claude/skills/e2e-first-planning/SKILL.md +360 -0
  51. package/templates/claude/skills/oss-license/SKILL.md +232 -0
  52. package/templates/claude/skills/stable-version/SKILL.md +252 -0
@@ -0,0 +1,113 @@
1
+ ---
2
+ name: /michi:e2e-plan
3
+ description: E2Eファースト方式でタスク分割を計画する
4
+ ---
5
+
6
+ # E2Eプランニング
7
+
8
+ このコマンドは、E2Eファースト方式でタスク分割を計画し、早期に動作確認可能な実装計画を策定します。
9
+
10
+ ## サブエージェント呼び出し
11
+
12
+ **重要**: このコマンドは `e2e-first-planner` サブエージェントを使用します。
13
+
14
+ e2e-first-planner サブエージェントを使用して、E2Eファースト方式でタスク分割を計画してください。
15
+
16
+ ## 計画方針
17
+
18
+ ### 1. ミニマム動作確認可能な単位を最優先
19
+ - 最小構成での動作確認
20
+ - 早期フィードバックの獲得
21
+ - リスクの早期発見
22
+ - 段階的な機能拡張
23
+
24
+ ### 2. E2Eテスト可能なマイルストーンを設定
25
+ - ユーザーストーリーベースのマイルストーン
26
+ - 各マイルストーンでE2Eテストを実施
27
+ - 統合テストを早期に開始
28
+ - 継続的なデプロイ可能性の維持
29
+
30
+ ### 3. 結合テストを早期に実施
31
+ - コンポーネント間の連携確認
32
+ - API統合の早期テスト
33
+ - データフローの検証
34
+ - 外部サービス連携の確認
35
+
36
+ ## E2Eファースト開発の原則
37
+
38
+ ### Walking Skeleton(歩く骨格)アプローチ
39
+ 1. **最小限の機能実装**: 画面からDBまで一連の流れを実装
40
+ 2. **デプロイパイプライン構築**: CI/CD環境を最初に整備
41
+ 3. **段階的拡張**: 機能を少しずつ追加していく
42
+
43
+ ### タスク分割の優先順位
44
+
45
+ | 優先度 | タスクタイプ | 理由 |
46
+ |--------|-------------|------|
47
+ | **最優先** | E2E動作確認 | 全体の動作を早期確認 |
48
+ | **高** | 統合ポイント | 連携部分のリスク高 |
49
+ | **中** | 個別機能 | 独立して実装可能 |
50
+ | **低** | UI改善・最適化 | 動作確認後に実施 |
51
+
52
+ ## 計画に含める項目
53
+
54
+ ### 1. マイルストーン定義
55
+ ```markdown
56
+ ## Milestone 1: 基本フロー(E2E)
57
+ - [ ] ユーザー登録画面
58
+ - [ ] 認証API
59
+ - [ ] DBスキーマ
60
+ - [ ] E2Eテスト: 新規ユーザー登録
61
+
62
+ ## Milestone 2: コア機能(E2E)
63
+ - [ ] ダッシュボード画面
64
+ - [ ] データ取得API
65
+ - [ ] データ表示機能
66
+ - [ ] E2Eテスト: ログイン→ダッシュボード表示
67
+ ```
68
+
69
+ ### 2. 依存関係の明示
70
+ - 前提条件となるタスク
71
+ - 並行実行可能なタスク
72
+ - ブロッカーとなる技術的課題
73
+
74
+ ### 3. テスト戦略
75
+ - E2Eテストシナリオ
76
+ - 統合テストポイント
77
+ - テストデータの準備
78
+
79
+ ## 参照スキル
80
+
81
+ スキル `e2e-first-planning` のガイドラインに従ってタスク分割を実施してください。
82
+
83
+ ## 使用例
84
+
85
+ ```
86
+ /michi:e2e-plan
87
+ ```
88
+
89
+ コマンド実行後、機能要件を分析し、E2Eファースト方式のタスク分割計画を作成します。
90
+
91
+ ## 入力情報
92
+
93
+ - {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/requirements.md
94
+ - {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/design.md
95
+
96
+ ## 出力
97
+
98
+ E2Eプランニング結果は以下の形式で出力されます:
99
+
100
+ 1. **Walking Skeletonの定義**: 最小限の動作確認範囲
101
+ 2. **マイルストーン一覧**: E2Eテスト可能な単位
102
+ 3. **タスクリスト**: 優先順位付きタスク
103
+ 4. **依存関係図**: タスク間の依存関係
104
+ 5. **推定工数**: 各タスクの概算工数
105
+
106
+ ## Phase 0.5統合
107
+
108
+ このコマンドはPhase 0.5(タスク分割)で実行することを推奨します。
109
+ `/kiro:spec-tasks` コマンドから呼び出すことも可能です。
110
+
111
+ ## 言語設定
112
+
113
+ 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: /michi:license-check
3
+ description: 依存パッケージのOSSライセンスを確認する
4
+ ---
5
+
6
+ # ライセンス確認
7
+
8
+ このコマンドは、プロジェクトの依存パッケージのOSSライセンスを確認し、ライセンス互換性をチェックします。
9
+
10
+ ## サブエージェント呼び出し
11
+
12
+ **重要**: このコマンドは `oss-license-checker` サブエージェントを使用します。
13
+
14
+ oss-license-checker サブエージェントを使用して、依存パッケージのライセンスを確認してください。
15
+
16
+ ## 確認対象
17
+
18
+ ### 1. 依存関係ファイル
19
+ - **Node.js**: package.json、package-lock.json
20
+ - **Java**: build.gradle、pom.xml
21
+ - **PHP**: composer.json、composer.lock
22
+ - **Python**: requirements.txt、Pipfile、pyproject.toml
23
+
24
+ ### 2. 新規追加されたライブラリ
25
+ - 最新のコミットで追加された依存関係
26
+ - バージョンアップされた依存関係
27
+ - 間接依存関係(transitive dependencies)
28
+
29
+ ### 3. ライセンス互換性チェック
30
+ - プロジェクトのライセンスとの互換性
31
+ - GPL、LGPL、Apache、MIT、BSD等の確認
32
+ - コピーレフト条項の確認
33
+ - 商用利用の可否
34
+
35
+ ## チェック項目
36
+
37
+ ### ライセンスリスク分類
38
+
39
+ | リスク | ライセンス例 | 対応 |
40
+ |--------|-------------|------|
41
+ | **高** | GPL v2/v3、AGPL | 使用前に法務確認必須 |
42
+ | **中** | LGPL、MPL | 使用方法を確認 |
43
+ | **低** | MIT、Apache 2.0、BSD | 通常使用可能 |
44
+
45
+ ### 確認事項
46
+ - [ ] ライセンステキストの存在
47
+ - [ ] 著作権表示の要件
48
+ - [ ] ソースコード公開の要件
49
+ - [ ] 特許条項の確認
50
+ - [ ] 商用利用の制限
51
+
52
+ ## 参照スキル
53
+
54
+ スキル `oss-license` のガイドラインに従ってライセンスチェックを実施してください。
55
+
56
+ ## 使用例
57
+
58
+ ```
59
+ /michi:license-check
60
+ ```
61
+
62
+ コマンド実行後、プロジェクトの依存パッケージを分析し、ライセンス状況をレポートします。
63
+
64
+ ## 出力
65
+
66
+ ライセンスチェック結果は以下の形式で出力されます:
67
+
68
+ 1. **サマリー**: 依存パッケージ数、ライセンスタイプの分布
69
+ 2. **高リスクライセンス**: GPL等の注意が必要なライセンス
70
+ 3. **不明なライセンス**: ライセンスが特定できないパッケージ
71
+ 4. **推奨アクション**: 対応が必要な項目のリスト
72
+ 5. **ライセンス一覧**: 全パッケージのライセンス詳細
73
+
74
+ ## Phase A統合
75
+
76
+ このコマンドはPhase A(PR前自動テスト)で実行することを推奨します。
77
+
78
+ ## 言語設定
79
+
80
+ 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -0,0 +1,153 @@
1
+ ---
2
+ name: /michi:pr-resolve
3
+ description: PRレビューコメントへの対応を支援する
4
+ ---
5
+
6
+ # PRコメント対応
7
+
8
+ このコマンドは、プルリクエストのレビューコメントへの対応を支援し、すべてのコメントが適切に解決されているか確認します。
9
+
10
+ ## サブエージェント呼び出し
11
+
12
+ **重要**: このコマンドは `pr-resolver` サブエージェントを使用します。
13
+
14
+ pr-resolver サブエージェントを使用して、PRレビューコメントへの対応を確認してください。
15
+
16
+ ## 確認項目
17
+
18
+ ### 1. コメントの収集
19
+ - GitHub PR APIを使用してコメント取得
20
+ - レビュー承認/変更要求の確認
21
+ - 未解決コメントのリスト化
22
+ - 返信済みコメントの確認
23
+
24
+ ### 2. 対応状況の確認
25
+ - コード変更による対応
26
+ - コメントでの返信による対応
27
+ - 「Resolve conversation」の実行状況
28
+ - 対応漏れの検出
29
+
30
+ ### 3. 対応完了の検証
31
+ - すべてのコメントへの対応完了
32
+ - レビュアーからの再承認の確認
33
+ - マージ可能状態の確認
34
+
35
+ ## 使用方法
36
+
37
+ ### 基本的な使い方
38
+
39
+ ```bash
40
+ # 現在のブランチのPRコメントを確認
41
+ /michi:pr-resolve
42
+
43
+ # 特定のPR番号を指定
44
+ /michi:pr-resolve 123
45
+ ```
46
+
47
+ ### GitHub CLI連携
48
+
49
+ コマンド内部で以下のGitHub CLIコマンドを使用します:
50
+
51
+ ```bash
52
+ # PRコメント一覧取得
53
+ gh pr view <PR番号> --json comments,reviews
54
+
55
+ # PRステータス確認
56
+ gh pr status
57
+
58
+ # PRコメント表示
59
+ gh pr view <PR番号>
60
+ ```
61
+
62
+ ## 対応フロー
63
+
64
+ ### ステップ1: コメント収集
65
+ ```markdown
66
+ ## 未解決コメント一覧
67
+ 1. [ファイル名:行数] レビュアー: コメント内容
68
+ 2. [ファイル名:行数] レビュアー: コメント内容
69
+ ```
70
+
71
+ ### ステップ2: 対応計画
72
+ ```markdown
73
+ ## 対応計画
74
+ - [ ] コメント1: コード修正(認証ロジックの改善)
75
+ - [ ] コメント2: 返信のみ(設計意図の説明)
76
+ - [ ] コメント3: コード修正(テストケース追加)
77
+ ```
78
+
79
+ ### ステップ3: 対応実施
80
+ - コード修正が必要な箇所を特定
81
+ - 修正内容を提案
82
+ - コミットメッセージの推奨
83
+
84
+ ### ステップ4: 対応完了確認
85
+ ```markdown
86
+ ## 対応完了レポート
87
+ ✓ すべてのコメントに対応済み
88
+ ✓ レビュアーから再承認を獲得
89
+ ✓ マージ可能状態
90
+ ```
91
+
92
+ ## 出力
93
+
94
+ PRコメント対応結果は以下の形式で出力されます:
95
+
96
+ 1. **サマリー**: 総コメント数、未解決数、対応完了数
97
+ 2. **未解決コメント詳細**: 各コメントの内容と推奨対応
98
+ 3. **対応済みコメント**: すでに解決済みのコメント
99
+ 4. **次のアクション**: マージ前に必要な作業
100
+
101
+ ## Phase A統合
102
+
103
+ このコマンドはPhase A(PR前自動テスト)またはレビュー対応時に実行することを推奨します。
104
+
105
+ ## GitHub CLI必須
106
+
107
+ このコマンドは `gh` コマンド(GitHub CLI)が必要です。
108
+ 未インストールの場合は以下でインストールしてください:
109
+
110
+ ```bash
111
+ # macOS
112
+ brew install gh
113
+
114
+ # 認証
115
+ gh auth login
116
+ ```
117
+
118
+ ## 環境変数
119
+
120
+ GitHubトークンが必要な場合は、以下の環境変数を設定してください:
121
+
122
+ ```bash
123
+ export GITHUB_TOKEN="your_token_here"
124
+ ```
125
+
126
+ ## 使用例
127
+
128
+ ### PRレビュー対応の完全フロー
129
+
130
+ ```bash
131
+ # 1. PRコメントを確認
132
+ /michi:pr-resolve
133
+
134
+ # 2. コメントに基づいてコード修正
135
+ # (Claude Codeが修正を提案)
136
+
137
+ # 3. 変更をコミット
138
+ git add .
139
+ git commit -m "fix: レビューコメントに対応"
140
+
141
+ # 4. PRを更新
142
+ git push
143
+
144
+ # 5. 再度確認
145
+ /michi:pr-resolve
146
+
147
+ # 6. すべて解決済みならマージ
148
+ gh pr merge
149
+ ```
150
+
151
+ ## 言語設定
152
+
153
+ 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: /michi:version-audit
3
+ description: 依存パッケージのStableバージョンを確認する
4
+ ---
5
+
6
+ # バージョン確認
7
+
8
+ このコマンドは、プロジェクトの依存パッケージのバージョンを確認し、Stable/LTSバージョンの使用を推奨します。
9
+
10
+ ## サブエージェント呼び出し
11
+
12
+ **重要**: このコマンドは `stable-version-auditor` サブエージェントを使用します。
13
+
14
+ stable-version-auditor サブエージェントを使用して、依存パッケージのバージョンを確認してください。
15
+
16
+ ## 確認観点
17
+
18
+ ### 1. Stableバージョンかどうか
19
+ - プロダクション推奨バージョンの使用
20
+ - ベータ版・アルファ版の検出
21
+ - RC(Release Candidate)版の検出
22
+ - nightlyビルドの検出
23
+
24
+ ### 2. LTSバージョンの確認
25
+ - Long Term Support版の利用可否
26
+ - サポート期限の確認
27
+ - セキュリティアップデートの提供状況
28
+
29
+ ### 3. EOL(End of Life)の確認
30
+ - サポート終了済みバージョンの検出
31
+ - セキュリティリスクの評価
32
+ - アップグレードの緊急度判定
33
+
34
+ ## チェック項目
35
+
36
+ ### バージョンステータス分類
37
+
38
+ | ステータス | 説明 | 推奨アクション |
39
+ |-----------|------|---------------|
40
+ | **Stable + LTS** | 安定版かつ長期サポート | 推奨 |
41
+ | **Stable** | 安定版 | 使用可能 |
42
+ | **Latest** | 最新版(安定性未確認) | 慎重に判断 |
43
+ | **Pre-release** | ベータ/RC版 | 本番環境では非推奨 |
44
+ | **EOL** | サポート終了 | 即時アップグレード |
45
+
46
+ ### 技術スタック別の確認項目
47
+
48
+ #### Node.js
49
+ - Node.jsランタイムバージョン
50
+ - npmパッケージのバージョン
51
+ - semverの適切性(^, ~の使い分け)
52
+
53
+ #### Java
54
+ - JDKバージョン
55
+ - Gradleプラグインバージョン
56
+ - ライブラリのMaven Centralステータス
57
+
58
+ #### PHP
59
+ - PHPランタイムバージョン
60
+ - Composerパッケージバージョン
61
+ - 依存関係の競合チェック
62
+
63
+ ## 参照スキル
64
+
65
+ スキル `stable-version` のガイドラインに従ってバージョン確認を実施してください。
66
+
67
+ ## 使用例
68
+
69
+ ```
70
+ /michi:version-audit
71
+ ```
72
+
73
+ コマンド実行後、プロジェクトの依存パッケージを分析し、バージョン状況をレポートします。
74
+
75
+ ## 出力
76
+
77
+ バージョン確認結果は以下の形式で出力されます:
78
+
79
+ 1. **サマリー**: 依存パッケージ数、バージョンステータスの分布
80
+ 2. **EOLパッケージ**: サポート終了済みパッケージ(緊急対応)
81
+ 3. **Pre-releaseパッケージ**: ベータ版等の不安定版
82
+ 4. **推奨アップグレード**: LTS版へのアップグレード候補
83
+ 5. **詳細レポート**: 全パッケージのバージョン情報
84
+
85
+ ## Phase 0.2統合
86
+
87
+ このコマンドはPhase 0.2(設計)での技術選定時に実行することを推奨します。
88
+
89
+ ## 言語設定
90
+
91
+ 出力言語は {{KIRO_DIR}}/project.json の設定に従います。