@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.
Files changed (46) hide show
  1. package/CHANGELOG.md +86 -0
  2. package/README.md +27 -8
  3. package/dist/src/commands/setup-existing.d.ts.map +1 -1
  4. package/dist/src/commands/setup-existing.js +19 -74
  5. package/dist/src/commands/setup-existing.js.map +1 -1
  6. package/package.json +1 -1
  7. package/templates/claude/agents/design-reviewer/AGENT.md +0 -497
  8. package/templates/claude/agents/e2e-first-planner/AGENT.md +0 -410
  9. package/templates/claude/agents/mermaid-validator/AGENT.md +0 -257
  10. package/templates/claude/agents/oss-license-checker/AGENT.md +0 -265
  11. package/templates/claude/agents/pr-resolver/AGENT.md +0 -208
  12. package/templates/claude/agents/pr-size-monitor/AGENT.md +0 -330
  13. package/templates/claude/agents/stable-version-auditor/AGENT.md +0 -279
  14. package/templates/claude/commands/kiro/kiro-spec-impl.md +0 -257
  15. package/templates/claude/commands/kiro/kiro-spec-tasks.md +0 -370
  16. package/templates/claude/commands/michi/confluence-sync.md +0 -44
  17. package/templates/claude/commands/michi/design-review.md +0 -70
  18. package/templates/claude/commands/michi/e2e-plan.md +0 -117
  19. package/templates/claude/commands/michi/license-check.md +0 -84
  20. package/templates/claude/commands/michi/pr-resolve.md +0 -157
  21. package/templates/claude/commands/michi/project-switch.md +0 -42
  22. package/templates/claude/commands/michi/spec-design.md +0 -78
  23. package/templates/claude/commands/michi/spec-impl.md +0 -889
  24. package/templates/claude/commands/michi/spec-tasks.md +0 -156
  25. package/templates/claude/commands/michi/test-planning.md +0 -174
  26. package/templates/claude/commands/michi/validate-design.md +0 -58
  27. package/templates/claude/commands/michi/version-audit.md +0 -95
  28. package/templates/claude/commands/michi-multi-repo/impl-all.md +0 -293
  29. package/templates/claude/commands/michi-multi-repo/propagate-specs.md +0 -284
  30. package/templates/claude/commands/michi-multi-repo/spec-design.md +0 -359
  31. package/templates/claude/commands/michi-multi-repo/spec-init.md +0 -228
  32. package/templates/claude/commands/michi-multi-repo/spec-requirements.md +0 -198
  33. package/templates/claude/commands/michi-multi-repo/spec-review.md +0 -261
  34. package/templates/claude/rules/atlassian-integration.md +0 -35
  35. package/templates/claude/rules/michi-core.md +0 -54
  36. package/templates/claude/skills/design-review/SKILL.md +0 -648
  37. package/templates/claude/skills/e2e-first-planning/SKILL.md +0 -360
  38. package/templates/claude/skills/mermaid-validator/SKILL.md +0 -261
  39. package/templates/claude/skills/oss-license/SKILL.md +0 -232
  40. package/templates/claude/skills/stable-version/SKILL.md +0 -252
  41. package/templates/claude-agent/rules/code-size-monitor.md +0 -26
  42. package/templates/claude-agent/rules/code-size-rules.md +0 -32
  43. package/templates/michi/cc-sdd-overrides/README.md +0 -58
  44. package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md +0 -53
  45. package/templates/michi/cc-sdd-overrides/settings/templates/specs/init.json +0 -24
  46. package/templates/michi/cc-sdd-overrides/settings/templates/specs/tasks.md +0 -446
