@sk8metal/michi-cli 0.8.7 → 0.11.0
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 +70 -1
- package/README.md +77 -847
- package/dist/scripts/config/config-schema.d.ts +3 -0
- package/dist/scripts/config/config-schema.d.ts.map +1 -1
- package/dist/scripts/config/config-schema.js +18 -0
- package/dist/scripts/config/config-schema.js.map +1 -1
- package/dist/scripts/phase-runner.js +1 -1
- package/dist/scripts/phase-runner.js.map +1 -1
- package/dist/scripts/utils/multi-repo-validator.d.ts +38 -1
- package/dist/scripts/utils/multi-repo-validator.d.ts.map +1 -1
- package/dist/scripts/utils/multi-repo-validator.js +166 -1
- package/dist/scripts/utils/multi-repo-validator.js.map +1 -1
- package/dist/scripts/utils/tasks-format-validator.js +3 -3
- package/dist/scripts/utils/tasks-format-validator.js.map +1 -1
- package/docs/README.md +20 -83
- package/docs/getting-started/configuration.md +379 -0
- package/docs/getting-started/installation.md +59 -0
- package/docs/getting-started/quick-start.md +76 -0
- package/docs/guides/ai-tools.md +311 -0
- package/docs/guides/atlassian-integration.md +116 -0
- package/docs/guides/claude-code.md +155 -0
- package/docs/guides/multi-repo.md +117 -0
- package/docs/guides/workflow.md +382 -0
- package/docs/reference/ai-commands.md +92 -0
- package/docs/reference/cli.md +756 -0
- package/docs/reference/environment-variables.md +192 -0
- package/docs/troubleshooting.md +543 -0
- package/package.json +1 -1
- package/scripts/__tests__/multi-repo-config-schema.test.ts +106 -0
- package/scripts/__tests__/multi-repo-validator.test.ts +229 -1
- package/scripts/config/config-schema.ts +20 -0
- package/scripts/phase-runner.ts +1 -1
- package/scripts/utils/__tests__/multi-repo-validator.test.ts +159 -1
- package/scripts/utils/multi-repo-validator.ts +210 -1
- package/scripts/utils/tasks-format-validator.ts +3 -3
- package/templates/claude/agents/e2e-first-planner/AGENT.md +1 -1
- package/templates/claude/agents/mermaid-validator/AGENT.md +257 -0
- package/templates/claude/agents/pr-resolver/AGENT.md +15 -3
- package/templates/claude/commands/michi/e2e-plan.md +1 -1
- package/templates/claude/commands/michi/spec-design.md +2 -2
- package/templates/claude/commands/michi/spec-tasks.md +156 -0
- package/templates/claude/commands/michi/test-planning.md +1 -1
- package/templates/claude/commands/michi/validate-design.md +3 -3
- package/templates/claude/commands/michi-multi-repo/impl-all.md +293 -0
- package/templates/claude/commands/michi-multi-repo/propagate-specs.md +284 -0
- package/templates/claude/commands/michi-multi-repo/spec-design.md +66 -3
- package/templates/claude/commands/michi-multi-repo/spec-review.md +261 -0
- package/templates/claude/skills/mermaid-validator/SKILL.md +261 -0
- package/templates/claude-agent/agents/cross-repo-reviewer.md +194 -0
- package/templates/claude-agent/agents/repo-spec-executor.md +113 -0
- package/templates/claude-agent/commands/michi/spec-tasks.md +117 -0
- package/templates/claude-agent/rules/code-size-monitor.md +26 -0
- package/templates/claude-agent/rules/code-size-rules.md +32 -0
- package/templates/codex/AGENTS.override.md +1 -1
- package/templates/codex/rules/README.md +2 -2
- package/templates/cursor/commands/michi/spec-tasks.md +117 -0
- package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md +1 -1
- package/docs/context.md +0 -59
- package/docs/michi-development/contributing/development.md +0 -341
- package/docs/michi-development/contributing/release.md +0 -365
- package/docs/michi-development/design/config-unification.md +0 -733
- package/docs/michi-development/design/design-config-current-state.md +0 -330
- package/docs/michi-development/design/design-config-implementation.md +0 -628
- package/docs/michi-development/design/design-config-migration.md +0 -952
- package/docs/michi-development/design/design-config-security.md +0 -771
- package/docs/michi-development/design/design-config-solution.md +0 -583
- package/docs/michi-development/design/design-config-testing.md +0 -892
- package/docs/michi-development/testing/manual-verification-flow.md +0 -871
- package/docs/michi-development/testing/manual-verification-other-tools.md +0 -1279
- package/docs/michi-development/testing/manual-verification-troubleshooting.md +0 -122
- package/docs/michi-development/testing/pre-publish-checklist.md +0 -560
- package/docs/michi-development/testing-strategy.md +0 -87
- package/docs/plan.md +0 -275
- package/docs/user-guide/getting-started/github-token-setup.md +0 -510
- package/docs/user-guide/getting-started/new-repository-setup.md +0 -704
- package/docs/user-guide/getting-started/quick-start.md +0 -212
- package/docs/user-guide/getting-started/setup.md +0 -819
- package/docs/user-guide/guides/agent-skills-integration.md +0 -222
- package/docs/user-guide/guides/customization.md +0 -537
- package/docs/user-guide/guides/internationalization.md +0 -540
- package/docs/user-guide/guides/migration-guide.md +0 -138
- package/docs/user-guide/guides/multi-project.md +0 -368
- package/docs/user-guide/guides/multi-repo-guide.md +0 -1147
- package/docs/user-guide/guides/phase-automation.md +0 -419
- package/docs/user-guide/guides/workflow.md +0 -584
- package/docs/user-guide/hands-on/README.md +0 -142
- package/docs/user-guide/hands-on/claude-agent-setup.md +0 -597
- package/docs/user-guide/hands-on/claude-setup.md +0 -452
- package/docs/user-guide/hands-on/cursor-setup.md +0 -353
- package/docs/user-guide/hands-on/troubleshooting.md +0 -964
- package/docs/user-guide/hands-on/verification-checklist.md +0 -439
- package/docs/user-guide/hands-on/workflow-walkthrough.md +0 -909
- package/docs/user-guide/reference/config.md +0 -589
- package/docs/user-guide/reference/multi-repo-api.md +0 -771
- package/docs/user-guide/reference/quick-reference.md +0 -297
- package/docs/user-guide/reference/security-test-payloads.md +0 -50
- package/docs/user-guide/reference/tasks-template.md +0 -550
- package/docs/user-guide/release/ci-setup-java.md +0 -114
- package/docs/user-guide/release/ci-setup-nodejs.md +0 -94
- package/docs/user-guide/release/ci-setup-php.md +0 -102
- package/docs/user-guide/release/ci-setup-troubleshooting.md +0 -94
- package/docs/user-guide/release/ci-setup.md +0 -188
- package/docs/user-guide/release/release-flow.md +0 -476
- package/docs/user-guide/templates/test-specs/README.md +0 -173
- package/docs/user-guide/templates/test-specs/e2e-test-spec-template.md +0 -553
- package/docs/user-guide/templates/test-specs/integration-test-spec-template.md +0 -435
- package/docs/user-guide/templates/test-specs/performance-test-spec-template.md +0 -454
- package/docs/user-guide/templates/test-specs/security-test-spec-template.md +0 -625
- package/docs/user-guide/templates/test-specs/unit-test-spec-template.md +0 -328
- package/docs/user-guide/testing/integration-tests.md +0 -312
- package/docs/user-guide/testing/tdd-cycle.md +0 -349
- package/docs/user-guide/testing/test-execution-flow.md +0 -396
- package/docs/user-guide/testing/test-failure-handling.md +0 -521
- package/docs/user-guide/testing/test-planning-flow.md +0 -185
- package/docs/user-guide/testing-strategy.md +0 -185
- package/docs/verification-guide.md +0 -518
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: repo-spec-executor
|
|
3
|
+
description: 個別リポジトリで仕様コマンド(/kiro:*, /michi:*)を実行。Multi-Repoプロジェクトから各リポジトリへの仕様展開時にPROACTIVELY使用
|
|
4
|
+
tools: Read, Write, Edit, Bash, Glob, Grep, Skill
|
|
5
|
+
model: sonnet
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Repository Specification Executor
|
|
9
|
+
|
|
10
|
+
あなたはMulti-Repoプロジェクトの個別リポジトリで仕様コマンドを実行する専門エージェントです。
|
|
11
|
+
|
|
12
|
+
## 役割
|
|
13
|
+
|
|
14
|
+
Multi-Repo管理リポジトリから指示を受け、個別のリポジトリ(localPath)に移動して仕様関連コマンドを実行します。
|
|
15
|
+
|
|
16
|
+
## 実行手順
|
|
17
|
+
|
|
18
|
+
### 1. 作業ディレクトリ移動と確認
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
cd {{LOCAL_PATH}}
|
|
22
|
+
pwd
|
|
23
|
+
git status
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
**重要**: 必ず作業ディレクトリを確認し、正しいリポジトリにいることを検証してください。
|
|
27
|
+
|
|
28
|
+
### 2. Michi初期化(必要に応じて)
|
|
29
|
+
|
|
30
|
+
`.michi/config.json`が存在しない場合:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
michi init
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### 3. 仕様コマンド実行
|
|
37
|
+
|
|
38
|
+
親プロジェクトから指定された OPERATION に応じて、以下のコマンドを実行します:
|
|
39
|
+
|
|
40
|
+
#### OPERATION=init
|
|
41
|
+
```
|
|
42
|
+
/kiro:spec-init "{{FEATURE_NAME}}"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
#### OPERATION=requirements
|
|
46
|
+
```
|
|
47
|
+
/kiro:spec-requirements {{FEATURE_NAME}}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
#### OPERATION=design
|
|
51
|
+
```
|
|
52
|
+
/kiro:spec-design {{FEATURE_NAME}}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
#### OPERATION=impl
|
|
56
|
+
```
|
|
57
|
+
/michi:spec-impl {{FEATURE_NAME}}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### 4. 結果レポート
|
|
61
|
+
|
|
62
|
+
以下の情報を親プロジェクトにレポートしてください:
|
|
63
|
+
|
|
64
|
+
**成功時**:
|
|
65
|
+
- 生成されたファイル一覧
|
|
66
|
+
- ファイルの概要(行数、主要セクション)
|
|
67
|
+
- 次のステップの提案
|
|
68
|
+
|
|
69
|
+
**失敗時**:
|
|
70
|
+
- エラーメッセージ
|
|
71
|
+
- 失敗したステップ
|
|
72
|
+
- 推奨される対処方法
|
|
73
|
+
|
|
74
|
+
## 制約と注意事項
|
|
75
|
+
|
|
76
|
+
1. **整合性の維持**: 親Multi-Repoプロジェクトの要件・設計との整合性を必ず維持してください
|
|
77
|
+
|
|
78
|
+
2. **責務範囲**: このリポジトリの責務範囲のみを設計・実装してください。他リポジトリの責務に踏み込まないように注意してください
|
|
79
|
+
|
|
80
|
+
3. **連携ポイントの明確化**: 他リポジトリとの連携が必要な場合、APIエンドポイント、イベントスキーマ、データモデルを明確に記述してください
|
|
81
|
+
|
|
82
|
+
4. **親プロジェクト参照**: 設計時は以下のファイルを参照してください:
|
|
83
|
+
- `docs/michi/{{PARENT_PROJECT}}/overview/requirements.md`
|
|
84
|
+
- `docs/michi/{{PARENT_PROJECT}}/overview/architecture.md`
|
|
85
|
+
|
|
86
|
+
## 出力例
|
|
87
|
+
|
|
88
|
+
```markdown
|
|
89
|
+
## 実行結果: Repository {{REPO_NAME}}
|
|
90
|
+
|
|
91
|
+
**OPERATION**: design
|
|
92
|
+
**FEATURE**: user-authentication
|
|
93
|
+
**STATUS**: ✅ 成功
|
|
94
|
+
|
|
95
|
+
### 生成されたファイル
|
|
96
|
+
|
|
97
|
+
1. `.kiro/specs/user-authentication/design.md` (320行)
|
|
98
|
+
- システムコンテキスト図
|
|
99
|
+
- コンポーネント設計
|
|
100
|
+
- API定義: POST /api/v1/auth/login
|
|
101
|
+
- データモデル: User, Session
|
|
102
|
+
|
|
103
|
+
### 親プロジェクトとの整合性
|
|
104
|
+
|
|
105
|
+
- ✅ API契約: 親プロジェクトの architecture.md と一致
|
|
106
|
+
- ✅ データモデル: 共通エンティティ User を使用
|
|
107
|
+
- ✅ セキュリティ: JWT認証方式で統一
|
|
108
|
+
|
|
109
|
+
### 次のステップ
|
|
110
|
+
|
|
111
|
+
- `/michi:spec-tasks user-authentication` でタスク生成
|
|
112
|
+
- または `/michi:spec-impl user-authentication` で実装開始
|
|
113
|
+
```
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: /michi:spec-tasks
|
|
3
|
+
description: Generate implementation tasks with JIRA sync option (Michi version)
|
|
4
|
+
allowed-tools: Read, Write, Edit, MultiEdit, Glob, Grep, Bash
|
|
5
|
+
argument-hint: <feature-name> [-y] [--sequential]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Michi: Spec Tasks with JIRA Sync Option
|
|
9
|
+
|
|
10
|
+
## Base Command Reference
|
|
11
|
+
@.claude/commands/kiro/spec-tasks.md
|
|
12
|
+
|
|
13
|
+
## Development Guidelines
|
|
14
|
+
{{DEV_GUIDELINES}}
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Michi Extension: JIRA Sync Prompt
|
|
19
|
+
|
|
20
|
+
このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、タスク生成完了後にJIRA同期オプションを提示します。
|
|
21
|
+
|
|
22
|
+
### 機能追加内容
|
|
23
|
+
|
|
24
|
+
1. **タスク生成完了後の次ステップ案内**:
|
|
25
|
+
- JIRA連携が設定されている場合: JIRA同期の選択肢(A/B/C形式)を表示
|
|
26
|
+
- JIRA連携が未設定の場合: 実装フェーズへの案内 + JIRA設定ヒントを表示
|
|
27
|
+
|
|
28
|
+
2. **環境変数による条件分岐**:
|
|
29
|
+
- 以下の環境変数がすべて設定されている場合のみ、JIRA同期の選択肢を表示
|
|
30
|
+
- `ATLASSIAN_URL`
|
|
31
|
+
- `ATLASSIAN_EMAIL`
|
|
32
|
+
- `ATLASSIAN_API_TOKEN`
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## タスク生成完了後のフロー
|
|
37
|
+
|
|
38
|
+
基底コマンド `/kiro:spec-tasks` によるタスク生成が完了した後、以下のフローを実行してください:
|
|
39
|
+
|
|
40
|
+
### Step 1: 環境変数チェック
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# JIRA連携の環境変数をチェック
|
|
44
|
+
if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
|
|
45
|
+
JIRA_CONFIGURED=true
|
|
46
|
+
else
|
|
47
|
+
JIRA_CONFIGURED=false
|
|
48
|
+
fi
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Step 2a: JIRA連携が設定されている場合の表示
|
|
52
|
+
|
|
53
|
+
`JIRA_CONFIGURED=true` の場合、以下のメッセージと選択肢を表示:
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
============================================
|
|
57
|
+
タスク生成完了 - JIRA同期オプション
|
|
58
|
+
============================================
|
|
59
|
+
|
|
60
|
+
次のアクション:
|
|
61
|
+
A) JIRAにタスクを同期する(推奨: タスク管理を一元化)
|
|
62
|
+
→ `michi jira:sync {{FEATURE_NAME}}` を実行
|
|
63
|
+
|
|
64
|
+
B) JIRAへの同期をスキップして実装に進む
|
|
65
|
+
→ `/michi:spec-impl {{FEATURE_NAME}}` を実行
|
|
66
|
+
|
|
67
|
+
C) 何もせずにこのまま終了する
|
|
68
|
+
|
|
69
|
+
選択 (A/B/C): _
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**選択肢の説明**:
|
|
73
|
+
- **A**: Epic/Story/Subtaskを自動作成し、タスクをJIRAに同期します
|
|
74
|
+
- **B**: JIRA同期をスキップして直接TDD実装フェーズに進みます
|
|
75
|
+
- **C**: タスク生成のみで終了し、ユーザーが手動で次のステップを選択します
|
|
76
|
+
|
|
77
|
+
### Step 2b: JIRA連携が未設定の場合の表示
|
|
78
|
+
|
|
79
|
+
`JIRA_CONFIGURED=false` の場合、以下のメッセージを表示:
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
============================================
|
|
83
|
+
タスク生成完了
|
|
84
|
+
============================================
|
|
85
|
+
|
|
86
|
+
次のステップ:
|
|
87
|
+
→ `/michi:spec-impl {{FEATURE_NAME}}` で実装を開始
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
ℹ️ ヒント: JIRA連携を使用すると、タスクを自動的にJIRAに同期できます。
|
|
91
|
+
|
|
92
|
+
設定方法: 以下の環境変数を .env に追加してください:
|
|
93
|
+
- ATLASSIAN_URL=https://your-domain.atlassian.net
|
|
94
|
+
- ATLASSIAN_EMAIL=your-email@company.com
|
|
95
|
+
- ATLASSIAN_API_TOKEN=your-api-token
|
|
96
|
+
|
|
97
|
+
詳細はドキュメントを参照: docs/guides/atlassian-integration.md
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 実装上の注意点
|
|
103
|
+
|
|
104
|
+
1. **基底コマンドの実行結果を維持**:
|
|
105
|
+
- `/kiro:spec-tasks` の「Output Description」セクションで出力されるタスクサマリーは維持してください
|
|
106
|
+
- Michi Extensionの選択肢はその**後**に追加で表示します
|
|
107
|
+
|
|
108
|
+
2. **言語設定の考慮**:
|
|
109
|
+
- メッセージは日本語固定(将来的にspec.jsonの言語設定に対応する可能性あり)
|
|
110
|
+
|
|
111
|
+
3. **ユーザーインタラクション**:
|
|
112
|
+
- 選択肢を表示した後、ユーザーの入力を待ちます
|
|
113
|
+
- 選択に応じて適切なコマンド/処理を案内または実行してください
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、Phase 0.6(JIRA同期)への誘導を Next Phase として案内します。これにより、タスク分割からJIRA連携へのスムーズな移行を実現します。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
globs:
|
|
3
|
+
- "src/**/*"
|
|
4
|
+
- "scripts/**/*"
|
|
5
|
+
- "test/**/*"
|
|
6
|
+
- "tests/**/*"
|
|
7
|
+
alwaysApply: false
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Code Generation Size Monitoring
|
|
11
|
+
|
|
12
|
+
PROACTIVELY: /michi:spec-impl の各タスク完了後に使用。
|
|
13
|
+
|
|
14
|
+
## Reference
|
|
15
|
+
@templates/claude-agent/rules/code-size-rules.md
|
|
16
|
+
|
|
17
|
+
## Execution Timing
|
|
18
|
+
1. 各sub-task完了後
|
|
19
|
+
2. コミット前
|
|
20
|
+
3. 長時間のコーディングセッション中(3-5ファイル変更ごと)
|
|
21
|
+
|
|
22
|
+
## Actions on Threshold Exceeded
|
|
23
|
+
500行超過時:
|
|
24
|
+
A) 現在の変更でPRを作成する(推奨)
|
|
25
|
+
B) 作業を続行する(警告付き)
|
|
26
|
+
C) 分割戦略を提案してもらう
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Code Size Rules
|
|
2
|
+
|
|
3
|
+
## Threshold
|
|
4
|
+
|
|
5
|
+
| Metric | Value |
|
|
6
|
+
|--------|-------|
|
|
7
|
+
| Maximum Diff Lines | 500 lines |
|
|
8
|
+
| Warning Threshold | 400 lines |
|
|
9
|
+
|
|
10
|
+
## Target Paths
|
|
11
|
+
- src/
|
|
12
|
+
- scripts/
|
|
13
|
+
- test/
|
|
14
|
+
- tests/
|
|
15
|
+
|
|
16
|
+
## Exclusion Patterns (Lock Files)
|
|
17
|
+
- package-lock.json, yarn.lock, pnpm-lock.yaml
|
|
18
|
+
- composer.lock, Gemfile.lock, poetry.lock, Pipfile.lock
|
|
19
|
+
- Cargo.lock, go.sum
|
|
20
|
+
|
|
21
|
+
## Exclusion Patterns (Generated Files)
|
|
22
|
+
- *.min.js, *.min.css, *.map
|
|
23
|
+
- dist/*, build/*, coverage/*, .next/*
|
|
24
|
+
- *.d.ts, *.generated.ts, `__snapshots__/*`
|
|
25
|
+
|
|
26
|
+
## Status Indicators
|
|
27
|
+
|
|
28
|
+
| Status | Condition |
|
|
29
|
+
|--------|-----------|
|
|
30
|
+
| ✅ OK | diff < 400 lines |
|
|
31
|
+
| ⚠️ Warning | 400 <= diff < 500 lines |
|
|
32
|
+
| ❌ Exceeded | diff >= 500 lines |
|
|
@@ -44,7 +44,7 @@ npx @sk8metal/michi-cli setup-existing --codex --lang ja
|
|
|
44
44
|
| `/kiro:spec-init` | 新規仕様フォルダ初期化 |
|
|
45
45
|
| `/kiro:spec-requirements` | 要件定義書作成(EARS形式) |
|
|
46
46
|
| `/kiro:spec-design` | 設計ドキュメント作成 |
|
|
47
|
-
| `/
|
|
47
|
+
| `/michi:spec-tasks` | タスク分割(並列実行可能) |
|
|
48
48
|
| `/kiro:spec-impl` | TDDベース実装 |
|
|
49
49
|
| `/kiro:spec-status` | ワークフロー進捗確認 |
|
|
50
50
|
| `/kiro:validate-gap` | 既存コードとのギャップ分析 |
|
|
@@ -82,7 +82,7 @@ npx @sk8metal/michi-cli setup-existing --codex --lang ja
|
|
|
82
82
|
|
|
83
83
|
### 4. 実装
|
|
84
84
|
```bash
|
|
85
|
-
/
|
|
85
|
+
/michi:spec-tasks FEATURE=user-authentication
|
|
86
86
|
/kiro:spec-impl FEATURE=user-authentication
|
|
87
87
|
```
|
|
88
88
|
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: /michi:spec-tasks
|
|
3
|
+
description: Generate implementation tasks with JIRA sync option (Michi version)
|
|
4
|
+
allowed-tools: Read, Write, Edit, MultiEdit, Glob, Grep, Bash
|
|
5
|
+
argument-hint: <feature-name> [-y] [--sequential]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Michi: Spec Tasks with JIRA Sync Option
|
|
9
|
+
|
|
10
|
+
## Base Command Reference
|
|
11
|
+
@.claude/commands/kiro/spec-tasks.md
|
|
12
|
+
|
|
13
|
+
## Development Guidelines
|
|
14
|
+
{{DEV_GUIDELINES}}
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Michi Extension: JIRA Sync Prompt
|
|
19
|
+
|
|
20
|
+
このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、タスク生成完了後にJIRA同期オプションを提示します。
|
|
21
|
+
|
|
22
|
+
### 機能追加内容
|
|
23
|
+
|
|
24
|
+
1. **タスク生成完了後の次ステップ案内**:
|
|
25
|
+
- JIRA連携が設定されている場合: JIRA同期の選択肢(A/B/C形式)を表示
|
|
26
|
+
- JIRA連携が未設定の場合: 実装フェーズへの案内 + JIRA設定ヒントを表示
|
|
27
|
+
|
|
28
|
+
2. **環境変数による条件分岐**:
|
|
29
|
+
- 以下の環境変数がすべて設定されている場合のみ、JIRA同期の選択肢を表示
|
|
30
|
+
- `ATLASSIAN_URL`
|
|
31
|
+
- `ATLASSIAN_EMAIL`
|
|
32
|
+
- `ATLASSIAN_API_TOKEN`
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## タスク生成完了後のフロー
|
|
37
|
+
|
|
38
|
+
基底コマンド `/kiro:spec-tasks` によるタスク生成が完了した後、以下のフローを実行してください:
|
|
39
|
+
|
|
40
|
+
### Step 1: 環境変数チェック
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# JIRA連携の環境変数をチェック
|
|
44
|
+
if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
|
|
45
|
+
JIRA_CONFIGURED=true
|
|
46
|
+
else
|
|
47
|
+
JIRA_CONFIGURED=false
|
|
48
|
+
fi
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Step 2a: JIRA連携が設定されている場合の表示
|
|
52
|
+
|
|
53
|
+
`JIRA_CONFIGURED=true` の場合、以下のメッセージと選択肢を表示:
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
============================================
|
|
57
|
+
タスク生成完了 - JIRA同期オプション
|
|
58
|
+
============================================
|
|
59
|
+
|
|
60
|
+
次のアクション:
|
|
61
|
+
A) JIRAにタスクを同期する(推奨: タスク管理を一元化)
|
|
62
|
+
→ `michi jira:sync {{FEATURE_NAME}}` を実行
|
|
63
|
+
|
|
64
|
+
B) JIRAへの同期をスキップして実装に進む
|
|
65
|
+
→ `/michi:spec-impl {{FEATURE_NAME}}` を実行
|
|
66
|
+
|
|
67
|
+
C) 何もせずにこのまま終了する
|
|
68
|
+
|
|
69
|
+
選択 (A/B/C): _
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**選択肢の説明**:
|
|
73
|
+
- **A**: Epic/Story/Subtaskを自動作成し、タスクをJIRAに同期します
|
|
74
|
+
- **B**: JIRA同期をスキップして直接TDD実装フェーズに進みます
|
|
75
|
+
- **C**: タスク生成のみで終了し、ユーザーが手動で次のステップを選択します
|
|
76
|
+
|
|
77
|
+
### Step 2b: JIRA連携が未設定の場合の表示
|
|
78
|
+
|
|
79
|
+
`JIRA_CONFIGURED=false` の場合、以下のメッセージを表示:
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
============================================
|
|
83
|
+
タスク生成完了
|
|
84
|
+
============================================
|
|
85
|
+
|
|
86
|
+
次のステップ:
|
|
87
|
+
→ `/michi:spec-impl {{FEATURE_NAME}}` で実装を開始
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
ℹ️ ヒント: JIRA連携を使用すると、タスクを自動的にJIRAに同期できます。
|
|
91
|
+
|
|
92
|
+
設定方法: 以下の環境変数を .env に追加してください:
|
|
93
|
+
- ATLASSIAN_URL=https://your-domain.atlassian.net
|
|
94
|
+
- ATLASSIAN_EMAIL=your-email@company.com
|
|
95
|
+
- ATLASSIAN_API_TOKEN=your-api-token
|
|
96
|
+
|
|
97
|
+
詳細はドキュメントを参照: docs/guides/atlassian-integration.md
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 実装上の注意点
|
|
103
|
+
|
|
104
|
+
1. **基底コマンドの実行結果を維持**:
|
|
105
|
+
- `/kiro:spec-tasks` の「Output Description」セクションで出力されるタスクサマリーは維持してください
|
|
106
|
+
- Michi Extensionの選択肢はその**後**に追加で表示します
|
|
107
|
+
|
|
108
|
+
2. **言語設定の考慮**:
|
|
109
|
+
- メッセージは日本語固定(将来的にspec.jsonの言語設定に対応する可能性あり)
|
|
110
|
+
|
|
111
|
+
3. **ユーザーインタラクション**:
|
|
112
|
+
- 選択肢を表示した後、ユーザーの入力を待ちます
|
|
113
|
+
- 選択に応じて適切なコマンド/処理を案内または実行してください
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、Phase 0.6(JIRA同期)への誘導を Next Phase として案内します。これにより、タスク分割からJIRA連携へのスムーズな移行を実現します。
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
設計が承認された場合(GO Decision):
|
|
45
45
|
1. Phase 0.3: テストタイプの選択を実施
|
|
46
46
|
2. Phase 0.4: テスト仕様書の作成を実施
|
|
47
|
-
3. Phase 0.5: タスク分割(`/
|
|
47
|
+
3. Phase 0.5: タスク分割(`/michi:spec-tasks`)に進む
|
|
48
48
|
|
|
49
49
|
詳細は [テスト計画フロー](docs/user-guide/testing/test-planning-flow.md) を参照してください。
|
|
50
50
|
|
package/docs/context.md
DELETED
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
# プロジェクトコンテキスト
|
|
2
|
-
|
|
3
|
-
## 現在のタスク
|
|
4
|
-
Issue #58: テンプレートディレクトリ名の整合性修正
|
|
5
|
-
|
|
6
|
-
## 進捗状況
|
|
7
|
-
- **開始日時**: 2025-11-17 (月)
|
|
8
|
-
- **現在フェーズ**: Phase 0 - 計画策定
|
|
9
|
-
- **完了率**: 0%
|
|
10
|
-
|
|
11
|
-
## タスク概要
|
|
12
|
-
|
|
13
|
-
### Issue #58: テンプレートディレクトリ名の不整合修正
|
|
14
|
-
- **優先度**: 低(技術的負債)
|
|
15
|
-
- **工数**: 0.5h(予想)
|
|
16
|
-
- **ステータス**: 🔄 進行中
|
|
17
|
-
|
|
18
|
-
## 問題の詳細
|
|
19
|
-
|
|
20
|
-
### 現状
|
|
21
|
-
- **テンプレートソース**: `templates/claude-agent/rules/`
|
|
22
|
-
- **配置先**: `.claude/subagents`
|
|
23
|
-
|
|
24
|
-
`rules`という名前のディレクトリが`subagents`という名前で配置されるため、新規開発者にとって混乱を招く。
|
|
25
|
-
|
|
26
|
-
### 影響範囲
|
|
27
|
-
- **重大度**: 低(機能的には動作している)
|
|
28
|
-
- **保守性**: 中(新規開発者への混乱)
|
|
29
|
-
- **リスク**: 低(テンプレートコピーロジックのみに限定)
|
|
30
|
-
|
|
31
|
-
### 推奨解決策
|
|
32
|
-
**Option 1** (推奨): テンプレートディレクトリをリネーム
|
|
33
|
-
- `templates/claude-agent/rules/` → `templates/claude-agent/subagents/`
|
|
34
|
-
- シンプルで明確、一貫性がある
|
|
35
|
-
|
|
36
|
-
**Option 2**: 柔軟なテンプレート命名をサポート
|
|
37
|
-
- `EnvironmentConfig`に`rulesDirTemplateName`を追加
|
|
38
|
-
- より柔軟だが複雑性が増す
|
|
39
|
-
|
|
40
|
-
## 影響ファイル
|
|
41
|
-
- `templates/claude-agent/rules/` (リネーム対象)
|
|
42
|
-
- `src/commands/setup-existing.ts` (変数名を確認)
|
|
43
|
-
|
|
44
|
-
## 前提条件
|
|
45
|
-
- Issue #55, #56は完了済み
|
|
46
|
-
- 全テストスイート成功(235 passed)
|
|
47
|
-
|
|
48
|
-
## 完了条件
|
|
49
|
-
- [ ] テンプレートディレクトリを`subagents`にリネーム
|
|
50
|
-
- [ ] 全テストスイート成功
|
|
51
|
-
- [ ] Lintエラーなし
|
|
52
|
-
- [ ] ドキュメント更新(必要に応じて)
|
|
53
|
-
|
|
54
|
-
## メモ
|
|
55
|
-
- TDD原則を遵守(既存テストで動作確認)
|
|
56
|
-
- Option 1(リネームのみ)を採用予定
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
最終更新: 2025-11-17 (月) - Issue #58開始
|