@@ -1,70 +0,0 @@
1
- ---
2
- name: /michi:design-review
3
- description: UIコンポーネントのデザイン品質をレビューする
4
- ---
5
-
6
- # デザインレビュー
7
-
8
- ## Development Guidelines
9
-
10
- {{DEV_GUIDELINES}}
11
-
12
- このコマンドは、UIコンポーネントやフロントエンドコードのデザイン品質をレビューします。
13
-
14
- ## サブエージェント呼び出し
15
-
16
- **重要**: このコマンドは `design-reviewer` サブエージェントを使用します。
17
-
18
- design-reviewer サブエージェントを使用して、以下のデザイン品質をレビューしてください。
19
-
20
- ## レビュー観点
21
-
22
- ### 1. アクセシビリティ(a11y)
23
- - WCAG 2.1 ガイドラインへの準拠
24
- - キーボード操作のサポート
25
- - スクリーンリーダー対応
26
- - カラーコントラスト比の確認
27
- - フォーカスインジケーターの視認性
28
-
29
- ### 2. レスポンシブデザイン
30
- - モバイル、タブレット、デスクトップでの表示確認
31
- - ブレークポイントの適切性
32
- - フレキシブルレイアウトの実装
33
- - タッチターゲットのサイズ(最小44x44px)
34
-
35
- ### 3. デザインシステムとの整合性
36
- - カラーパレットの使用
37
- - タイポグラフィの統一
38
- - スペーシングの一貫性
39
- - コンポーネントの再利用
40
-
41
- ### 4. UXベストプラクティス
42
- - ユーザーフィードバックの適切性
43
- - エラーメッセージの明確性
44
- - ローディング状態の表示
45
- - 操作の直感性
46
-
47
- ## 参照スキル
48
-
49
- スキル `design-review` のガイドラインに従ってレビューを実施してください。
50
-
51
- ## 使用例
52
-
53
- ```
54
- /michi:design-review
55
- ```
56
-
57
- コマンド実行後、現在のプロジェクトのUIコンポーネントをレビューし、改善提案を行います。
58
-
59
- ## 出力
60
-
61
- レビュー結果は以下の形式で出力されます:
62
-
63
- 1. **レビューサマリー**: 全体的な評価
64
- 2. **問題点**: 発見された問題のリスト(優先度付き)
65
- 3. **改善提案**: 具体的な改善策
66
- 4. **参考資料**: 関連するベストプラクティスへのリンク
67
-
68
- ## 言語設定
69
-
70
- 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -1,117 +0,0 @@
1
- ---
2
- name: /michi:e2e-plan
3
- description: E2Eファースト方式でタスク分割を計画する
4
- ---
5
-
6
- # E2Eプランニング
7
-
8
- ## Development Guidelines
9
-
10
- {{DEV_GUIDELINES}}
11
-
12
- このコマンドは、E2Eファースト方式でタスク分割を計画し、早期に動作確認可能な実装計画を策定します。
13
-
14
- ## サブエージェント呼び出し
15
-
16
- **重要**: このコマンドは `e2e-first-planner` サブエージェントを使用します。
17
-
18
- e2e-first-planner サブエージェントを使用して、E2Eファースト方式でタスク分割を計画してください。
19
-
20
- ## 計画方針
21
-
22
- ### 1. ミニマム動作確認可能な単位を最優先
23
- - 最小構成での動作確認
24
- - 早期フィードバックの獲得
25
- - リスクの早期発見
26
- - 段階的な機能拡張
27
-
28
- ### 2. E2Eテスト可能なマイルストーンを設定
29
- - ユーザーストーリーベースのマイルストーン
30
- - 各マイルストーンでE2Eテストを実施
31
- - 統合テストを早期に開始
32
- - 継続的なデプロイ可能性の維持
33
-
34
- ### 3. 結合テストを早期に実施
35
- - コンポーネント間の連携確認
36
- - API統合の早期テスト
37
- - データフローの検証
38
- - 外部サービス連携の確認
39
-
40
- ## E2Eファースト開発の原則
41
-
42
- ### Walking Skeleton(歩く骨格)アプローチ
43
- 1. **最小限の機能実装**: 画面からDBまで一連の流れを実装
44
- 2. **デプロイパイプライン構築**: CI/CD環境を最初に整備
45
- 3. **段階的拡張**: 機能を少しずつ追加していく
46
-
47
- ### タスク分割の優先順位
48
-
49
- | 優先度 | タスクタイプ | 理由 |
50
- |--------|-------------|------|
51
- | **最優先** | E2E動作確認 | 全体の動作を早期確認 |
52
- | **高** | 統合ポイント | 連携部分のリスク高 |
53
- | **中** | 個別機能 | 独立して実装可能 |
54
- | **低** | UI改善・最適化 | 動作確認後に実施 |
55
-
56
- ## 計画に含める項目
57
-
58
- ### 1. マイルストーン定義
59
- ```markdown
60
- ## Milestone 1: 基本フロー(E2E)
61
- - [ ] ユーザー登録画面
62
- - [ ] 認証API
63
- - [ ] DBスキーマ
64
- - [ ] E2Eテスト: 新規ユーザー登録
65
-
66
- ## Milestone 2: コア機能(E2E)
67
- - [ ] ダッシュボード画面
68
- - [ ] データ取得API
69
- - [ ] データ表示機能
70
- - [ ] E2Eテスト: ログイン→ダッシュボード表示
71
- ```
72
-
73
- ### 2. 依存関係の明示
74
- - 前提条件となるタスク
75
- - 並行実行可能なタスク
76
- - ブロッカーとなる技術的課題
77
-
78
- ### 3. テスト戦略
79
- - E2Eテストシナリオ
80
- - 統合テストポイント
81
- - テストデータの準備
82
-
83
- ## 参照スキル
84
-
85
- スキル `e2e-first-planning` のガイドラインに従ってタスク分割を実施してください。
86
-
87
- ## 使用例
88
-
89
- ```
90
- /michi:e2e-plan
91
- ```
92
-
93
- コマンド実行後、機能要件を分析し、E2Eファースト方式のタスク分割計画を作成します。
94
-
95
- ## 入力情報
96
-
97
- - {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/requirements.md
98
- - {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/design.md
99
-
100
- ## 出力
101
-
102
- E2Eプランニング結果は以下の形式で出力されます:
103
-
104
- 1. **Walking Skeletonの定義**: 最小限の動作確認範囲
105
- 2. **マイルストーン一覧**: E2Eテスト可能な単位
106
- 3. **タスクリスト**: 優先順位付きタスク
107
- 4. **依存関係図**: タスク間の依存関係
108
- 5. **推定工数**: 各タスクの概算工数
109
-
110
- ## Phase 0.5統合
111
-
112
- このコマンドはPhase 0.5(タスク分割)で実行することを推奨します。
113
- `/michi:spec-tasks` コマンドから呼び出すことも可能です。
114
-
115
- ## 言語設定
116
-
117
- 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -1,84 +0,0 @@
1
- ---
2
- name: /michi:license-check
3
- description: 依存パッケージのOSSライセンスを確認する
4
- ---
5
-
6
- # ライセンス確認
7
-
8
- ## Development Guidelines
9
-
10
- {{DEV_GUIDELINES}}
11
-
12
- このコマンドは、プロジェクトの依存パッケージのOSSライセンスを確認し、ライセンス互換性をチェックします。
13
-
14
- ## サブエージェント呼び出し
15
-
16
- **重要**: このコマンドは `oss-license-checker` サブエージェントを使用します。
17
-
18
- oss-license-checker サブエージェントを使用して、依存パッケージのライセンスを確認してください。
19
-
20
- ## 確認対象
21
-
22
- ### 1. 依存関係ファイル
23
- - **Node.js**: package.json、package-lock.json
24
- - **Java**: build.gradle、pom.xml
25
- - **PHP**: composer.json、composer.lock
26
- - **Python**: requirements.txt、Pipfile、pyproject.toml
27
-
28
- ### 2. 新規追加されたライブラリ
29
- - 最新のコミットで追加された依存関係
30
- - バージョンアップされた依存関係
31
- - 間接依存関係(transitive dependencies)
32
-
33
- ### 3. ライセンス互換性チェック
34
- - プロジェクトのライセンスとの互換性
35
- - GPL、LGPL、Apache、MIT、BSD等の確認
36
- - コピーレフト条項の確認
37
- - 商用利用の可否
38
-
39
- ## チェック項目
40
-
41
- ### ライセンスリスク分類
42
-
43
- | リスク | ライセンス例 | 対応 |
44
- |--------|-------------|------|
45
- | **高** | GPL v2/v3、AGPL | 使用前に法務確認必須 |
46
- | **中** | LGPL、MPL | 使用方法を確認 |
47
- | **低** | MIT、Apache 2.0、BSD | 通常使用可能 |
48
-
49
- ### 確認事項
50
- - [ ] ライセンステキストの存在
51
- - [ ] 著作権表示の要件
52
- - [ ] ソースコード公開の要件
53
- - [ ] 特許条項の確認
54
- - [ ] 商用利用の制限
55
-
56
- ## 参照スキル
57
-
58
- スキル `oss-license` のガイドラインに従ってライセンスチェックを実施してください。
59
-
60
- ## 使用例
61
-
62
- ```
63
- /michi:license-check
64
- ```
65
-
66
- コマンド実行後、プロジェクトの依存パッケージを分析し、ライセンス状況をレポートします。
67
-
68
- ## 出力
69
-
70
- ライセンスチェック結果は以下の形式で出力されます:
71
-
72
- 1. **サマリー**: 依存パッケージ数、ライセンスタイプの分布
73
- 2. **高リスクライセンス**: GPL等の注意が必要なライセンス
74
- 3. **不明なライセンス**: ライセンスが特定できないパッケージ
75
- 4. **推奨アクション**: 対応が必要な項目のリスト
76
- 5. **ライセンス一覧**: 全パッケージのライセンス詳細
77
-
78
- ## Phase A統合
79
-
80
- このコマンドはPhase A(PR前自動テスト)で実行することを推奨します。
81
-
82
- ## 言語設定
83
-
84
- 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -1,157 +0,0 @@
1
- ---
2
- name: /michi:pr-resolve
3
- description: PRレビューコメントへの対応を支援する
4
- ---
5
-
6
- # PRコメント対応
7
-
8
- ## Development Guidelines
9
-
10
- {{DEV_GUIDELINES}}
11
-
12
- このコマンドは、プルリクエストのレビューコメントへの対応を支援し、すべてのコメントが適切に解決されているか確認します。
13
-
14
- ## サブエージェント呼び出し
15
-
16
- **重要**: このコマンドは `pr-resolver` サブエージェントを使用します。
17
-
18
- pr-resolver サブエージェントを使用して、PRレビューコメントへの対応を確認してください。
19
-
20
- ## 確認項目
21
-
22
- ### 1. コメントの収集
23
- - GitHub PR APIを使用してコメント取得
24
- - レビュー承認/変更要求の確認
25
- - 未解決コメントのリスト化
26
- - 返信済みコメントの確認
27
-
28
- ### 2. 対応状況の確認
29
- - コード変更による対応
30
- - コメントでの返信による対応
31
- - 「Resolve conversation」の実行状況
32
- - 対応漏れの検出
33
-
34
- ### 3. 対応完了の検証
35
- - すべてのコメントへの対応完了
36
- - レビュアーからの再承認の確認
37
- - マージ可能状態の確認
38
-
39
- ## 使用方法
40
-
41
- ### 基本的な使い方
42
-
43
- ```bash
44
- # 現在のブランチのPRコメントを確認
45
- /michi:pr-resolve
46
-
47
- # 特定のPR番号を指定
48
- /michi:pr-resolve 123
49
- ```
50
-
51
- ### GitHub CLI連携
52
-
53
- コマンド内部で以下のGitHub CLIコマンドを使用します:
54
-
55
- ```bash
56
- # PRコメント一覧取得
57
- gh pr view <PR番号> --json comments,reviews
58
-
59
- # PRステータス確認
60
- gh pr status
61
-
62
- # PRコメント表示
63
- gh pr view <PR番号>
64
- ```
65
-
66
- ## 対応フロー
67
-
68
- ### ステップ1: コメント収集
69
- ```markdown
70
- ## 未解決コメント一覧
71
- 1. [ファイル名:行数] レビュアー: コメント内容
72
- 2. [ファイル名:行数] レビュアー: コメント内容
73
- ```
74
-
75
- ### ステップ2: 対応計画
76
- ```markdown
77
- ## 対応計画
78
- - [ ] コメント1: コード修正(認証ロジックの改善)
79
- - [ ] コメント2: 返信のみ(設計意図の説明)
80
- - [ ] コメント3: コード修正(テストケース追加)
81
- ```
82
-
83
- ### ステップ3: 対応実施
84
- - コード修正が必要な箇所を特定
85
- - 修正内容を提案
86
- - コミットメッセージの推奨
87
-
88
- ### ステップ4: 対応完了確認
89
- ```markdown
90
- ## 対応完了レポート
91
- ✓ すべてのコメントに対応済み
92
- ✓ レビュアーから再承認を獲得
93
- ✓ マージ可能状態
94
- ```
95
-
96
- ## 出力
97
-
98
- PRコメント対応結果は以下の形式で出力されます:
99
-
100
- 1. **サマリー**: 総コメント数、未解決数、対応完了数
101
- 2. **未解決コメント詳細**: 各コメントの内容と推奨対応
102
- 3. **対応済みコメント**: すでに解決済みのコメント
103
- 4. **次のアクション**: マージ前に必要な作業
104
-
105
- ## Phase A統合
106
-
107
- このコマンドはPhase A(PR前自動テスト)またはレビュー対応時に実行することを推奨します。
108
-
109
- ## GitHub CLI必須
110
-
111
- このコマンドは `gh` コマンド(GitHub CLI)が必要です。
112
- 未インストールの場合は以下でインストールしてください:
113
-
114
- ```bash
115
- # macOS
116
- brew install gh
117
-
118
- # 認証
119
- gh auth login
120
- ```
121
-
122
- ## 環境変数
123
-
124
- GitHubトークンが必要な場合は、以下の環境変数を設定してください:
125
-
126
- ```bash
127
- export GITHUB_TOKEN="your_token_here"
128
- ```
129
-
130
- ## 使用例
131
-
132
- ### PRレビュー対応の完全フロー
133
-
134
- ```bash
135
- # 1. PRコメントを確認
136
- /michi:pr-resolve
137
-
138
- # 2. コメントに基づいてコード修正
139
- # (Claude Codeが修正を提案)
140
-
141
- # 3. 変更をコミット
142
- git add .
143
- git commit -m "fix: レビューコメントに対応"
144
-
145
- # 4. PRを更新
146
- git push
147
-
148
- # 5. 再度確認
149
- /michi:pr-resolve
150
-
151
- # 6. すべて解決済みならマージ
152
- gh pr merge
153
- ```
154
-
155
- ## 言語設定
156
-
157
- 出力言語は {{KIRO_DIR}}/project.json の設定に従います。
@@ -1,42 +0,0 @@
1
- ---
2
- name: /michi:project-switch
3
- description: Switch between projects (Michi-specific feature)
4
- ---
5
-
6
- # Project Switch Command
7
-
8
- > **Michi 固有機能**: このコマンドは Michi 独自の機能です。cc-sdd 標準には含まれません。
9
- >
10
- > マルチプロジェクト環境で、異なるプロジェクト間を切り替えるための機能です。
11
-
12
- ## Development Guidelines
13
-
14
- {{DEV_GUIDELINES}}
15
-
16
- ## Usage
17
-
18
- ```
19
- /michi:project-switch <project_id>
20
- ```
21
-
22
- **Parameters**:
23
- - `project_id`: Project ID (e.g., customer-a-service-1, michi)
24
-
25
- **Examples**:
26
- ```
27
- /michi:project-switch michi
28
- /michi:project-switch customer-a-service-1
29
- ```
30
-
31
- ## Execution Steps
32
-
33
- 1. Identify GitHub repository corresponding to project ID
34
- 2. Clone locally (if not cloned) or checkout
35
- 3. Load and display {{KIRO_DIR}}/project.json
36
- 4. Display corresponding Confluence project page URL
37
-
38
- ## Language Handling
39
-
40
- - Read language from {{KIRO_DIR}}/project.json
41
- - Generate all output in the specified language
42
- - Default to English if language field is missing
@@ -1,78 +0,0 @@
1
- ---
2
- name: /michi:spec-design
3
- description: Create comprehensive technical design for a specification (Michi version with test planning flow)
4
- allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch
5
- argument-hint: <feature-name> [-y]
6
- ---
7
-
8
- # Michi: Spec Design with Test Planning Flow
9
-
10
- ## Base Command Reference
11
- @.claude/commands/kiro/spec-design.md
12
-
13
- ## Development Guidelines
14
-
15
- {{DEV_GUIDELINES}}
16
-
17
- ## Michi Extension: Next Phase Guidance
18
-
19
- 設計ドキュメント生成完了後、以下のフローを案内:
20
-
21
- ### Next Phase: Phase 0.3 - テストタイプの選択
22
-
23
- 設計が完了したら、タスク生成前に **Phase 0.3-0.4: テスト計画** を実施してください。
24
-
25
- #### 1. Phase 0.3: テストタイプの選択
26
-
27
- 設計書の Testing Strategy セクションを基に、必要なテストタイプを決定します。
28
-
29
- **実行方法:**
30
-
31
- **推奨: 統合AIコマンド**
32
- ```bash
33
- /michi:test-planning {feature-name}
34
- ```
35
- Phase 0.3とPhase 0.4を統合的に実行します。AIが対話的にテストタイプを選択し、テスト仕様書を作成します。
36
-
37
- **選択可能なテストタイプ:**
38
- - 単体テスト (Unit Test)
39
- - 統合テスト (Integration Test)
40
- - E2Eテスト (End-to-End Test)
41
- - パフォーマンステスト (Performance Test)
42
- - セキュリティテスト (Security Test)
43
-
44
- **参照ドキュメント**: `docs/user-guide/testing/test-planning-flow.md`
45
-
46
- #### 2. Phase 0.4: テスト仕様書の作成
47
-
48
- Phase 0.3で選択したテストタイプに基づいて、テスト仕様書を作成します。
49
-
50
- **実行方法:**
51
-
52
- `/michi:test-planning` を使用した場合、Phase 0.4も自動的に実行されます。
53
-
54
- **テンプレート:**
55
- - 単体テスト: `docs/user-guide/templates/test-specs/unit-test-spec-template.md`
56
- - 統合テスト: `docs/user-guide/templates/test-specs/integration-test-spec-template.md`
57
- - E2Eテスト: `docs/user-guide/templates/test-specs/e2e-test-spec-template.md`
58
- - パフォーマンステスト: `docs/user-guide/templates/test-specs/performance-test-spec-template.md`
59
- - セキュリティテスト: `docs/user-guide/templates/test-specs/security-test-spec-template.md`
60
-
61
- **出力先**: `.kiro/specs/{feature}/test-specs/`
62
-
63
- ### After Test Planning: Task Generation
64
-
65
- Phase 0.3-0.4 完了後、以下のステップに進んでください:
66
-
67
- **推奨フロー**:
68
- 1. `/michi:validate-design {feature}` で設計レビューを実施(任意)
69
- 2. `/michi:spec-tasks {feature}` でタスク生成
70
-
71
- **クイックフロー**:
72
- - `/michi:spec-tasks {feature} -y` で自動承認してタスク生成
73
-
74
- **重要**: テスト計画(Phase 0.3-0.4)を完了してからタスク生成することで、実装タスクにテスト実装が適切に含まれます。
75
-
76
- ---
77
-
78
- **Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-design` を拡張し、Michi 固有のテスト計画フロー(Phase 0.3-0.4)を Next Phase として案内します。