
michi
Michi - AI-driven Spec-Driven Development workflow for Claude Code
- version
- 0.14.1
Install
/plugin install michi@sk8metal-michiRun it inside Claude Code after adding the marketplace with /plugin marketplace add sk8metalme/michi-old.
Contents
Discovered from sourceCommands 24
Multi-Repo Implementation (All Repositories)
<background_information>
- Mission: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
- Success Criteria:
- 全リポジトリでTDD実装サイクルが完了
- テストカバレッジ95%以上
- 品質自動化(Lint/Type-check)パス
- PR作成可能な状態 </background_information>
引数解析
引数の形式:
/michi-multi-repo:impl-all <project-name> [--tasks <task-numbers>]
パラメータ:
- $1: プロジェクト名(必須)
- --tasks: 実行するタスク番号(オプション)
- 例:
--tasks 1,2,3→ タスク1-3のみ実行 - 省略時: 全タスクを実行
- 例:
Execution Steps
Step 1: 前提条件確認
-
docs/michi/$1/reviews/に最新のレビューレポートが存在するか確認 -
最新レビューの品質ゲート判定を確認
grep "品質ゲート判定" docs/michi/$1/reviews/cross-repo-review-*.md | tail -1 -
判定が「不合格」の場合:
❌ エラー: 品質ゲート不合格 BLOCK問題が未解決です。実装を開始できません。 次のアクション: 1. BLOCK問題を修正 2. `/michi-multi-repo:spec-review $1` を再実行 3. 合格後に再度このコマンドを実行 -
判定が「条件付き合格」の場合:
⚠️ 警告: 品質ゲート条件付き合格 WARN問題が検出されています。このまま実装を開始しますか? (y/n) 推奨: WARN問題を修正してから実装開始
Step 2: コンテキスト読み込み
-
.michi/config.jsonからプロジェクト情報取得 -
登録リポジトリの一覧を取得
-
各リポジトリの
localPathを取得 -
各リポジトリのタスクファイル確認
{localPath}/.michi/specs/{feature}/tasks.md
Step 2.5: localPath 検証
各リポジトリについて以下を確認:
- ✅ localPathが設定されているか
- ✅ ディレクトリが存在するか
- ✅ Gitリポジトリか (
.git/ディレクトリ確認) - ✅ Michiがセットアップ済みか (
.michi/project.json確認) - ⚠️ 設定されたブランチと現在のブランチが一致するか
- ⚠️ 未コミット変更がないか
検証失敗時の対応:
- localPath未設定: 警告を出力し、該当リポジトリをスキップ
- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
- ブランチ不一致: 警告を出力(続行可能)
- 未コミット変更: 警告を出力(続行可能)
Step 3: チェックポイント確認
docs/michi/$1/.checkpoint-impl.json の存在を確認
存在する場合:
⚠️ チェックポイントファイルが見つかりました
前回の実装が中断された可能性があります。
次のアクション:
A) チェックポイントから再開(未完了リポジトリのみ処理)
B) 最初から実行(チェックポイント削除)
C) キャンセル
選択 (A/B/C): _
Step 4: サブエージェント並行起動
並行実行数: 最大3並列
repo-spec-executorサブエージェントを使用して、以下のリポジトリで実装を並行実行してください:
Repository 1: {repo1.name}
- LOCAL_PATH: {repo1.localPath}
- PARENT_PROJECT: $1
- FEATURE_NAME: {feature}
- OPERATION: impl
- TASKS: {指定されたtask-numbers または "all"}
Repository 2: {repo2.name}
- LOCAL_PATH: {repo2.localPath}
- PARENT_PROJECT: $1
- FEATURE_NAME: {feature}
- OPERATION: impl
- TASKS: {指定されたtask-numbers または "all"}
(以下、登録されている全リポジトリ)
重要: 各サブエージェントの完了を待ち、結果を集約してください。
Step 5: 結果集約とレポート
各リポジトリの実行結果を集約:
| リポジトリ | タスク進捗 | カバレッジ | Lint | Build | ステータス |
|---|---|---|---|---|---|
| frontend | 5/5 | 96% | ✅ | ✅ | ✅ 完了 |
| backend | 8/8 | 98% | ✅ | ✅ | ✅ 完了 |
| shared | 3/3 | 95% | ✅ | ✅ | ✅ 完了 |
成功件数: 3/3 全体カバレッジ: 96.3%
Step 6: チェックポイント保存(失敗時)
失敗したリポジトリがある場合、チェックポイントを保存:
{
"projectName": "$1",
"operation": "impl",
"repositories": {
"frontend": {
"status": "completed",
"tasksCompleted": 5,
"tasksTotal": 5,
"coverage": 96,
"completedAt": "2025-12-23T11:00:00Z"
},
"backend": {
"status": "failed",
"tasksCompleted": 3,
"tasksTotal": 8,
"error": "Test failed: auth.test.ts",
"failedAt": "2025-12-23T11:10:00Z"
}
},
"savedAt": "2025-12-23T11:11:00Z"
}
保存先: docs/michi/$1/.checkpoint-impl.json
Step 7: 次のアクション案内
全成功時:
🎉 全リポジトリで実装が完了しました
### 実装サマリー
| 指標 | 結果 |
|------|------|
| 完了リポジトリ | 3/3 |
| 全体カバレッジ | 96.3% |
| Lint/Build | ✅ All Pass |
### 次のステップ
1. 各リポジトリでPR作成:
各リポジトリで `/pr` コマンドを実行
2. CI結果を監視:
`michi multi-repo:ci-status $1`
3. PRマージ後、リリース準備:
- Confluenceリリース手順書作成
- JIRAリリースチケット起票
一部失敗時:
⚠️ 一部のリポジトリで失敗しました
### 失敗したリポジトリ
- backend: Test failed: auth.test.ts (タスク3/8完了)
### 対処方法
1. 失敗箇所を確認:
```bash
cd {backend.localPath}
npm test auth.test.ts
- 修正後、チェックポイントから再開:
/michi-multi-repo:impl-all $1(失敗したリポジトリのみ処理されます)
## Important Constraints
- spec-review合格が前提(BLOCK問題がないこと)
- 並行実行は最大3リポジトリ
- TDDサイクル(RED-GREEN-REFACTOR)を遵守
- テストカバレッジ95%以上を維持
- 各リポジトリは独立して処理(依存関係なし)
</instructions>
## Tool Guidance
- **Task**: repo-spec-executorサブエージェント起動に使用
- **Read**: config.json、レビューレポート、タスクファイル読み込み
- **Write**: チェックポイント保存
- **Bash**: Git操作、カバレッジ確認
## Output Description
日本語で以下の情報を出力してください:
1. **処理対象リポジトリ一覧**: 各リポジトリのタスク進捗
2. **実行結果サマリー**: 成功/失敗件数、全体カバレッジ
3. **各リポジトリの詳細結果**: カバレッジ、Lint/Build結果、エラー内容
4. **次のアクション**: 成功時/失敗時の推奨ステップ
## Safety & Fallback
### Error Scenarios
- **品質ゲート不合格**:
エラー: 品質ゲート不合格のため、実装を開始できません。
/michi-multi-repo:spec-review $1 を実行し、BLOCK問題を解決してください。
- **タスクファイル不存在**:
エラー: リポジトリ '{name}' にタスクファイルがありません: .michi/specs/{feature}/tasks.md
タスクを生成してください: cd {localPath} /michi:spec-tasks {feature}
- **localPath未設定**:
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
- **Michi未セットアップ**:
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
セットアップコマンド: cd {localPath} && npx @sk8metal/michi-cli@latest init
セットアップ完了後、このコマンドを再実行してください。
### Fallback Strategy
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
- テスト失敗: 自動修正を試行(最大3回)、失敗時はチェックポイント保存
think hard
Multi-Repo Spec Propagation
<background_information>
- Mission: Multi-Repoプロジェクトの仕様を各リポジトリに展開
- Success Criteria:
- 全リポジトリで指定されたOPERATIONが完了
- 各リポジトリの仕様が親プロジェクトと整合性を保つ
- エラーハンドリングとチェックポイント保存 </background_information>
引数解析
引数の形式:
/michi-multi-repo:propagate-specs <project-name> [--operation <operation>]
パラメータ:
- $1: プロジェクト名(必須)
- --operation: 実行する操作(オプション、デフォルト: all)
init: /michi:spec-initrequirements: /kiro:spec-requirementsdesign: /michi:spec-designall: /michi:spec-init → /kiro:spec-requirements → /michi:spec-design を順次実行
Execution Steps
Step 1: コンテキスト読み込み
-
.michi/config.jsonからプロジェクト情報取得cat .michi/config.json | grep -A 20 '"name": "$1"' -
登録リポジトリの一覧を取得
-
各リポジトリの
localPathを取得 -
親プロジェクトの仕様ファイルを確認
docs/michi/$1/overview/requirements.md(OPERATION=design以降で必要)docs/michi/$1/overview/architecture.md(OPERATION=design以降で必要)
Step 2: localPath 検証
各リポジトリについて以下を確認:
- ✅ localPathが設定されているか
- ✅ ディレクトリが存在するか
- ✅ Gitリポジトリか (
.git/ディレクトリ確認) - ✅ Michiがセットアップ済みか (
.michi/project.json確認) - ⚠️ 設定されたブランチと現在のブランチが一致するか
- ⚠️ 未コミット変更がないか
検証失敗時の対応:
- localPath未設定: 警告を出力し、該当リポジトリをスキップ
- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
- ブランチ不一致: 警告を出力(続行可能)
- 未コミット変更: 警告を出力(続行可能)
Step 3: チェックポイント確認
docs/michi/$1/.checkpoint.json の存在を確認
存在する場合:
⚠️ チェックポイントファイルが見つかりました: docs/michi/$1/.checkpoint.json
前回の実行が中断された可能性があります。
次のアクション:
A) チェックポイントから再開(未完了リポジトリのみ処理)
B) 最初から実行(チェックポイント削除)
C) キャンセル
選択 (A/B/C): _
Step 3.5: 実行確認
以下のリポジトリで仕様生成を自動実行します:
| リポジトリ | localPath | 実行コマンド |
|---|---|---|
| {各リポジトリの情報を表示} |
AskUserQuestionツールで確認:
この内容で仕様生成を自動実行しますか?
実行されるコマンド:
- /michi:spec-init "{project description}"
- /kiro:spec-requirements {feature}
- /michi:spec-design {feature}
選択肢:
- はい、実行する(推奨)
- いいえ、キャンセル
Step 4: 並行実行
並行実行数: 最大3並列
重要: general-purposeエージェントを使用して、以下のリポジトリで仕様コマンドを並行実行してください:
各リポジトリに対してTaskツール(subagent_type: general-purpose)を起動:
Repository: {repo.name}
- 作業ディレクトリ: {repo.localPath}
- 親プロジェクト参照:
- requirements.md: {親プロジェクトパス}/docs/michi/$1/overview/requirements.md
- architecture.md: {親プロジェクトパス}/docs/michi/$1/overview/architecture.md
実行コマンド(順次):
/michi:spec-init "{project description}"/kiro:spec-requirements {feature}/michi:spec-design {feature}
親プロジェクトの設計との整合性を維持し、このリポジトリの責務範囲のみを設計してください。
重要: 全リポジトリのエージェント完了を待ち、結果を集約してください。
Step 5: 結果集約とレポート
各リポジトリの実行結果を集約:
| リポジトリ | OPERATION | ステータス | 詳細 |
|---|---|---|---|
| frontend | design | ✅ 成功 | design.md生成完了 |
| backend | design | ✅ 成功 | design.md生成完了 |
| shared | design | ❌ 失敗 | localPath未設定 |
成功件数: 2/3 失敗件数: 1/3
Step 6: チェックポイント保存(失敗時)
失敗したリポジトリがある場合、チェックポイントを保存:
{
"projectName": "$1",
"operation": "{operation}",
"repositories": {
"frontend": {
"status": "completed",
"completedAt": "2025-12-23T10:30:00Z"
},
"backend": {
"status": "completed",
"completedAt": "2025-12-23T10:31:00Z"
},
"shared": {
"status": "failed",
"error": "localPath未設定"
}
},
"savedAt": "2025-12-23T10:32:00Z"
}
保存先: docs/michi/$1/.checkpoint.json
Step 7: 次のアクション案内
全成功時:
🎉 全リポジトリで仕様展開が完了しました
### 次のステップ
1. クロスリポジトリレビューを実行:
`/michi-multi-repo:spec-review $1`
2. 合格後、各リポジトリでタスク生成:
各リポジトリで `/michi:spec-tasks {feature}` を実行
3. 実装を開始:
`/michi-multi-repo:impl-all $1`
一部失敗時:
⚠️ 一部のリポジトリで失敗しました
### 失敗したリポジトリ
- shared: localPath未設定
### 対処方法
1. localPathを設定:
`michi multi-repo:add-repo $1 --name shared --localPath /path/to/repo`
2. チェックポイントから再開:
`/michi-multi-repo:propagate-specs $1 --operation {operation}`
(失敗したリポジトリのみ処理されます)
Important Constraints
- 並行実行は最大3リポジトリ
- 各リポジトリは独立して処理(依存関係なし)
- localPath未設定のリポジトリはスキップ
- エラー発生時もチェックポイントを保存し、再開可能にする
Tool Guidance
- Task: repo-spec-executorサブエージェント起動に使用
- Read: config.json、親プロジェクト仕様の読み込み
- Write: チェックポイント保存
- Bash: localPath検証、Git操作
Output Description
日本語で以下の情報を出力してください:
- 処理対象リポジトリ一覧: 各リポジトリのlocalPathと検証結果
- 実行結果サマリー: 成功/失敗件数
- 各リポジトリの詳細結果: 生成されたファイル、エラー内容
- 次のアクション: 成功時/失敗時の推奨ステップ
Safety & Fallback
Error Scenarios
-
プロジェクト未登録:
エラー: プロジェクト '$1' が見つかりません。 次のコマンドでプロジェクトを初期化してください: michi multi-repo:init $1 --jira {JIRA_KEY} --confluence-space {SPACE} -
リポジトリ未登録:
警告: プロジェクト '$1' にリポジトリが登録されていません。 次のコマンドでリポジトリを登録してください: michi multi-repo:add-repo $1 --name {name} --url {url} --localPath {path} -
localPath未設定:
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。 localPathを設定するには: michi multi-repo:add-repo $1 --name {name} --localPath /path/to/repo -
Michi未セットアップ:
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。 セットアップコマンド: cd {localPath} && npx @sk8metal/michi-cli@latest init セットアップ完了後、このコマンドを再実行してください。 -
親プロジェクト仕様未作成(OPERATION=design以降):
エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md 先に親プロジェクトの設計を作成してください: /michi-multi-repo:spec-design $1
Fallback Strategy
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
- 全リポジトリ失敗: エラーレポート出力し、ユーザーに対処方法を案内
think hard
Multi-Repo Design Generator
<background_information>
- Mission: Multi-Repoプロジェクトの包括的な技術設計書を生成
- Success Criteria:
- 全サービスのアーキテクチャを統合
- サービス間通信の設計を明確化
- 各サービスの技術スタックを反映
- C4モデルに基づいた視覚的な設計図を含む </background_information>
Execution Steps
Step 1: コンテキスト読み込み
.michi/config.jsonからプロジェクト情報取得- プロジェクト名、JIRAキー、Confluenceスペース
- 登録リポジトリ一覧
docs/michi/$1/overview/requirements.mdから要件読み込み- 要件定義書が存在しない場合は、先に
/michi-multi-repo:spec-requirements $1の実行を促す
- 要件定義書が存在しない場合は、先に
.michi/settings/rules/design-principles.mdから設計原則取得(存在する場合).michi/settings/templates/specs/design.mdから構造参照(存在する場合)
Step 2: Discovery & Analysis
Multi-Repo固有の分析:
-
各リポジトリの技術スタック調査
- package.json / build.gradle / composer.json / requirements.txt
- 使用フレームワーク、ライブラリバージョン
- 依存関係の分析
-
サービス間通信パターンの特定
- REST API / GraphQL / gRPC
- メッセージキュー / イベントバス(Kafka、RabbitMQ等)
- 同期通信 vs 非同期通信
-
共有コンポーネントの識別
- 共通ライブラリ
- 共有データモデル
- 共通インフラストラクチャ(ログ、監視、認証等)
-
データフローの分析
- サービス間のデータ連携
- データの永続化方式
- キャッシュ戦略
Step 3: 設計書生成
以下のセクションを含む設計書を生成します:
-
システム全体図
- C4モデル - システムコンテキスト図(Mermaid)
- 全サービスの配置とフロー
- 外部システムとの連携
-
サービス横断アーキテクチャ
- マイクロサービス構成図(C4モデル推奨)
- サービス間API契約定義
- イベントスキーマ定義
- データフロー図
-
各サービスの設計
- コンポーネント図
- インターフェース定義
- データモデル
- 主要クラス/モジュール構造
-
セキュリティ設計
- 認証・認可の連携(OAuth2、JWT等)
- 通信暗号化(TLS、mTLS)
- シークレット管理
-
デプロイメントアーキテクチャ
- インフラストラクチャ構成(Kubernetes、Docker等)
- ネットワーク設計
- スケーリング戦略
-
データモデル
- サービス横断のデータフロー
- データベーススキーマ(サービスごと)
- データ整合性の保証方法
Step 4: ファイル保存
- 出力先:
docs/michi/$1/overview/architecture.md - 既存ファイルがある場合は、上書き確認(
-yフラグで自動承認)
Step 4.5: 品質検証(PROACTIVE)
architecture.md生成後、以下の検証を自動実行:
4.5.1 Mermaid図の構文検証
architecture.mdにMermaid図が含まれる場合、構文検証を実行:
IMPORTANT: architecture.mdにMermaid図が含まれる場合、以下の検証を実行してください。
- 検出: Mermaid図を含むかどうかを確認
- 検証: 構文エラーを検出(```mermaid ブロックの整合性確認)
- 修正: 自動修正可能なエラーを修正(不正な矢印記法、インデント等)
- 報告: 修正内容をユーザーに通知
実行タイミング: architecture.md保存直後
検証手順:
- architecture.mdから```mermaidブロックを抽出
- 基本的な構文チェック(開始/終了タグの整合性、基本記法の確認)
- エラーがあれば修正提案をユーザーに提示
4.5.2 技術スタックバージョン監査
stable-version-auditor エージェントを使用して技術スタックを監査:
IMPORTANT: architecture.mdに技術スタック(Node.js、Java、Python、PHP等)が記載されている場合、
stable-version-auditorエージェントを自動実行してください。
- 検出: バージョン指定を抽出
- 監査: EOLリスクを評価
- 推奨: 最新LTS/安定版を提案
- 報告: アップグレード推奨をユーザーに通知
実行タイミング: architecture.md保存直後
エージェント呼び出し:
Task(subagent_type='stable-version-auditor', prompt='docs/michi/$1/overview/architecture.md に記載された技術スタックのバージョンを監査し、EOLリスクを評価してください')
Step 5: メタデータ更新(spec.json)
docs/michi/$1/spec.jsonを読み込み- phase を
"design-generated"に更新 approvals.design.generatedをtrueに更新updated_atを現在のISO 8601タイムスタンプに更新- spec.json を保存
Multi-Repo固有セクション
設計書に以下のセクションを必ず含めること:
## サービス横断アーキテクチャ
### C4モデル - システムコンテキスト図
\`\`\`mermaid
C4Context
title System Context Diagram
Person(user, "User", "エンドユーザー")
System(frontend, "Frontend Service", "Webアプリケーション")
System(backend, "Backend Service", "APIサーバー")
System_Ext(external_api, "External API", "外部サービス")
Rel(user, frontend, "Uses", "HTTPS")
Rel(frontend, backend, "API calls", "REST/HTTPS")
Rel(backend, external_api, "Integrates", "REST/HTTPS")
\`\`\`
### サービス間通信
| 呼び出し元 | 呼び出し先 | 方式 | プロトコル | 用途 |
|-----------|-----------|------|-----------|------|
| Frontend | API Gateway | 同期 | REST/HTTPS | ユーザーリクエスト処理 |
| API Gateway | Auth Service | 同期 | gRPC | 認証・認可 |
| User Service | Notification Service | 非同期 | Kafka | ユーザー作成イベント通知 |
### 共有コンポーネント
**共通ライブラリ**:
- `@org/shared-types`: TypeScript型定義(全サービスで共有)
- `@org/logger`: 統一ログライブラリ
**共通インフラ**:
- Elasticsearch: ログ集約
- Prometheus + Grafana: メトリクス監視
- Keycloak: 統合認証基盤
### デプロイメントアーキテクチャ
\`\`\`mermaid
graph TB
subgraph "Production Kubernetes Cluster"
LB[Load Balancer]
FE1[Frontend Pod 1]
FE2[Frontend Pod 2]
BE1[Backend Pod 1]
BE2[Backend Pod 2]
DB[(PostgreSQL)]
LB --> FE1
LB --> FE2
FE1 --> BE1
FE2 --> BE2
BE1 --> DB
BE2 --> DB
end
\`\`\`
### データフロー
\`\`\`mermaid
sequenceDiagram
participant User
participant Frontend
participant API Gateway
participant Auth Service
participant User Service
participant Database
User->>Frontend: リクエスト
Frontend->>API Gateway: API呼び出し
API Gateway->>Auth Service: トークン検証
Auth Service-->>API Gateway: 検証成功
API Gateway->>User Service: ユーザー情報取得
User Service->>Database: クエリ実行
Database-->>User Service: データ返却
User Service-->>API Gateway: レスポンス
API Gateway-->>Frontend: レスポンス
Frontend-->>User: 表示
\`\`\`
Important Constraints
- 実装詳細ではなく、アーキテクチャ設計に焦点を当てる
- サービス間の境界とインターフェースを明確にする
- 技術選定の理由を記述する
- スケーラビリティとパフォーマンスを考慮
- セキュリティ要件を設計に反映
Tool Guidance
- Read first: プロジェクト設定、要件定義書、設計原則、テンプレートを読み込み
- Glob/Grep: 各リポジトリの技術スタック調査(ローカルクローンがある場合)
- Write last: 設計書を最後に保存
- WebSearch/WebFetch: 最新の設計パターンやベストプラクティスが必要な場合のみ使用
Output Description
以下の情報を出力してください:
- 生成された設計書のパス:
docs/michi/{project}/overview/architecture.md - 分析したリポジトリの一覧: サービス名と技術スタックの要約
- 品質検証結果:
- Mermaid図の検証結果
- 技術スタックバージョン監査結果
- 次のステップ:
- 設計書の確認
- Confluence同期
- 各リポジトリでの個別実装
出力形式:
## 設計書生成完了
### 出力ファイル
`docs/michi/{project}/overview/architecture.md`
### 分析したサービス
- **Frontend**: React + TypeScript(3リポジトリ依存)
- **Backend**: Node.js + Express(2リポジトリ依存)
- **Auth Service**: Go + gRPC(独立)
### アーキテクチャ概要
- **通信方式**: REST API(同期)、Kafka(非同期イベント)
- **データベース**: PostgreSQL(サービスごとにDB分離)
- **デプロイ**: Kubernetes(Pod自動スケーリング)
### 品質検証結果
#### Mermaid図検証
✅ 検証完了 - 構文エラーなし
または
⚠️ 2件の構文エラーを自動修正しました:
- L15: C4モデルのタイトル記法エラー → 修正済み
- L45: シーケンス図の矢印記法エラー → 修正済み
#### 技術スタックバージョン監査
✅ すべて最新LTS/安定版を使用
または
⚠️ バージョン更新を推奨:
- Node.js 16.x → 20.x (LTS) - EOL: 2023-09-11(EOL済み)
- Python 3.9 → 3.11 - EOL 6ヶ月以内
### 次のステップ
1. 設計書を確認: `docs/michi/{project}/overview/architecture.md`
2. 技術スタック更新(必要に応じて)
3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type architecture`
4. 各リポジトリで実装を開始:
- `/kiro:spec-init` で個別仕様を作成
- または直接実装を開始
Safety & Fallback
Error Scenarios
-
要件定義書未作成:
エラー: 要件定義書が見つかりません: `docs/michi/{project}/overview/requirements.md` 先に要件定義書を生成してください: /michi-multi-repo:spec-requirements {project} -
プロジェクト未登録:
エラー: プロジェクト '{project}' が見つかりません。 次のコマンドでプロジェクトを初期化してください: michi multi-repo:init {project} --jira {JIRA_KEY} --confluence-space {SPACE} -
リポジトリアクセス不可:
警告: 一部のリポジトリのローカルクローンがありません。 設定情報(URL、ブランチ)から推測して設計書を生成します。 より詳細な設計が必要な場合は、リポジトリをクローンしてから再実行してください。 -
既存ファイル存在(
-yフラグなし):警告: 既存の設計書が存在します: `docs/michi/{project}/overview/architecture.md` 上書きしてもよろしいですか? (y/n) または `-y` フラグを使用して自動承認できます。
Fallback Strategy
- 設計原則ファイル不在: 基本的な設計原則(SOLID、DRY等)を適用
- 技術スタック不明: README や設定ファイルから推測、または "未指定" として記載
- 依存関係不明: 基本的なクライアント-サーバー構成を仮定
- テンプレート不在: インラインで基本構造を使用
Next Phase: Implementation
設計書承認後:
- 設計書を確認:
docs/michi/{project}/overview/architecture.md - Confluenceに同期:
michi multi-repo:confluence-sync {project} --doc-type architecture - 各リポジトリで個別実装:
- リポジトリごとに
/kiro:spec-initで仕様作成 - または直接実装を開始
- リポジトリごとに
- CI/CD設定:
michi multi-repo:ci-status {project}でCI結果を監視
修正が必要な場合:
- フィードバックを提供し、
/michi-multi-repo:spec-design $1を再実行 -yフラグで自動上書き可能
think hard
Multi-Repo Specification Initialization
<background_information>
- Mission: Multi-Repoプロジェクトの初期化(
michi multi-repo:initの代替) - Success Criteria:
- プロジェクト説明からfeature-name形式のプロジェクト名を生成
- ディレクトリ構造を作成
- spec.jsonでメタデータ管理を開始
.michi/config.jsonのmultiRepoProjectsに登録- 次のステップ(リポジトリ登録、要件定義)への明確な誘導 </background_information>
引数解析
引数の形式:
/michi-multi-repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
パラメータ:
- $1: プロジェクト説明(必須) - 例: "マイクロサービスアーキテクチャでECサイトを構築"
- --jira: JIRAプロジェクトキー(必須) - 例: MSV
- --confluence-space: Confluenceスペースキー(必須) - 例: MSV
Execution Steps
Step 1: 引数解析とバリデーション
- プロジェクト説明の取得: $1 からプロジェクト説明を抽出
- JIRA/Confluenceキーの取得:
--jiraオプションの値を取得(なければエラー)--confluence-spaceオプションの値を取得(なければエラー)
- バリデーション:
- JIRAキー: 2-10文字の大文字英字のみ(正規表現:
^[A-Z]{2,10}$) - Confluenceスペースキー: 空でない文字列
- JIRAキー: 2-10文字の大文字英字のみ(正規表現:
Step 2: プロジェクト名の生成
-
feature-name形式に変換:
- プロジェクト説明から簡潔なプロジェクト名を生成
- 形式: 小文字英数字とハイフン(例:
my-microservices,ec-platform) - 日本語説明の場合は英語に変換
-
一意性チェック:
.michi/config.jsonのmultiRepoProjectsを確認- 重複する場合は数値サフィックスを追加(例:
my-project-2)
Step 3: ディレクトリ構造の作成
以下のディレクトリとファイルを作成:
docs/michi/{project-name}/
├── spec.json # メタデータファイル(NEW)
├── overview/
│ ├── requirements.md # 要件定義書(プロジェクト説明を含む)
│ ├── architecture.md # アーキテクチャ設計書(テンプレート)
│ └── sequence.md # シーケンス図(テンプレート)
├── steering/
│ └── multi-repo.md # ステアリングドキュメント(テンプレート)
├── tests/
│ ├── scripts/ # テストスクリプト配置用
│ ├── results/ # テスト結果保存用
│ ├── unit/
│ ├── integration/
│ ├── e2e/
│ └── performance/
└── docs/
├── ci-status.md # CI結果サマリー(テンプレート)
└── release-notes.md # リリースノート(テンプレート)
Step 4: メタデータ初期化
-
spec.jsonの生成:
- テンプレート:
templates/multi-repo/spec.json - プレースホルダー置換:
{{PROJECT_NAME}}→ 生成されたプロジェクト名{{CREATED_AT}}→ 現在のISO 8601タイムスタンプ{{JIRA_KEY}}→ JIRAキー{{CONFLUENCE_SPACE}}→ Confluenceスペースキー
- 出力先:
docs/michi/{project-name}/spec.json
- テンプレート:
-
requirements.mdの初期化:
- テンプレート:
templates/multi-repo/overview/requirements.md - 「概要」セクションにプロジェクト説明を記載
- プレースホルダー置換
- 出力先:
docs/michi/{project-name}/overview/requirements.md
- テンプレート:
-
その他テンプレートファイルのレンダリング:
templates/multi-repo/overview/architecture.md→docs/michi/{project-name}/overview/architecture.mdtemplates/multi-repo/overview/sequence.md→docs/michi/{project-name}/overview/sequence.mdtemplates/multi-repo/steering/multi-repo.md→docs/michi/{project-name}/steering/multi-repo.mdtemplates/multi-repo/tests/strategy.md→docs/michi/{project-name}/tests/strategy.mdtemplates/multi-repo/docs/ci-status.md→docs/michi/{project-name}/docs/ci-status.mdtemplates/multi-repo/docs/release-notes.md→docs/michi/{project-name}/docs/release-notes.md
Step 5: .michi/config.json の更新
- config.jsonの読み込み:
.michi/config.jsonを読み込む - multiRepoProjects に追加:
{ "name": "{project-name}", "jiraKey": "{JIRA_KEY}", "confluenceSpace": "{CONFLUENCE_SPACE}", "createdAt": "{ISO 8601 timestamp}", "repositories": [] } - 保存:
.michi/config.jsonを保存
Important Constraints
- プロジェクト名は1-100文字、パストラバーサル文字(
/,\,..)、制御文字は禁止 - JIRAキーは2-10文字の大文字英字のみ
- Confluenceスペースキーは空でない文字列
- 既存プロジェクト名と重複する場合は数値サフィックスを自動追加
- DO NOT generate requirements/design at this stage(要件・設計は後続コマンドで生成)
Tool Guidance
- Glob:
.michi/config.json存在確認、プロジェクト名の一意性チェック - Read: テンプレートファイル読み込み、config.json 読み込み
- Write: spec.json、requirements.md、config.json、その他テンプレート出力
- Edit: config.json の multiRepoProjects 配列に追加(必要に応じて)
Output Description
日本語で以下の情報を出力してください:
- 生成されたプロジェクト名:
{project-name}形式(1-2文で理由を説明) - プロジェクト概要: プロジェクト説明の要約(1文)
- 作成されたファイル: 箇条書きで主要ファイルのパス
- 次のステップ: 次に実行すべきコマンド(リポジトリ登録、要件定義)
出力形式:
## Multi-Repoプロジェクト初期化完了
### プロジェクト名
`{project-name}`
プロジェクト説明「{description}」から生成しました。
### プロジェクト概要
{プロジェクト説明の要約}
### 作成されたファイル
- `docs/michi/{project}/spec.json` - メタデータ(phase: initialized)
- `docs/michi/{project}/overview/requirements.md` - 要件定義書(初期化済み)
- `docs/michi/{project}/overview/architecture.md` - 設計書(テンプレート)
- `.michi/config.json` - multiRepoProjects に登録
### 次のステップ
1. **リポジトリを登録**:
\`\`\`bash
michi multi-repo:add-repo {project} --name frontend --url https://github.com/org/frontend --branch main
michi multi-repo:add-repo {project} --name backend --url https://github.com/org/backend --branch main
\`\`\`
2. **AI要件定義書を生成**:
\`\`\`bash
/michi-multi-repo:spec-requirements {project}
\`\`\`
3. **AI設計書を生成**:
\`\`\`bash
/michi-multi-repo:spec-design {project}
\`\`\`
4. **Confluenceに同期**:
\`\`\`bash
michi multi-repo:confluence-sync {project}
\`\`\`
Safety & Fallback
Error Scenarios
-
引数不足:
エラー: 必須パラメータが不足しています。 使用方法: /michi-multi-repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE> 例: /michi-multi-repo:spec-init "マイクロサービスでECサイト構築" --jira MSV --confluence-space MSV -
JIRAキーが不正:
エラー: JIRAキーは2-10文字の大文字英字のみです(例: MSV, PROJ) -
プロジェクト名重複:
警告: プロジェクト名 '{project-name}' は既に存在します。 自動的に '{project-name-2}' として作成しました。 -
config.json が存在しない:
エラー: .michi/config.json が見つかりません。 Michiプロジェクトのルートディレクトリで実行してください。 または、次のコマンドで初期設定を行ってください: michi init
Fallback Strategy
- プロジェクト名生成が曖昧な場合: 2-3の候補を提示し、ユーザーに選択を求める
- テンプレートファイル不在: エラーメッセージと対処方法を表示
- ディレクトリ作成失敗: パーミッションまたはディスク容量の確認を促す
think hard
Multi-Repo Requirements Generation
<background_information>
- Mission: Multi-Repoプロジェクトの包括的な要件定義書をEARS形式で生成
- Success Criteria:
- 登録された全リポジトリの情報を反映
- リポジトリ間の依存関係とインターフェースを明記
- EARS形式の受入基準を含む
- サービス構成図(Mermaid)を含む </background_information>
Execution Steps
Step 1: プロジェクト情報の取得
.michi/config.jsonを読み込み、プロジェクト$1の情報を取得- プロジェクトが登録されていない場合は、
michi multi-repo:initの実行を促す - 登録されたリポジトリ一覧を確認
- リポジトリ数が0の場合は警告を出し、基本構造のみ生成
Step 2: コンテキスト収集
- EARS形式ルール:
.michi/settings/rules/ears-format.mdを読み込み- EARS形式(Event-Action-Response-System)の構文を理解
- 既存要件テンプレート:
templates/multi-repo/overview/requirements.mdを確認 - 各リポジトリの情報収集:
- リポジトリ名、URL、ブランチ
- 技術スタック(package.json、build.gradle、composer.json等から推測)
- 主要機能(README.mdから抽出)
- 注: ローカルクローンがない場合は、設定情報から推測
Step 3: 要件定義書生成
以下のセクションを含む要件定義書を生成します:
-
プロジェクト概要
- プロジェクト名、JIRAキー、Confluenceスペース
- 複数リポジトリを統合したシステムの概要
- ビジネス価値
-
サービス構成
- 登録リポジトリ一覧(表形式)
- サービス間依存関係(Mermaidダイアグラム)
- 各サービスの役割説明
-
インターフェース要件
- サービス間API契約(エンドポイント一覧)
- イベント契約(Pub/Sub、メッセージキュー等)
- データフォーマット
-
機能要件
- 各サービスの機能要件をEARS形式で記述
- サービス横断的な機能要件(認証、ログ集約等)
-
非機能要件
- パフォーマンス要件(レスポンスタイム、スループット)
- セキュリティ要件(認証・認可、通信暗号化)
- 可用性要件(SLA、冗長化)
- 保守性要件(モニタリング、ログ)
Step 4: ファイル保存
- 出力先:
docs/michi/$1/overview/requirements.md - 既存ファイルがある場合は、上書き確認を実施
- ファイル保存後、完了メッセージを表示
Step 5: メタデータ更新(spec.json)
docs/michi/$1/spec.jsonを読み込み- phase を
"requirements-generated"に更新 approvals.requirements.generatedをtrueに更新updated_atを現在のISO 8601タイムスタンプに更新- spec.json を保存
Multi-Repo固有セクション
要件定義書に以下のセクションを必ず含めること:
## サービス構成
### 登録リポジトリ一覧
| サービス名 | リポジトリURL | ブランチ | 役割 | 技術スタック |
|-----------|---------------|---------|------|-------------|
| frontend | https://github.com/org/frontend | main | ユーザーインターフェース | React, TypeScript |
| backend | https://github.com/org/backend | main | APIサーバー | Node.js, Express |
### サービス間依存関係
\`\`\`mermaid
graph TB
A[Frontend] -->|REST API| B[API Gateway]
B -->|HTTP| C[Auth Service]
B -->|HTTP| D[User Service]
C -->|gRPC| E[Database]
D -->|gRPC| E
\`\`\`
## インターフェース要件
### API契約
**Auth Service → User Service**
- エンドポイント: `POST /api/v1/auth/verify`
- プロトコル: HTTP/REST
- データ形式: JSON
### イベント契約
**User Service → Notification Service**
- イベント: `user.created`
- プロトコル: Kafka
- スキーマ: { userId, email, createdAt }
Important Constraints
- EARS形式を厳守(When/If/While/Where/The system shall)
- サービス名を明確にする(例: The Frontend Service shall...)
- 要件はテスト可能であること
- 実装詳細は含めない(WHAT、not HOW)
Tool Guidance
- Read first: プロジェクト設定、EARS形式ルール、テンプレートを読み込み
- Write last: 要件定義書を最後に保存
- WebSearch/WebFetch: 外部ドメイン知識が必要な場合のみ使用
Output Description
以下の情報を出力してください:
- 生成された要件定義書のパス:
docs/michi/{project}/overview/requirements.md - 含まれるリポジトリ/サービスの一覧: サービス名と役割の要約
- 次のステップ:
/michi-multi-repo:spec-design $1で設計書を生成michi multi-repo:confluence-sync $1 --doc-type requirementsでConfluenceに同期
出力形式:
## 要件定義書生成完了
### 出力ファイル
`docs/michi/{project}/overview/requirements.md`
### 含まれるサービス
- **Frontend**: ユーザーインターフェース(React)
- **Backend**: APIサーバー(Node.js)
- **Database**: データ永続化(PostgreSQL)
### 次のステップ
1. 要件定義書を確認: `docs/michi/{project}/overview/requirements.md`
2. 設計書を生成: `/michi-multi-repo:spec-design {project}`
3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type requirements`
Safety & Fallback
Error Scenarios
-
プロジェクト未登録:
エラー: プロジェクト '{project}' が見つかりません。 次のコマンドでプロジェクトを初期化してください: michi multi-repo:init {project} --jira {JIRA_KEY} --confluence-space {SPACE} -
リポジトリ未登録:
警告: プロジェクト '{project}' にリポジトリが登録されていません。 基本的な要件定義書の骨格を生成しますが、サービス固有の情報は含まれません。 次のコマンドでリポジトリを登録してください: michi multi-repo:add-repo {project} --name {name} --url {url} --branch {branch} -
既存ファイル存在:
警告: 既存の要件定義書が存在します: `docs/michi/{project}/overview/requirements.md` 上書きしてもよろしいですか? (y/n) -
EARS形式ルール未取得:
.michi/settings/rules/ears-format.mdが存在しない場合、基本的なEARS形式を使用- 警告メッセージを表示
Fallback Strategy
- ローカルクローンがないリポジトリ: 設定情報(名前、URL)のみから推測
- 技術スタック不明: "未指定" として記載
- 依存関係不明: 基本的なクライアント-サーバー構成を仮定
think hard
Multi-Repo Cross-Repository Review
<background_information>
- Mission: 複数リポジトリにまたがる仕様の整合性を検証
- Success Criteria:
- 全リポジトリの仕様を収集・分析
- API契約、データモデル、イベントスキーマの整合性を検証
- 品質ゲート判定を実行
- 修正が必要な箇所を明確に報告 </background_information>
引数解析
引数の形式:
/michi-multi-repo:spec-review <project-name> [--focus <focus>]
パラメータ:
- $1: プロジェクト名(必須)
- --focus: レビュー観点(オプション、デフォルト: all)
api: API契約整合性のみdata: データモデル整合性のみevent: イベントスキーマ整合性のみdeps: 依存関係整合性のみtest: テスト仕様整合性のみall: 全観点(デフォルト)
Execution Steps
Step 1: コンテキスト読み込み
-
.michi/config.jsonからプロジェクト情報取得- プロジェクト名
- 登録リポジトリ一覧
-
各リポジトリの
localPathを取得 -
親プロジェクトの仕様を読み込み
docs/michi/$1/overview/requirements.mddocs/michi/$1/overview/architecture.md
Step 2: localPath 検証
各リポジトリについて以下を確認:
- localPathが設定されているか
- ディレクトリが存在するか
- Gitリポジトリか (
.git/ディレクトリ確認) - Michiがセットアップ済みか (
.michi/project.json確認) - 仕様ファイルが存在するか
検証失敗時の対応:
- localPath未設定: 警告を出力し、スキップ
- ディレクトリ不存在: エラーを出力し、スキップ
- Michi未セットアップ: 警告を出力し、スキップ
- 仕様ファイル不存在: 警告を出力し、利用可能情報でレビュー続行
Step 3: サブエージェント起動
cross-repo-reviewerサブエージェントを使用して、以下のプロジェクトをレビューしてください:
- PROJECT_NAME: $1
- REPOSITORIES:
- {repo1.name}: {repo1.localPath}
- {repo2.name}: {repo2.localPath}
- ...
- REVIEW_FOCUS: {指定されたfocus}
品質ゲート判定結果をレポートしてください。
Step 4: レビューレポート出力
出力先: docs/michi/$1/reviews/cross-repo-review-{timestamp}.md
レポート形式:
## Multi-Repo Cross-Repository Review Report
**プロジェクト**: $1
**レビュー日時**: {timestamp}
**対象リポジトリ**: {count}件
**レビュー観点**: {focus}
---
### サマリー
| カテゴリ | ステータス | 問題件数 |
|---------|----------|---------|
| API契約整合性 | ✅/⚠️/❌ | N件 |
| データモデル整合性 | ✅/⚠️/❌ | N件 |
| イベントスキーマ整合性 | ✅/⚠️/❌ | N件 |
| 依存関係整合性 | ✅/⚠️/❌ | N件 |
| テスト仕様整合性 | ✅/⚠️/❌ | N件 |
---
### 検出された問題
#### 🔴 BLOCK (修正必須)
(cross-repo-reviewerが検出した重大な不整合)
#### 🟡 WARN (修正推奨)
(cross-repo-reviewerが検出した軽微な不整合)
---
### 品質ゲート判定
**判定**: ❌ 不合格 / ⚠️ 条件付き合格 / ✅ 合格
**理由**: {判定理由}
---
### 次のアクション
1. BLOCK問題の修正
2. `/michi-multi-repo:spec-review $1` を再実行
3. 合格後、各リポジトリで実装を開始
Step 5: 判定結果の表示
合格時(✅ PASS):
🎉 品質ゲート合格
全リポジトリの仕様が整合性基準を満たしています。
### 次のステップ
1. 各リポジトリでタスク生成:
各リポジトリで `/michi:spec-tasks {feature}` を実行
2. 全リポジトリで実装を開始:
`/michi-multi-repo:impl-all $1`
3. CI/CD設定:
`michi multi-repo:ci-status $1` でCI結果を監視
条件付き合格時(⚠️ WARN):
⚠️ 品質ゲート条件付き合格
WARN問題が検出されましたが、修正は任意です。
### 検出された問題
- {WARN問題のリスト}
### 次のステップ(選択可能)
A) WARN問題を修正してから実装開始(推奨)
- 各リポジトリのdesign.mdを修正
- `/michi-multi-repo:spec-review $1` を再実行
B) そのまま実装開始
- `/michi-multi-repo:impl-all $1`
不合格時(❌ BLOCK):
❌ 品質ゲート不合格
BLOCK問題が検出されました。修正が必須です。
### BLOCK問題
- {BLOCK問題のリスト}
### 対処方法
1. 該当リポジトリのdesign.mdを修正
2. `/michi-multi-repo:spec-review $1` を再実行
3. 合格後に実装を開始
**注意**: BLOCK問題を未解決のまま実装を開始すると、サービス間通信が失敗する可能性があります。
Important Constraints
- 読み取り操作のみ(各リポジトリへの書き込みは行わない)
- localPath未設定のリポジトリはスキップ(警告を出力)
- 大規模リポジトリの場合は主要ファイルのみ分析
Tool Guidance
- Task: cross-repo-reviewerサブエージェント起動に使用
- Read: プロジェクト仕様、各リポジトリ仕様の読み込み
- Write: レビューレポートの出力
- Glob/Grep: 仕様ファイルの検索
Output Description
日本語で以下の情報を出力してください:
- レビュー対象リポジトリ一覧: 各リポジトリのlocalPathと仕様状態
- 検出された問題: BLOCK/WARN分類と詳細
- 品質ゲート判定結果: 合格/不合格と理由
- 次のアクション: 修正が必要な場合の具体的な手順
Safety & Fallback
Error Scenarios
-
プロジェクト未登録:
エラー: プロジェクト '$1' が見つかりません。 -
親プロジェクト仕様未作成:
エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md 先に親プロジェクトの設計を作成してください: /michi-multi-repo:spec-design $1 -
localPath未設定:
警告: リポジトリ '{name}' の localPath が未設定です。スキップします。 -
Michi未セットアップ:
⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。 セットアップコマンド: cd {localPath} && npx @sk8metal/michi-cli@latest init セットアップ完了後、このコマンドを再実行してください。 -
仕様ファイル不存在:
警告: リポジトリ '{name}' に仕様ファイルがありません。 仕様を展開してください: /michi-multi-repo:propagate-specs $1
Fallback Strategy
- localPath未設定: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
- 仕様ファイル不存在: 警告を出力し、利用可能な情報でレビュー
- 通信エラー: リトライ後、該当リポジトリをスキップ
think hard
Confluence Sync Command
Michi 固有機能: このコマンドは Michi 独自の機能です。cc-sdd 標準には含まれません。
仕様書(requirements.md, design.md)を Confluence に同期し、承認ワークフローを実現します。
Development Guidelines
{{DEV_GUIDELINES}}
Usage
/michi:confluence-sync <feature_name>
Parameters:
feature_name: Feature name (e.g., user-auth, payment-api)
Execution Steps
- Read specifications from {{SPEC_DIR}}/specs/{{FEATURE_NAME}}/
- Load project metadata from {{SPEC_DIR}}/project.json
- Sync requirements.md to Confluence
- Sync design.md to Confluence
- Create/update Confluence pages with proper labels
- Link pages to JIRA Epic (if exists)
Language Handling
- Read language from {{SPEC_DIR}}/project.json
- Generate all output in the specified language
- Use Confluence labels from project.json for page organization
Project Metadata
- Project ID: {{PROJECT_ID}}
- Spec directory: {{SPEC_DIR}}
- Agent directory: {{AGENT_DIR}}
Michi: Spec Implementation with Quality Automation
Base Command Reference
@.claude/commands/kiro/kiro/kiro-spec-impl.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: 5-Phase Quality Automation
このコマンドは、Michi固有の5フェーズ品質自動化を適用します。
5フェーズ自動化フロー
Phase A: License & Version Audit (自動)
├─ npm audit
├─ License compatibility check
└─ LTS/EOL version check
Phase 1: TDD Implementation
├─ Write failing test (Red)
├─ Implement minimum code (Green)
└─ Refactor (Refactor)
Phase 2: (Reserved for future)
Phase 3: Code Review
├─ Create PR
├─ AI code review
└─ Address feedback
Phase 4: Coverage Validation
├─ Run coverage report
├─ Validate >= 95%
└─ Check critical paths
Phase B: Archive Preparation
├─ Update CHANGELOG
├─ Create release notes
└─ Update documentation
自動実行コマンド
# フェーズごとの自動実行
/michi:michi-spec-impl <feature> <task> --phase A # License audit
/michi:michi-spec-impl <feature> <task> --phase 1 # TDD implementation
/michi:michi-spec-impl <feature> <task> --phase 3 # Code review
/michi:michi-spec-impl <feature> <task> --phase 4 # Coverage validation
/michi:michi-spec-impl <feature> <task> --phase B # Archive prep
# 全フェーズ一括実行
/michi:michi-spec-impl <feature> <task> --all-phases
PR サイズ監視
PRサイズが500行を超える場合、警告を表示:
⚠️ PR Size Warning
Current changes: 650 lines
Recommended: < 500 lines
💡 Suggestion:
Consider splitting this task into smaller units:
- Task 5.1a: Core logic (300 lines)
- Task 5.1b: Error handling (200 lines)
- Task 5.1c: Tests (150 lines)
品質ゲートチェック
各フェーズ完了時、品質ゲートをチェック:
✅ Phase 1 Complete: TDD Implementation
Quality Gates:
├─ ✅ All tests passing (1025 tests)
├─ ✅ Coverage >= 95% (96%)
├─ ✅ No linting errors
├─ ✅ Type check passed
└─ ✅ Architecture check passed
Next: Phase 3 - Code Review
/michi:michi-spec-impl <feature> <task> --phase 3
Michi 固有機能: このコマンドは cc-sdd 標準のネストコマンドを Michi 名前空間に移行し、5フェーズ品質自動化、PRサイズ監視、品質ゲートチェックを追加します。
Michi: Spec Tasks Generation
Base Command Reference
@.claude/commands/kiro/kiro/kiro-spec-tasks.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Workflow Integration
このコマンドは、Michiワークフロー形式でタスクを生成します。
Kiro標準との差分
-
JIRA同期オプションの追加:
- タスク生成後、自動的にJIRAチケット作成を提案
- プロジェクトキーとの紐付け
-
タスク粒度ガイドライン:
- 1タスク = 1-3日の作業量
- PR サイズ: 500行以内推奨
- 依存関係の明示
-
テストタスクの分離:
- 実装タスクとテストタスクを明確に分離
- TDD フローに沿ったタスク順序
使用例
# Michiワークフロー形式でタスク生成
/michi:michi-spec-tasks <feature>
# JIRA同期付き
/michi:michi-spec-tasks <feature> --sync-jira
生成されるタスク形式
## Task 1: Authentication API - User Login
**Type**: Implementation
**Estimated**: 2 days
**Dependencies**: None
**PR Size**: ~300 lines
### Acceptance Criteria
- [ ] POST /api/auth/login endpoint
- [ ] Email/password validation
- [ ] JWT token generation
- [ ] Error handling
### Test Requirements
- [ ] Unit tests (coverage >= 95%)
- [ ] Integration tests for login flow
- [ ] Error case tests
**JIRA**: PROJ-123
Michi 固有機能: このコマンドは cc-sdd 標準のネストコマンドを Michi 名前空間に移行し、JIRA同期とタスク粒度ガイドラインを追加します。
PRコメント対応
Development Guidelines
{{DEV_GUIDELINES}}
このコマンドは、プルリクエストのレビューコメントへの対応を支援し、すべてのコメントが適切に解決されているか確認します。
確認項目
1. コメントの収集
- GitHub PR APIを使用してコメント取得
- レビュー承認/変更要求の確認
- 未解決コメントのリスト化
- 返信済みコメントの確認
2. 対応状況の確認
- コード変更による対応
- コメントでの返信による対応
- 「Resolve conversation」の実行状況
- 対応漏れの検出
3. 対応完了の検証
- すべてのコメントへの対応完了
- レビュアーからの再承認の確認
- マージ可能状態の確認
使用方法
基本的な使い方
# 現在のブランチのPRコメントを確認
/michi:pr-resolve
# 特定のPR番号を指定
/michi:pr-resolve 123
GitHub CLI連携
コマンド内部で以下のGitHub CLIコマンドを使用します:
# PRコメント一覧取得
gh pr view <PR番号> --json comments,reviews
# PRステータス確認
gh pr status
# PRコメント表示
gh pr view <PR番号>
対応フロー
ステップ1: コメント収集
## 未解決コメント一覧
1. [ファイル名:行数] レビュアー: コメント内容
2. [ファイル名:行数] レビュアー: コメント内容
ステップ2: 対応計画
## 対応計画
- [ ] コメント1: コード修正(認証ロジックの改善)
- [ ] コメント2: 返信のみ(設計意図の説明)
- [ ] コメント3: コード修正(テストケース追加)
ステップ3: 対応実施
- コード修正が必要な箇所を特定
- 修正内容を提案
- コミットメッセージの推奨
ステップ4: 対応完了確認
## 対応完了レポート
✓ すべてのコメントに対応済み
✓ レビュアーから再承認を獲得
✓ マージ可能状態
出力
PRコメント対応結果は以下の形式で出力されます:
- サマリー: 総コメント数、未解決数、対応完了数
- 未解決コメント詳細: 各コメントの内容と推奨対応
- 対応済みコメント: すでに解決済みのコメント
- 次のアクション: マージ前に必要な作業
Phase A統合
このコマンドはPhase A(PR前自動テスト)またはレビュー対応時に実行することを推奨します。
GitHub CLI必須
このコマンドは gh コマンド(GitHub CLI)が必要です。
未インストールの場合は以下でインストールしてください:
# macOS
brew install gh
# 認証
gh auth login
環境変数
GitHubトークンが必要な場合は、以下の環境変数を設定してください:
export GITHUB_TOKEN="your_token_here"
使用例
PRレビュー対応の完全フロー
# 1. PRコメントを確認
/michi:pr-resolve
# 2. コメントに基づいてコード修正
# (Claude Codeが修正を提案)
# 3. 変更をコミット
git add .
git commit -m "fix: レビューコメントに対応"
# 4. PRを更新
git push
# 5. 再度確認
/michi:pr-resolve
# 6. すべて解決済みならマージ
gh pr merge
言語設定
出力言語は {{SPEC_DIR}}/project.json の設定に従います。
Project Switch Command
Michi 固有機能: このコマンドは Michi 独自の機能です。cc-sdd 標準には含まれません。
マルチプロジェクト環境で、異なるプロジェクト間を切り替えるための機能です。
Development Guidelines
{{DEV_GUIDELINES}}
Usage
/michi:project-switch <project_id>
Parameters:
project_id: Project ID (e.g., customer-a-service-1, michi)
Examples:
/michi:project-switch michi
/michi:project-switch customer-a-service-1
Execution Steps
- Identify GitHub repository corresponding to project ID
- Clone locally (if not cloned) or checkout
- Load and display {{SPEC_DIR}}/project.json
- Display corresponding Confluence project page URL
Language Handling
- Read language from {{SPEC_DIR}}/project.json
- Generate all output in the specified language
- Default to English if language field is missing
Michi: Spec Archive with Confluence Sync
Base Command Reference
@.claude/commands/kiro/spec-archive.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Post-Archive Actions
アーカイブ完了後、以下のオプションを提案:
Confluence同期オプション
アーカイブ後、Confluence上のドキュメントステータスも更新できます:
推奨アクション:
# Confluenceドキュメントにアーカイブステータスを反映
/michi:confluence-sync <feature-name> --status archived
確認項目:
- Atlassian連携が設定されているか(ATLASSIAN_URL, ATLASSIAN_API_TOKEN)
- Confluenceスペースが指定されているか(CONFLUENCE_PRD_SPACE等)
出力例:
✅ Archived specification: <feature>
📁 Archive path: .michi/specs/archive/<feature>/
📝 Reason: <reason>
📚 Optional: Sync archive status to Confluence
/michi:confluence-sync <feature> --status archived
次のステップ
アーカイブ完了後の推奨アクション:
- リリースノート確認:
docs/release-notes/ディレクトリにリリースノートが保存されているか確認 - 次の機能開発:
/michi:spec-init "<description>"で新しいspec作成 - 全体進捗確認:
/michi:spec-statusで全spec進捗確認(--allオプションでアーカイブ含む)
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-archive を拡張し、Confluence同期オプションとアーカイブ後の推奨アクションを追加します。
Michi: Spec Design with Test Planning Flow
Base Command Reference
@.claude/commands/kiro/spec-design.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Quality Infrastructure Check
優先度: このMichi Extensionの指示は、base command(kiro版)の品質インフラチェックより優先されます。 Michi Extensionで言語検出と言語別チェックを実行し、base commandのNode.js固有チェックは上書きされます。
設計作成時に、プロジェクトの言語を検出し、言語別の品質インフラ設定状況をチェックします。
Step 1: CI設定の確認とプラットフォーム選択
既存CI設定をチェック
.github/workflows/が存在する場合 → GitHub Actions採用screwdriver.yamlが存在する場合 → Screwdriver採用- 両方なし → Step 1.5でユーザーに選択を促す
Step 1.5: CI未設定の場合のプラットフォーム選択
CIが未設定の場合、以下の選択肢を提示:
CIプラットフォームを選択してください:
A) GitHub Actions(推奨)
B) Screwdriver
C) 後で設定する
Step 2: 言語検出とユーザー確認
2-1. プロジェクトルートのファイルをチェック
package.jsonあり → Node.jspom.xmlまたはbuild.gradle*あり → Javapyproject.tomlまたはrequirements.txtあり → Pythoncomposer.jsonあり → PHP
2-2. 検出結果をユーザーに確認(オプション)
複数言語が検出された場合や確認が必要な場合:
検出された言語: {{LANG}}。正しいですか? (Y/n)
- 複数言語検出時は主要言語を選択させる
- 誤検出の場合は手動で指定可能
Step 3: 言語別チェック項目
Node.js / TypeScript
| 項目 | チェック方法 | 必須 |
|---|---|---|
| husky | .husky/ ディレクトリ | ✅ |
| pre-commit hook | .husky/pre-commit ファイル | ✅ |
| lint-staged | package.json の lint-staged キーまたは .lintstagedrc* | ✅ |
| TypeScript strict | tsconfig.json の strict: true | ✅ |
| tsarch | package.json の tsarch | ℹ️(推奨) |
| CI | .github/workflows/ または screwdriver.yaml | ✅ |
| DevContainer | .devcontainer/ | ℹ️(任意) |
Java
| 項目 | チェック方法 | 必須 |
|---|---|---|
| pre-commit | .pre-commit-config.yaml または Spotless in pom.xml/build.gradle* | ℹ️(任意) |
| Checkstyle/PMD | checkstyle.xml, pmd.xml, または config/checkstyle/ | ✅ |
| NullAway | pom.xml または build.gradle* に nullaway/error_prone | ⚠️(必須) |
| ArchUnit | pom.xml または build.gradle* に archunit | ℹ️(推奨) |
| CI | .github/workflows/ または screwdriver.yaml | ✅ |
| DevContainer | .devcontainer/ | ℹ️(任意) |
Python
| 項目 | チェック方法 | 必須 |
|---|---|---|
| pre-commit | .pre-commit-config.yaml | ℹ️(任意) |
| lint/format | pyproject.toml に ruff/black/flake8、または setup.cfg, .flake8 | ✅ |
| mypy strict | pyproject.toml に mypy、または mypy.ini, .mypy.ini | ℹ️(推奨) |
| import-linter | pyproject.toml に importlinter、または .importlinter | ℹ️(推奨) |
| CI | .github/workflows/ または screwdriver.yaml | ✅ |
| DevContainer | .devcontainer/ | ℹ️(任意) |
PHP
| 項目 | チェック方法 | 必須 |
|---|---|---|
| pre-commit | grumphp.yml, captainhook.json, または .pre-commit-config.yaml | ℹ️(任意) |
| PHPStan/php-cs-fixer | phpstan.neon, phpcs.xml, または composer.json | ✅ |
| deptrac | deptrac.yaml または composer.json に deptrac | ℹ️(推奨) |
| CI | .github/workflows/ または screwdriver.yaml | ✅ |
| DevContainer | .devcontainer/ | ℹ️(任意) |
Step 4: 結果表示フォーマット
Node.js の例
📋 Quality Infrastructure Check (Node.js detected)
├─ ✅ husky: Configured
├─ ✅ lint-staged: Configured
├─ ✅ TypeScript strict: Configured
├─ ℹ️ tsarch: Not configured (optional - recommended)
├─ ✅ CI: GitHub Actions configured
└─ ℹ️ DevContainer: Not configured (optional)
Java の例
📋 Quality Infrastructure Check (Java detected)
├─ ℹ️ pre-commit: Not configured (optional)
├─ ✅ Checkstyle: Configured
├─ ⚠️ NullAway: Not configured (REQUIRED for null safety)
├─ ℹ️ ArchUnit: Not configured (optional - recommended)
├─ ✅ CI: Screwdriver configured
└─ ℹ️ DevContainer: Not configured (optional)
Python の例
📋 Quality Infrastructure Check (Python detected)
├─ ℹ️ pre-commit: Not configured (optional)
├─ ✅ lint/format: Configured (ruff in pyproject.toml)
├─ ℹ️ mypy strict: Not configured (recommended)
├─ ℹ️ import-linter: Not configured (optional - recommended)
├─ ✅ CI: GitHub Actions configured
└─ ℹ️ DevContainer: Not configured (optional)
PHP の例
📋 Quality Infrastructure Check (PHP detected)
├─ ℹ️ pre-commit: Not configured (optional)
├─ ✅ PHPStan: Configured (level=max)
├─ ℹ️ deptrac: Not configured (optional - recommended)
├─ ✅ CI: GitHub Actions configured
└─ ℹ️ DevContainer: Not configured (optional)
Step 5: 不足時の動作
-
警告メッセージを表示
- ✅必須項目の不足 → ⚠️ 警告
- ℹ️推奨項目の不足 → ℹ️ 情報表示(警告ではない)
-
設計書の「前提条件」セクションに品質インフラ要件を追記
- 言語別の必須項目と推奨項目をリスト化
-
処理は継続(中断しない)
Michi Extension: Next Phase Guidance
設計ドキュメント生成完了後、以下のフローを案内:
Next Phase: Phase 0.3 - テストタイプの選択
設計が完了したら、タスク生成前に Phase 0.3-0.4: テスト計画 を実施してください。
1. Phase 0.3: テストタイプの選択
設計書の Testing Strategy セクションを基に、必要なテストタイプを決定します。
実行方法:
推奨: 統合AIコマンド
/michi:test-planning {feature-name}
Phase 0.3とPhase 0.4を統合的に実行します。AIが対話的にテストタイプを選択し、テスト仕様書を作成します。
選択可能なテストタイプ:
- 単体テスト (Unit Test)
- 統合テスト (Integration Test)
- E2Eテスト (End-to-End Test)
- パフォーマンステスト (Performance Test)
- セキュリティテスト (Security Test)
参照ドキュメント: docs/user-guide/testing/test-planning-flow.md
2. Phase 0.4: テスト仕様書の作成
Phase 0.3で選択したテストタイプに基づいて、テスト仕様書を作成します。
実行方法:
/michi:test-planning を使用した場合、Phase 0.4も自動的に実行されます。
テンプレート:
- 単体テスト:
docs/user-guide/templates/test-specs/unit-test-spec-template.md - 統合テスト:
docs/user-guide/templates/test-specs/integration-test-spec-template.md - E2Eテスト:
docs/user-guide/templates/test-specs/e2e-test-spec-template.md - パフォーマンステスト:
docs/user-guide/templates/test-specs/performance-test-spec-template.md - セキュリティテスト:
docs/user-guide/templates/test-specs/security-test-spec-template.md
出力先: .michi/specs/{feature}/test-specs/
After Test Planning: Task Generation
Phase 0.3-0.4 完了後、以下のステップに進んでください:
推奨フロー:
/michi:validate-design {feature}で設計レビューを実施(任意)/michi:spec-tasks {feature}でタスク生成
クイックフロー:
/michi:spec-tasks {feature} -yで自動承認してタスク生成
重要: テスト計画(Phase 0.3-0.4)を完了してからタスク生成することで、実装タスクにテスト実装が適切に含まれます。
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-design を拡張し、Michi 固有のテスト計画フロー(Phase 0.3-0.4)を Next Phase として案内します。
Michi: Spec Implementation with Quality Automation
Base Command Reference
@.claude/commands/kiro/spec-impl.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Quality Automation & Parallel Execution
このコマンドは cc-sdd 標準の /kiro:spec-impl を拡張し、以下のMichi固有機能を追加します:
追加機能
- 事前品質監査(Phase 1): サブエージェント並行実行でライセンス・バージョンリスクを早期検出
- 自動修正ループ(Phase 2): type-check、lint、test を自動修正(最大5回)
- 事後品質レビュー(Phase 3): コードレビュー、デザインレビュー(Frontend時)
- 最終品質ゲート(Phase 4): カバレッジ95%以上、Mutation Testing(オプション)
- タスク完了マーク(Phase 4.5): tasks.mdのチェックボックス更新
- タスク完了後の処理(Phase 5): スペックのarchive移動を確認・実行
コマンドシグネチャ
/michi:spec-impl <feature-name> [task-numbers] [options]
Arguments:
feature-name 機能名(必須)
task-numbers タスク番号(オプション、例: "1.1" or "1,2,3")
Options:
--mutation Mutation Testing を実行(Phase 4)
--skip-license ライセンスチェックをスキップ
--skip-version バージョンチェックをスキップ
--skip-design デザインレビューをスキップ(Frontend検出時)
実行フロー
Phase 0: コンテキストロード(kiro:spec-impl継承)
↓
Phase 1: 事前品質監査(Michi拡張)
├─ oss-license-checker(並行)
├─ stable-version-auditor(並行)
└─ Frontend検出判定(並行)
↓
Phase 2: TDD実装サイクル(kiro:spec-impl継承 + 自動修正ループ拡張)
RED → GREEN → REFACTOR → VERIFY(最大5回)
↓
Phase 3: 事後品質レビュー(Michi拡張)
├─ コードレビュー(常に)
└─ デザインレビュー(Frontend時のみ)
↓
Phase 4: 最終検証(Michi拡張)
type-check + lint + test + coverage 95% + Mutation Testing(オプション)
↓
Phase 4.5: タスク完了マーク(Michi拡張)
tasks.md のチェックボックス更新
↓
Phase 4.6: Progress Check Guidance(Michi拡張)
/kiro:spec-status の自動案内表示
↓
Phase 5: タスク完了後の処理(Michi拡張)
Archive確認 → ユーザー選択 → Archive実行 or スキップ
Phase 1: 事前品質監査(Michi拡張)
目的
実装前にライセンス・バージョンリスクを早期検出し、Critical問題を解決する。
実行手順
Step 1.1: オプション解析
SKIP_LICENSE=false
SKIP_VERSION=false
SKIP_DESIGN=false
MUTATION=false
if echo "$@" | grep -q -- '--skip-license'; then
SKIP_LICENSE=true
fi
if echo "$@" | grep -q -- '--skip-version'; then
SKIP_VERSION=true
fi
if echo "$@" | grep -q -- '--skip-design'; then
SKIP_DESIGN=true
fi
if echo "$@" | grep -q -- '--mutation'; then
MUTATION=true
fi
# レポート出力用の変数初期化
COMPLETED_TASKS=0
TOTAL_TASKS=0
OSS_LICENSE_STATUS="UNKNOWN"
VERSION_AUDIT_STATUS="UNKNOWN"
DESIGN_REVIEW_STATUS="SKIPPED"
CODE_REVIEW_CRITICAL=0
DESIGN_REVIEW_CRITICAL=0
Step 1.2: サブエージェント並行起動
重要: 以下の3つのタスクは独立しているため、並行実行する。単一メッセージで複数のTaskツール呼び出しを行う。
## サブエージェント並行起動(Phase 1)
Phase 1では以下の3つのサブエージェントを並行起動する:
### 1. oss-license-checker
```yaml
Task tool:
subagent_type: oss-license-checker
prompt: |
プロジェクトの依存パッケージライセンスを監査してください。
**監査対象**:
- package.json / package-lock.json(Node.js)
- requirements.txt / pyproject.toml(Python)
- build.gradle / pom.xml(Java)
- composer.json(PHP)
**検出すべきライセンス**:
- 🔴 Critical: GPL, AGPL, SSPL → 即時停止
- 🟡 Warning: LGPL, MPL → 警告表示
**出力形式**:
- Critical件数: X件
- Warning件数: Y件
- 代替パッケージ提案(Critical時)
2. stable-version-auditor
Task tool:
subagent_type: stable-version-auditor
prompt: |
プロジェクトの技術スタックバージョンを監査してください。
**監査対象**:
- Node.js version(package.json, .nvmrc, Dockerfile)
- Python version(pyproject.toml, .python-version)
- Java version(pom.xml, build.gradle)
**検出すべきリスク**:
- 🔴 Critical: EOL済み → 即時停止
- 🟡 Warning: EOL 6ヶ月以内 → 警告表示
- 🟢 Info: 最新LTSでない → 情報表示
**出力形式**:
- Critical件数: X件
- Warning件数: Y件
- アップグレードパス提案(Critical時)
3. Frontend検出
# Frontend変更を検出
FRONTEND_DETECTED=false
# 対象ファイル拡張子
if find . -type f \( \
-name "*.tsx" -o \
-name "*.jsx" -o \
-name "*.vue" -o \
-name "*.svelte" \
\) | head -1 | grep -q .; then
FRONTEND_DETECTED=true
fi
# CSSファイル
if find . -type f \( \
-name "*.css" -o \
-name "*.scss" -o \
-name "*.sass" -o \
-name "*.less" \
\) | head -1 | grep -q .; then
FRONTEND_DETECTED=true
fi
# Tailwind設定
if [ -f "tailwind.config.js" ] || [ -f "tailwind.config.ts" ]; then
FRONTEND_DETECTED=true
fi
# Frontendディレクトリ
if [ -d "components" ] || [ -d "pages" ] || [ -d "views" ]; then
FRONTEND_DETECTED=true
fi
echo "Frontend detected: $FRONTEND_DETECTED"
サブエージェント結果の集約
# サブエージェント実行完了後、結果を変数に格納
# oss-license-checker の結果
OSS_LICENSE_CRITICAL=$(cat /tmp/oss-license-result.json 2>/dev/null | jq -r '.critical_count // 0')
OSS_LICENSE_WARNING=$(cat /tmp/oss-license-result.json 2>/dev/null | jq -r '.warning_count // 0')
# stable-version-auditor の結果
VERSION_AUDIT_CRITICAL=$(cat /tmp/version-audit-result.json 2>/dev/null | jq -r '.critical_count // 0')
VERSION_AUDIT_WARNING=$(cat /tmp/version-audit-result.json 2>/dev/null | jq -r '.warning_count // 0')
# デフォルト値の設定(ファイルが存在しない場合)
OSS_LICENSE_CRITICAL=${OSS_LICENSE_CRITICAL:-0}
OSS_LICENSE_WARNING=${OSS_LICENSE_WARNING:-0}
VERSION_AUDIT_CRITICAL=${VERSION_AUDIT_CRITICAL:-0}
VERSION_AUDIT_WARNING=${VERSION_AUDIT_WARNING:-0}
echo "📊 Subagent Results:"
echo " - OSS License: Critical=$OSS_LICENSE_CRITICAL, Warning=$OSS_LICENSE_WARNING"
echo " - Version Audit: Critical=$VERSION_AUDIT_CRITICAL, Warning=$VERSION_AUDIT_WARNING"
Step 1.2.5: 品質インフラチェック(多言語対応版)
優先度制御の仕組み: このMichi Extensionの品質インフラチェックは、base command(kiro版)のNode.js固有チェックより優先されます。
上書きメカニズム:
- Phase 1.2.5で多言語対応チェックを先に実行 - このセクションで言語検出と言語別チェックを完了します
- Base Commandの実行を条件付きスキップ - Michi版のチェックが完了済みの場合、base commandの品質インフラチェックステップは実行されません
- 結果の一元管理 - Michi版で収集した
INFRA_MISSING配列などの変数を、base commandのフローでも参照可能にします重複実行の防止:
- Michi版でチェック済みフラグ(
MICHI_INFRA_CHECK_DONE=true)を設定- Base commandはこのフラグを確認し、trueの場合は品質インフラチェックをスキップ
- これにより、Node.js固有チェックとの二重実行を回避します
実装前に、プロジェクトの言語を検出し、言語別の品質インフラ設定をチェックします。
Step 1: CI設定の確認
# CI設定を確認
CI_PLATFORM="none"
if [ -d ".github/workflows" ]; then
CI_PLATFORM="GitHub Actions"
elif [ -f "screwdriver.yaml" ]; then
CI_PLATFORM="Screwdriver"
fi
echo "📋 CI Platform: $CI_PLATFORM"
Step 2: 言語検出(複数言語プロジェクト対応)
# 言語検出(複数言語が存在する場合は全て検出)
DETECTED_LANGS=()
if [ -f "package.json" ]; then
DETECTED_LANGS+=("Node.js")
fi
if [ -f "pom.xml" ] || [ -f "build.gradle" ] || [ -f "build.gradle.kts" ]; then
DETECTED_LANGS+=("Java")
fi
if [ -f "pyproject.toml" ] || [ -f "requirements.txt" ]; then
DETECTED_LANGS+=("Python")
fi
if [ -f "composer.json" ]; then
DETECTED_LANGS+=("PHP")
fi
# 主要言語の判定(複数言語が検出された場合)
if [ ${#DETECTED_LANGS[@]} -eq 0 ]; then
DETECTED_LANG="unknown"
echo "⚠️ No supported language detected"
elif [ ${#DETECTED_LANGS[@]} -eq 1 ]; then
DETECTED_LANG="${DETECTED_LANGS[0]}"
echo "🔍 Detected Language: $DETECTED_LANG"
else
# 複数言語検出時は優先度順に主要言語を決定
# 優先度: Node.js > Java > Python > PHP
echo "🔍 Multiple languages detected: ${DETECTED_LANGS[*]}"
# 優先度順にチェック
if [[ " ${DETECTED_LANGS[*]} " =~ " Node.js " ]]; then
DETECTED_LANG="Node.js"
elif [[ " ${DETECTED_LANGS[*]} " =~ " Java " ]]; then
DETECTED_LANG="Java"
elif [[ " ${DETECTED_LANGS[*]} " =~ " Python " ]]; then
DETECTED_LANG="Python"
elif [[ " ${DETECTED_LANGS[*]} " =~ " PHP " ]]; then
DETECTED_LANG="PHP"
fi
echo " → Primary language (for infra check): $DETECTED_LANG"
echo " → Note: All detected languages will be included in quality checks"
fi
# 変数初期化(言語不明の場合でもStep 4でエラーにならないように)
INFRA_MISSING=()
INFRA_OPTIONAL_MISSING=()
INFRA_RECOMMENDED_MISSING=()
DEVCONTAINER_MISSING=false
Step 3: 言語別チェック実行
Note: 各言語のチェックブロックは現在、同様のパターンを繰り返しています。 将来的なリファクタリング案:
- 言語別チェック関数(
check_nodejs_infra(),check_java_infra()等)を抽出- 共通の結果フォーマットを定義
- メイン処理で言語に応じて適切な関数を呼び出す
- これにより、新しい言語追加時の複雑性も軽減される
Node.js の場合
if [ "$DETECTED_LANG" = "Node.js" ]; then
INFRA_MISSING=()
INFRA_RECOMMENDED_MISSING=()
# 必須チェック
[ ! -d ".husky" ] && INFRA_MISSING+=("husky")
[ ! -f ".husky/pre-commit" ] && INFRA_MISSING+=("pre-commit hook")
# lint-staged チェック(jq使用、フォールバックあり)
if command -v jq >/dev/null 2>&1 && [ -f "package.json" ]; then
if ! jq -e '.dependencies["lint-staged"] // .devDependencies["lint-staged"] // ."lint-staged"' package.json >/dev/null 2>&1 && \
! ls .lintstagedrc* >/dev/null 2>&1; then
INFRA_MISSING+=("lint-staged")
fi
else
# jq が利用できない場合はgrep方式にフォールバック
if ! grep -q "lint-staged" package.json 2>/dev/null && ! ls .lintstagedrc* 2>/dev/null | grep -q .; then
INFRA_MISSING+=("lint-staged")
fi
fi
# TypeScript strict チェック(jq使用、フォールバックあり)
if command -v jq >/dev/null 2>&1 && [ -f "tsconfig.json" ]; then
if ! jq -e '.compilerOptions.strict == true' tsconfig.json >/dev/null 2>&1; then
INFRA_MISSING+=("TypeScript strict")
fi
else
# jq が利用できない場合はgrep方式にフォールバック
if ! grep -q '"strict".*true' tsconfig.json 2>/dev/null; then
INFRA_MISSING+=("TypeScript strict")
fi
fi
[ "$CI_PLATFORM" = "none" ] && INFRA_MISSING+=("CI")
# 推奨チェック(tsarch)
if command -v jq >/dev/null 2>&1 && [ -f "package.json" ]; then
if ! jq -e '.dependencies.tsarch // .devDependencies.tsarch' package.json >/dev/null 2>&1; then
INFRA_RECOMMENDED_MISSING+=("tsarch")
fi
else
# jq が利用できない場合はgrep方式にフォールバック
if ! grep -q "tsarch" package.json 2>/dev/null; then
INFRA_RECOMMENDED_MISSING+=("tsarch")
fi
fi
# DevContainer (任意)
DEVCONTAINER_MISSING=false
[ ! -d ".devcontainer" ] && DEVCONTAINER_MISSING=true
fi
Java の場合
if [ "$DETECTED_LANG" = "Java" ]; then
INFRA_MISSING=()
INFRA_OPTIONAL_MISSING=()
INFRA_RECOMMENDED_MISSING=()
# 必須チェック
if [ ! -f "checkstyle.xml" ] && [ ! -f "pmd.xml" ] && [ ! -d "config/checkstyle" ]; then
INFRA_MISSING+=("Checkstyle/PMD")
fi
# NullAway チェック(Error Prone経由)
# Note: 現在はgrep検索。将来的にはXMLパーサー(xmlstarlet)やGradle parser使用を検討
HAS_NULLAWAY=false
# Maven (pom.xml) チェック - 複数の依存記述パターンに対応
if [ -f "pom.xml" ]; then
# groupId/artifactId形式、コメント内を除外、大小文字区別なし
if grep -i "com\.uber\.nullaway\|nullaway.*artifactId\|error.prone.*core" pom.xml 2>/dev/null | grep -v "<!--" | grep -q "nullaway\|error.prone"; then
HAS_NULLAWAY=true
fi
fi
# Gradle (build.gradle / build.gradle.kts) チェック
if [ "$HAS_NULLAWAY" = false ]; then
for gradle_file in build.gradle build.gradle.kts; do
if [ -f "$gradle_file" ]; then
# dependencies, errorprone(), nullaway() 等のパターン
if grep -i "com\.uber\.nullaway\|nullaway\|errorprone.*nullaway\|error.prone.*core" "$gradle_file" 2>/dev/null | grep -v "//" | grep -q "nullaway\|error.prone"; then
HAS_NULLAWAY=true
break
fi
fi
done
fi
if [ "$HAS_NULLAWAY" = false ]; then
INFRA_MISSING+=("NullAway")
fi
[ "$CI_PLATFORM" = "none" ] && INFRA_MISSING+=("CI")
# オプションチェック(pre-commit / Spotless)
HAS_PRECOMMIT=false
# .pre-commit-config.yaml チェック
if [ -f ".pre-commit-config.yaml" ]; then
HAS_PRECOMMIT=true
# Maven/Gradle の Spotless プラグインチェック
elif [ -f "pom.xml" ] && grep -i "spotless" pom.xml 2>/dev/null | grep -v "<!--" | grep -q "spotless"; then
HAS_PRECOMMIT=true
else
for gradle_file in build.gradle build.gradle.kts; do
if [ -f "$gradle_file" ] && grep -i "spotless\|com\.diffplug\.spotless" "$gradle_file" 2>/dev/null | grep -v "//" | grep -q "spotless"; then
HAS_PRECOMMIT=true
break
fi
done
fi
if [ "$HAS_PRECOMMIT" = false ]; then
INFRA_OPTIONAL_MISSING+=("pre-commit/Spotless")
fi
# 推奨チェック(ArchUnit)
HAS_ARCHUNIT=false
# Maven (pom.xml) チェック
if [ -f "pom.xml" ] && grep -i "archunit\|com\.tngtech\.archunit" pom.xml 2>/dev/null | grep -v "<!--" | grep -q "archunit"; then
HAS_ARCHUNIT=true
else
# Gradle チェック
for gradle_file in build.gradle build.gradle.kts; do
if [ -f "$gradle_file" ] && grep -i "archunit\|com\.tngtech\.archunit" "$gradle_file" 2>/dev/null | grep -v "//" | grep -q "archunit"; then
HAS_ARCHUNIT=true
break
fi
done
fi
if [ "$HAS_ARCHUNIT" = false ]; then
INFRA_RECOMMENDED_MISSING+=("ArchUnit")
fi
# DevContainer (任意)
DEVCONTAINER_MISSING=false
[ ! -d ".devcontainer" ] && DEVCONTAINER_MISSING=true
fi
Python の場合
if [ "$DETECTED_LANG" = "Python" ]; then
INFRA_MISSING=()
INFRA_OPTIONAL_MISSING=()
INFRA_RECOMMENDED_MISSING=()
# 必須チェック(lint/format tools)
HAS_LINT_TOOL=false
if [ -f "pyproject.toml" ] && command -v python3 >/dev/null 2>&1; then
# Python one-linerでpyproject.tomlを解析
if python3 -c "
try:
try:
import tomllib
except ImportError:
import tomli as tomllib
with open('pyproject.toml', 'rb') as f:
data = tomllib.load(f)
tools = data.get('tool', {})
if 'ruff' in tools or 'black' in tools or 'flake8' in tools:
exit(0)
exit(1)
except Exception:
exit(1)
" 2>/dev/null; then
HAS_LINT_TOOL=true
fi
else
# Python3が利用できない場合はgrep方式にフォールバック
if grep -q "ruff\|black\|flake8" pyproject.toml 2>/dev/null; then
HAS_LINT_TOOL=true
fi
fi
if [ "$HAS_LINT_TOOL" = false ] && [ ! -f "setup.cfg" ] && [ ! -f ".flake8" ]; then
INFRA_MISSING+=("lint/format (ruff/black)")
fi
[ "$CI_PLATFORM" = "none" ] && INFRA_MISSING+=("CI")
# オプションチェック(pre-commit)
if [ ! -f ".pre-commit-config.yaml" ]; then
INFRA_OPTIONAL_MISSING+=("pre-commit")
fi
# 推奨チェック(mypy)
HAS_MYPY=false
if [ -f "pyproject.toml" ] && command -v python3 >/dev/null 2>&1; then
if python3 -c "
try:
try:
import tomllib
except ImportError:
import tomli as tomllib
with open('pyproject.toml', 'rb') as f:
data = tomllib.load(f)
if 'mypy' in data.get('tool', {}):
exit(0)
exit(1)
except Exception:
exit(1)
" 2>/dev/null; then
HAS_MYPY=true
fi
else
if grep -q "mypy" pyproject.toml 2>/dev/null; then
HAS_MYPY=true
fi
fi
if [ "$HAS_MYPY" = false ] && [ ! -f "mypy.ini" ] && [ ! -f ".mypy.ini" ]; then
INFRA_RECOMMENDED_MISSING+=("mypy strict")
fi
# 推奨チェック(import-linter)
HAS_IMPORTLINTER=false
if [ -f "pyproject.toml" ] && command -v python3 >/dev/null 2>&1; then
if python3 -c "
try:
try:
import tomllib
except ImportError:
import tomli as tomllib
with open('pyproject.toml', 'rb') as f:
data = tomllib.load(f)
if 'importlinter' in data.get('tool', {}):
exit(0)
exit(1)
except Exception:
exit(1)
" 2>/dev/null; then
HAS_IMPORTLINTER=true
fi
else
if grep -q "importlinter" pyproject.toml 2>/dev/null; then
HAS_IMPORTLINTER=true
fi
fi
if [ "$HAS_IMPORTLINTER" = false ] && [ ! -f ".importlinter" ]; then
INFRA_RECOMMENDED_MISSING+=("import-linter")
fi
# DevContainer (任意)
DEVCONTAINER_MISSING=false
[ ! -d ".devcontainer" ] && DEVCONTAINER_MISSING=true
fi
PHP の場合
if [ "$DETECTED_LANG" = "PHP" ]; then
INFRA_MISSING=()
INFRA_OPTIONAL_MISSING=()
INFRA_RECOMMENDED_MISSING=()
# 必須チェック(PHPStan/php-cs-fixer)
HAS_PHPSTAN=false
# ファイル存在チェック
if [ -f "phpstan.neon" ] || [ -f "phpcs.xml" ]; then
HAS_PHPSTAN=true
# composer.json をjqでパース(フォールバック付き)
elif [ -f "composer.json" ] && command -v jq >/dev/null 2>&1; then
if jq -e '.require["phpstan/phpstan"] // .["require-dev"]["phpstan/phpstan"] // .require["friendsofphp/php-cs-fixer"] // .["require-dev"]["friendsofphp/php-cs-fixer"]' composer.json >/dev/null 2>&1; then
HAS_PHPSTAN=true
fi
# jq が利用できない場合はgrepにフォールバック
elif grep -q "phpstan\|php-cs-fixer" composer.json 2>/dev/null; then
HAS_PHPSTAN=true
fi
if [ "$HAS_PHPSTAN" = false ]; then
INFRA_MISSING+=("PHPStan")
fi
[ "$CI_PLATFORM" = "none" ] && INFRA_MISSING+=("CI")
# オプションチェック(pre-commit)
if [ ! -f "grumphp.yml" ] && [ ! -f "captainhook.json" ] && \
[ ! -f ".pre-commit-config.yaml" ]; then
INFRA_OPTIONAL_MISSING+=("pre-commit/GrumPHP")
fi
# 推奨チェック(deptrac)
HAS_DEPTRAC=false
# ファイル存在チェック
if [ -f "deptrac.yaml" ]; then
HAS_DEPTRAC=true
# composer.json をjqでパース(フォールバック付き)
elif [ -f "composer.json" ] && command -v jq >/dev/null 2>&1; then
if jq -e '.require.deptrac // .["require-dev"].deptrac // .require["qossmic/deptrac-shim"] // .["require-dev"]["qossmic/deptrac-shim"]' composer.json >/dev/null 2>&1; then
HAS_DEPTRAC=true
fi
# jq が利用できない場合はgrepにフォールバック
elif grep -q "deptrac" composer.json 2>/dev/null; then
HAS_DEPTRAC=true
fi
if [ "$HAS_DEPTRAC" = false ]; then
INFRA_RECOMMENDED_MISSING+=("deptrac")
fi
# DevContainer (任意)
DEVCONTAINER_MISSING=false
[ ! -d ".devcontainer" ] && DEVCONTAINER_MISSING=true
fi
Step 4: 結果表示
echo "📋 Quality Infrastructure Check ($DETECTED_LANG detected)"
# 必須項目
if [ ${#INFRA_MISSING[@]} -eq 0 ]; then
echo "✅ All required infrastructure configured"
else
echo "⚠️ Missing required infrastructure:"
for item in "${INFRA_MISSING[@]}"; do
echo " - $item (REQUIRED)"
done
fi
# オプション項目(情報表示のみ)
if [ ${#INFRA_OPTIONAL_MISSING[@]} -gt 0 ]; then
echo "ℹ️ Optional infrastructure (not required):"
for item in "${INFRA_OPTIONAL_MISSING[@]}"; do
echo " - $item (optional)"
done
fi
# 推奨項目(情報表示のみ)
if [ ${#INFRA_RECOMMENDED_MISSING[@]} -gt 0 ]; then
echo "ℹ️ Recommended infrastructure:"
for item in "${INFRA_RECOMMENDED_MISSING[@]}"; do
echo " - $item (recommended)"
done
fi
# DevContainer(任意)
if [ "$DEVCONTAINER_MISSING" = true ]; then
echo "ℹ️ DevContainer: Not configured (optional)"
else
echo "✅ DevContainer: Configured"
fi
# 最終メッセージ
if [ ${#INFRA_MISSING[@]} -gt 0 ]; then
echo ""
echo "⚠️ Warning: Some required quality infrastructure is not configured"
echo " Recommendation: Set up quality infrastructure before implementation"
echo " → See tasks.md for setup instructions (auto-added by spec-tasks)"
echo " → Processing continues"
else
echo ""
echo "✅ Quality infrastructure check passed"
fi
# チェック済みフラグを設定(base commandとの重複実行を防ぐ)
MICHI_INFRA_CHECK_DONE=true
export MICHI_INFRA_CHECK_DONE
Important:
- 必須項目(✅)の不足 → ⚠️ 警告(処理は継続)
- オプション項目(ℹ️)の不足 → 情報表示のみ
- 推奨項目(ℹ️)の不足 → 情報表示のみ
- tasks.md に品質インフラセットアップタスクがあれば、そちらを参照してください
- DevContainerは任意のため、未設定でも問題ありません
Step 1.3: 結果集約とゲート判定
# 結果集約
TOTAL_CRITICAL=0
TOTAL_WARNING=0
# oss-license-checker結果
if [ "$OSS_LICENSE_CRITICAL" -gt 0 ]; then
TOTAL_CRITICAL=$((TOTAL_CRITICAL + OSS_LICENSE_CRITICAL))
fi
# stable-version-auditor結果
if [ "$VERSION_AUDIT_CRITICAL" -gt 0 ]; then
TOTAL_CRITICAL=$((TOTAL_CRITICAL + VERSION_AUDIT_CRITICAL))
fi
# ゲート判定
if [ "$TOTAL_CRITICAL" -gt 0 ]; then
echo "🔴 Critical issues detected: $TOTAL_CRITICAL"
echo ""
echo "以下の対応が必要です:"
echo "1. 禁止ライセンス(GPL/AGPL/SSPL)を使用しているパッケージを代替"
echo "2. EOL済みバージョンをアップグレード"
echo ""
echo "次のアクション:"
echo "A) 代替パッケージ/アップグレードを実施する"
echo "B) 詳細レポートを確認する"
echo "C) 実装を中止する"
# ユーザー確認
read -p "どの対応を希望しますか? (A/B/C): " ACTION
if [ "$ACTION" != "A" ]; then
echo "実装を中止します"
exit 1
fi
else
echo "✅ Phase 1: 事前品質監査 完了(Critical: 0, Warning: $TOTAL_WARNING)"
fi
Phase 2: TDD実装サイクル(自動修正ループ拡張)
目的
kiro:spec-implの基本TDDサイクルに自動修正ループを追加する。
Step 2.1: RED - 失敗するテストを書く
- 次の小さな機能のテストを書く
- テストは失敗する(まだコードが存在しない)
- 説明的なテスト名を使用する
Step 2.2: GREEN - 最小限のコードを書く
- テストを通過させる最もシンプルな実装を行う
- このテストを通過させることだけに集中する
- 過度な設計を避ける
Step 2.3: REFACTOR - クリーンアップ
- コード構造と可読性を改善する
- 重複を削除する
- 適切な設計パターンを適用する
- リファクタリング後もすべてのテストが通過することを確認する
Step 2.4: VERIFY - 品質チェック(自動修正ループ)
# 各タスク実装後、品質チェックを実行
ITERATION=0
MAX_ITERATIONS=5
while [ $ITERATION -lt $MAX_ITERATIONS ]; do
echo "=== 品質チェック(試行 $((ITERATION + 1))/$MAX_ITERATIONS) ==="
# Type Check
if ! npm run type-check 2>&1 | tee /tmp/type-check.log; then
echo "❌ Type check failed"
TYPE_CHECK_FAILED=true
else
echo "✅ Type check passed"
TYPE_CHECK_FAILED=false
fi
# Lint
if ! npm run lint 2>&1 | tee /tmp/lint.log; then
echo "❌ Lint failed"
LINT_FAILED=true
else
echo "✅ Lint passed"
LINT_FAILED=false
fi
# Test
if ! npm run test:run 2>&1 | tee /tmp/test.log; then
echo "❌ Test failed"
TEST_FAILED=true
else
echo "✅ Test passed"
TEST_FAILED=false
fi
# 全て成功したらループ終了
if [ "$TYPE_CHECK_FAILED" = false ] && [ "$LINT_FAILED" = false ] && [ "$TEST_FAILED" = false ]; then
echo "✅ 全ての品質チェックが成功しました"
break
fi
# 自動修正を試行
echo "⚙️ 自動修正を試行します..."
if [ "$LINT_FAILED" = true ]; then
echo "🔧 Lint自動修正を実行"
npm run lint:fix
fi
if [ "$TYPE_CHECK_FAILED" = true ]; then
echo "🔧 型エラーを分析中..."
fi
if [ "$TEST_FAILED" = true ]; then
echo "🔧 テスト失敗を分析中..."
echo "⚠️ 注意: テストは仕様。仕様変更の場合のみテストを修正"
fi
ITERATION=$((ITERATION + 1))
done
# 最大試行回数に達した場合
if [ $ITERATION -eq $MAX_ITERATIONS ]; then
echo "❌ 自動修正ループが最大試行回数($MAX_ITERATIONS)に達しました"
echo ""
echo "以下の問題が残っています:"
[ "$TYPE_CHECK_FAILED" = true ] && echo "- Type check失敗"
[ "$LINT_FAILED" = true ] && echo "- Lint失敗"
[ "$TEST_FAILED" = true ] && echo "- Test失敗"
echo ""
echo "次のアクション:"
echo "A) 手動で修正を続ける"
echo "B) 現在のタスクをスキップ"
echo "C) 実装を中止"
# ユーザー確認
read -p "どの対応を希望しますか? (A/B/C): " ACTION
if [ "$ACTION" = "C" ]; then
echo "実装を中止します"
exit 1
fi
fi
Phase 3: 事後品質レビュー(Michi拡張)
目的
実装完了後、コードレビューとデザインレビュー(Frontend時)を実行する。
Step 3.1: コードレビュー(常に実行)
## コードレビュー実行
Task tool:
subagent_type: review-cq
prompt: |
実装完了したコードをレビューしてください。
**レビュー対象機能**: $1
**レビュー観点**:
- コード品質: 可読性、保守性、DRY原則
- セキュリティ: 入力検証、XSS、SQLインジェクション
- パフォーマンス: アルゴリズム効率、メモリ使用量
- テスト: テストカバレッジ、テストの質
**重要度分類**:
- 🔴 Critical: 即時修正必須
- 🟡 Warning: 対応推奨
- 🟢 Info: 改善提案
**出力形式**:
- Critical件数: X件
- Warning件数: Y件
- 修正推奨箇所の詳細リスト
Step 3.2: デザインレビュー(Frontend検出時のみ)
# Frontend検出結果に基づいて実行
if [ "$FRONTEND_DETECTED" = true ] && [ "$SKIP_DESIGN" = false ]; then
echo "=== Frontend変更を検出 → デザインレビューを実行 ==="
Task tool:
subagent_type: design-reviewer
prompt: |
Frontend実装をレビューしてください。
**レビュー対象URL**: http://localhost:3000(開発サーバーが起動している前提)
**レビュー観点**:
- アクセシビリティ(WCAG 2.1)
- レスポンシブデザイン(375px, 768px, 1280px)
- UXパターン
- パフォーマンス(Core Web Vitals)
**実行手順**:
1. Playwright MCPでページアクセス
2. 各ブレークポイントでスクリーンショット取得
3. アクセシビリティツリー分析
4. コントラスト比チェック
5. LCP/CLS測定
**出力先**: docs/tmp/design-review-report.md
else
echo "✅ Frontend変更なし → デザインレビューをスキップ"
fi
Step 3.3: レビューループ(最大5回)
# レビュー結果に基づいて自動修正
REVIEW_ITERATION=0
MAX_REVIEW_ITERATIONS=5
while [ $REVIEW_ITERATION -lt $MAX_REVIEW_ITERATIONS ]; do
echo "=== レビュー修正(試行 $((REVIEW_ITERATION + 1))/$MAX_REVIEW_ITERATIONS) ==="
# コードレビュー結果
CODE_REVIEW_CRITICAL=$(cat /tmp/code-review.json | jq '.critical_count')
# デザインレビュー結果(Frontend時のみ)
if [ "$FRONTEND_DETECTED" = true ]; then
DESIGN_REVIEW_CRITICAL=$(cat /tmp/design-review.json | jq '.critical_count')
else
DESIGN_REVIEW_CRITICAL=0
fi
# Critical問題がなければループ終了
if [ "$CODE_REVIEW_CRITICAL" -eq 0 ] && [ "$DESIGN_REVIEW_CRITICAL" -eq 0 ]; then
echo "✅ レビュー完了(Critical: 0)"
break
fi
# 自動修正を試行
echo "⚙️ レビュー指摘事項を自動修正中..."
REVIEW_ITERATION=$((REVIEW_ITERATION + 1))
done
# 最大試行回数に達した場合
if [ $REVIEW_ITERATION -eq $MAX_REVIEW_ITERATIONS ]; then
echo "❌ レビュー修正ループが最大試行回数($MAX_REVIEW_ITERATIONS)に達しました"
echo ""
echo "次のアクション:"
echo "A) 手動で修正を続ける"
echo "B) 残りの問題を後回しにして続行"
echo "C) 実装を中止"
# ユーザー確認
read -p "どの対応を希望しますか? (A/B/C): " ACTION
if [ "$ACTION" = "C" ]; then
echo "実装を中止します"
exit 1
fi
fi
Phase 4: 最終検証(Michi拡張)
目的
全品質基準を最終確認する。カバレッジ95%以上、Mutation Testing(オプション)を実施。
Step 4.1: 品質チェック最終実行
echo "=== Phase 4: 最終検証 ==="
# 言語検出
LANGUAGE="unknown"
if [ -f "package.json" ]; then
LANGUAGE="nodejs"
elif [ -f "build.gradle" ]; then
LANGUAGE="java"
elif [ -f "pyproject.toml" ]; then
LANGUAGE="python"
elif [ -f "composer.json" ]; then
LANGUAGE="php"
fi
echo "🔍 Detected language: $LANGUAGE"
# 言語別品質チェック
case "$LANGUAGE" in
nodejs)
echo "▶ Running Node.js quality checks..."
npm run type-check
if [ $? -ne 0 ]; then
echo "❌ Type check failed"
exit 1
fi
npm run lint
if [ $? -ne 0 ]; then
echo "❌ Lint failed"
exit 1
fi
npm run test:coverage
if [ $? -ne 0 ]; then
echo "❌ Test failed"
exit 1
fi
COVERAGE=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
;;
java)
echo "▶ Running Java quality checks..."
./gradlew check
if [ $? -ne 0 ]; then
echo "❌ Gradle check failed"
exit 1
fi
if [ -f "build/reports/jacoco/test/jacocoTestReport.xml" ]; then
COVERAGE=$(grep -oP '<counter type="LINE"\s+missed="\K[0-9]+|covered="\K[0-9]+' build/reports/jacoco/test/jacocoTestReport.xml | \
awk 'NR==1{m=$1} NR==2{c=$1} END {if(m+c>0) printf "%.1f", c*100/(m+c); else print 100}')
else
echo "⚠ JaCoCo report not found, skipping coverage check"
COVERAGE=100
fi
;;
python)
echo "▶ Running Python quality checks..."
pytest --cov=. --cov-report=json --cov-fail-under=95
if [ $? -ne 0 ]; then
echo "❌ Pytest failed"
exit 1
fi
COVERAGE=$(cat coverage.json | jq '.totals.percent_covered')
;;
php)
echo "▶ Running PHP quality checks..."
./vendor/bin/phpunit --coverage-clover=coverage/clover.xml
if [ $? -ne 0 ]; then
echo "❌ PHPUnit failed"
exit 1
fi
if [ -f "coverage/clover.xml" ]; then
TOTAL_STATEMENTS=$(grep -oP '<metrics.*?statements="\K[0-9]+' coverage/clover.xml | awk '{sum+=$1} END {print sum}')
COVERED_STATEMENTS=$(grep -oP '<metrics.*?coveredstatements="\K[0-9]+' coverage/clover.xml | awk '{sum+=$1} END {print sum}')
if [ -n "$TOTAL_STATEMENTS" ] && [ "$TOTAL_STATEMENTS" -gt 0 ]; then
COVERAGE=$(echo "scale=1; $COVERED_STATEMENTS * 100 / $TOTAL_STATEMENTS" | bc)
else
COVERAGE=100
fi
else
echo "⚠ Clover report not found, skipping coverage check"
COVERAGE=100
fi
;;
*)
echo "❌ Unsupported language: $LANGUAGE"
exit 1
;;
esac
# カバレッジ判定(95%以上)
if (( $(echo "$COVERAGE < 95" | bc -l) )); then
echo "❌ Coverage failed: ${COVERAGE}% (required: 95%)"
exit 1
else
echo "✅ Coverage passed: ${COVERAGE}%"
fi
Step 4.2: Mutation Testing(オプション)
if [ "$MUTATION" = true ]; then
echo "=== Mutation Testing ==="
case "$LANGUAGE" in
nodejs)
echo "🔍 Node.js/TypeScript → Stryker"
npx stryker run
MUTATION_SCORE=$(cat reports/mutation/mutation.json | jq '.mutationScore')
;;
java)
echo "🔍 Java → PITest"
./gradlew pitest
MUTATION_SCORE=$(cat build/reports/pitest/index.html | grep -oP 'mutation score: \K[0-9]+')
;;
python)
echo "🔍 Python → mutmut"
mutmut run
MUTATION_SCORE=$(mutmut show | grep -oP 'score: \K[0-9]+')
;;
php)
echo "🔍 PHP → Infection"
./vendor/bin/infection
MUTATION_SCORE=$(cat infection.json | jq '.mutation_score')
;;
*)
echo "❌ Mutation Testing not supported for: $LANGUAGE"
exit 1
;;
esac
# Mutation Score判定(80%以上)
if (( $(echo "$MUTATION_SCORE < 80" | bc -l) )); then
echo "❌ Mutation Testing failed: ${MUTATION_SCORE}% (required: 80%)"
exit 1
else
echo "✅ Mutation Testing passed: ${MUTATION_SCORE}%"
fi
fi
Step 4.3: 最終レポート出力
echo ""
echo "======================================"
echo " /michi:spec-impl 実行結果"
echo "======================================"
echo ""
echo "## サマリー"
echo "- 機能名: $1"
echo "- 実行タスク: ${COMPLETED_TASKS}/${TOTAL_TASKS} 完了"
echo "- 最終ステータス: SUCCESS"
echo ""
echo "## 事前監査結果"
echo "- OSS License: ${OSS_LICENSE_STATUS}"
echo "- Version Audit: ${VERSION_AUDIT_STATUS}"
echo "- Frontend検出: ${FRONTEND_DETECTED}"
echo ""
echo "## 品質チェック結果"
echo "- Type Check: PASS"
echo "- Lint: PASS"
echo "- Test: PASS (Coverage: ${COVERAGE}%)"
echo "- Code Review: PASS"
echo "- Design Review: ${DESIGN_REVIEW_STATUS}"
if [ "$MUTATION" = true ]; then
echo "- Mutation Testing: PASS (Score: ${MUTATION_SCORE}%)"
fi
echo ""
echo "======================================"
Phase 4.5: タスク完了マーク(Michi拡張)
目的
各タスク実装完了後、tasks.mdのチェックボックスを更新してタスクの進捗を記録する。
Step 4.5.1: MARK COMPLETE - tasks.md更新
# 品質チェックが成功したら、tasks.mdを更新
echo "=== タスク完了をマーク ==="
# tasks.mdのチェックボックスを更新
# - [ ] タスク名 → - [x] タスク名
TASK_FILE=".michi/specs/$1/tasks.md"
if [ -f "$TASK_FILE" ]; then
# 現在のタスク番号に対応する行を更新
# 例: "- [ ] 1.1 タスク説明" → "- [x] 1.1 タスク説明"
sed -i '' "s/- \[ \] $TASK_NUMBER/- [x] $TASK_NUMBER/" "$TASK_FILE"
echo "✅ tasks.md を更新しました: タスク $TASK_NUMBER を完了"
else
echo "⚠️ tasks.mdが見つかりません: $TASK_FILE"
fi
重要: タスクが完了したら、必ずtasks.mdのチェックボックスを更新する。
- 未完了:
- [ ] - 完了済:
- [x]
Phase 5: タスク完了後の処理(Michi拡張)
目的
すべてのタスクが完了した場合、スペックをarchiveに移動する。
Step 5.1: Archive確認とプロンプト
echo ""
echo "======================================"
echo " タスク完了確認"
echo "======================================"
echo ""
echo "すべてのタスクが完了しました。"
echo ""
echo "次のアクション:"
echo "A) スペックをarchiveに移動する(推奨)"
echo "B) 追加のタスクを実行する"
echo "C) 何もしない"
echo ""
# ユーザー確認
# 注: AskUserQuestionツールが利用可能な場合は、そちらを優先使用すること
read -p "どの対応を希望しますか? (A/B/C): " ARCHIVE_ACTION
if [ "$ARCHIVE_ACTION" = "A" ]; then
echo "🗃️ スペックをarchiveに移動します..."
npx @sk8metal/michi-cli spec:archive $1
if [ $? -eq 0 ]; then
echo "✅ スペックをarchiveに移動しました"
echo ""
echo "Archive先: .michi/specs/.archive/$1/"
echo "- spec.json"
echo "- requirements.md"
echo "- design.md"
echo "- tasks.md"
echo "- validation-reports/"
else
echo "❌ スペックのarchive移動に失敗しました"
echo "手動で実行する場合: npx @sk8metal/michi-cli spec:archive $1"
fi
elif [ "$ARCHIVE_ACTION" = "B" ]; then
echo "✅ 追加のタスクを実行できます"
echo ""
echo "次のコマンドを実行してください:"
echo "/michi:spec-impl $1 [task-numbers]"
else
echo "✅ スペックはそのままにしておきます"
echo ""
echo "後でarchiveする場合: npx @sk8metal/michi-cli spec:archive $1"
fi
Phase 4.6: Progress Check Guidance(Michi拡張)
目的
タスク完了後、仕様全体の進捗状況を確認するコマンドを自動案内する。
自動表示内容
タスク完了マーク後、以下のガイダンスを自動表示する:
echo ""
echo "========================================"
echo " 📊 Progress Check - 進捗確認"
echo "========================================"
echo ""
echo "タスク完了後、仕様全体の進捗状況を確認できます:"
echo ""
echo "▶ /kiro:spec-status $1"
echo ""
echo "【確認できる内容】"
echo " - Requirements / Design / Tasks の完了率"
echo " - 完了タスク数 / 全タスク数"
echo " - 次に実行すべきアクション"
echo " - ブロッカーや不足要素"
echo ""
echo "========================================"
注意: このガイダンスはユーザー入力を待たずに自動表示し、Phase 5の選択フローに進む。
Step 5.2: Archive後の推奨アクション(参考情報)
スペックをarchiveに移動した後の推奨アクション:
1. **ドキュメント更新**
- CHANGELOG.md に変更内容を記録
- README.md を必要に応じて更新
2. **PR作成**
- 実装ブランチをmainにマージするPRを作成
- Phase Aテスト(unit, lint, build)を実行
3. **リリース準備** (Phase B)
- 統合テスト、E2Eテスト、パフォーマンステスト、セキュリティテストを実行
- `/michi:confluence-sync` でリリース手順書を作成
4. **次の機能開発**
- `/michi:spec-init "description"` で新しいスペックを作成
安全性ルール
必須確認ケース
- Phase 1でCritical検出時: 必ずユーザー確認、代替案提示
- Phase 2で自動修正失敗時: 最大5回試行後、ユーザー確認
- Phase 3でレビュー失敗時: 最大5回修正後、ユーザー確認
- Phase 4でカバレッジ不足時: 即時停止、ユーザー確認
- Phase 5でArchive実行時: 必ずユーザー確認、明示的な承認
禁止事項
- ❌ ユーザー確認なしでのパッケージ変更
- ❌ ユーザー確認なしでのバージョン変更
- ❌ テストの仕様変更(実装に合わせてテストを変更しない)
- ❌ Critical問題を無視して処理を続行
参考資料
Web調査結果(ベストプラクティス)
- TDD Best Practices 2025 - AI活用TDD
- Parallel Testing Guide - 並行実行のベストプラクティス
- AI Agent Orchestration - 並行実行パターン
関連コマンド
/kiro:spec-impl- ベースコマンド(TDD実装)/michi:spec-design- 設計書生成(Phase 0.3-0.4ガイダンス付き)/michi:validate-design- 設計レビュー(テスト計画確認付き)
Michi: Spec Initialization with Integration Setup
Base Command Reference
@.claude/commands/kiro/spec-init.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Next Step Navigation
このコマンドは cc-sdd 標準の /kiro:spec-init を拡張し、Michi ワークフローへのシームレスな統合を提供します。
Michi固有の拡張内容
-
次ステップ案内の変更:
/kiro:spec-requirements→/michi:spec-requirementsに変更- Michiワークフロー全体の案内を追加
-
JIRA/Confluence連携設定の確認:
- 環境変数(ATLASSIAN_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN)のチェック
- 設定済みの場合: 後続フェーズでのJIRA連携を案内
- 未設定の場合: 設定ヒントを表示
Output Description(Michi拡張)
基底コマンドの出力後、以下を追加表示:
echo ""
echo "============================================"
echo " Michi Spec Initialization Complete"
echo "============================================"
echo ""
echo "### 次のステップ"
echo ""
echo "1. **要件定義書を生成**:"
echo " /michi:spec-requirements \$(basename \$(pwd) | sed 's/^.*\///; s/-/_/g')"
echo " ※ ultrathinkが自動有効化され、深い分析が行われます"
echo ""
echo "2. **設計書を生成**:"
echo " /michi:spec-design <feature-name>"
echo ""
echo "---"
# JIRA連携チェック
if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
echo "ℹ️ JIRA連携: 設定済み(タスク生成後にJIRA同期が利用可能)"
else
echo "ℹ️ JIRA連携: 未設定"
echo " 設定方法: docs/guides/atlassian-integration.md を参照"
fi
echo ""
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-init を拡張し、Michi ワークフローへのシームレスな統合とJIRA/Confluence連携設定の確認を追加します。
Michi: Requirements Generation with Ultrathink
Base Command Reference
@.claude/commands/kiro/spec-requirements.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Ultrathink & Enhanced Workflow
このコマンドは cc-sdd 標準の /kiro:spec-requirements を拡張し、以下のMichi固有機能を追加します。
追加機能
-
Ultrathink自動有効化:
- 要件定義は複雑な分析を要するため、extended thinking(ultrathink)をデフォルトで有効化
- より深い分析とより包括的な要件生成を実現
-
JIRA/Confluence連携の事前確認:
- 環境変数チェックを実行し、連携設定状況を表示
- 後続フェーズ(Phase 0.6: JIRA同期)への準備状況を確認
-
次ステップ案内の変更:
/kiro:spec-design→/michi:spec-designに変更- Michiワークフロー全体の案内を追加
環境変数チェック(実行開始時)
echo "=== Michi Requirements Generation ==="
echo ""
# JIRA連携チェック
if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
JIRA_CONFIGURED=true
echo "✅ JIRA連携: 設定済み"
else
JIRA_CONFIGURED=false
echo "⚠️ JIRA連携: 未設定"
echo " ヒント: Phase 0.6(タスクのJIRA同期)を利用する場合は設定が必要です"
echo " 設定方法: docs/guides/atlassian-integration.md"
fi
echo ""
Output Description(Michi拡張)
基底コマンドの出力後、以下を追加表示:
echo ""
echo "============================================"
echo " Michi Requirements Generation Complete"
echo "============================================"
echo ""
echo "### 生成された要件定義書"
echo "\`.michi/specs/$1/requirements.md\`"
echo ""
echo "### 次のステップ"
echo ""
echo "**Requirements Approved の場合**:"
echo "1. **設計書を生成**:"
echo " /michi:spec-design $1"
echo ""
echo "**Modifications Needed の場合**:"
echo "- フィードバックを提供し、再度実行:"
echo " /michi:spec-requirements $1"
echo ""
echo "---"
if [ "$JIRA_CONFIGURED" = "true" ]; then
echo "ℹ️ JIRA連携: 設定済み"
else
echo "ℹ️ JIRA連携: 未設定"
fi
echo "ℹ️ Ultrathink: 有効(深い分析モード)"
echo ""
Safety & Fallback
追加エラーシナリオ
-
Steering Directory Empty:
.michi/steering/ディレクトリが空の場合、警告を表示- 要件品質への影響を通知し、steering作成を推奨
-
Language Undefined:
spec.json.languageが未定義の場合、デフォルトで英語(en)を使用- ユーザーに言語設定を確認
Fallback Strategy
- ultrathink timeout: 長時間処理の場合、中間結果を保存して再開可能に
- 大規模プロジェクト: セクション単位での生成を検討
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-requirements を拡張し、ultrathink自動有効化とJIRA/Confluence連携確認を追加します。
think hard
Michi: Spec Status with Progress Summary
Base Command Reference
@.claude/commands/kiro/spec-status.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Enhanced Progress Reporting
Michiでは、進捗レポートを強化し、以下の追加情報を提供:
拡張レポート項目
-
品質メトリクス:
- テストカバレッジ目標達成率(設計書に記載の場合)
- レビュー完了ステータス
- 技術的負債の有無
-
外部連携ステータス:
- JIRA連携: 同期されたチケット数とステータス
- Confluence連携: ドキュメント同期ステータス
- 最終同期日時
-
タイムライン情報:
- 各Phase完了日時(spec.jsonから取得)
- 平均作業時間(類似spec統計があれば)
- 推定残り時間
出力例(拡張版)
========================================
Spec Status: <feature>
========================================
📊 Progress Overview
Phase: implementation (50%)
Requirements: ✅ Approved
Design: ✅ Approved
Tasks: 12/24 completed
🔍 Quality Metrics
Test Coverage: Target 95% (design.md)
Code Review: Pending
🔗 External Integration
JIRA: 3 tickets synced (2 done, 1 in-progress)
Confluence: Synced 2 days ago
⏱️ Timeline
Started: 2024-01-15
Last Updated: 2024-01-20
📝 Next Actions
1. /michi:spec-impl <feature> - Continue implementation
2. Review PR #123 for Task 5.3
コマンドオプション提案
# すべてのspecのステータス一覧
/michi:spec-status --all
# アーカイブ含む全体進捗
/michi:spec-status --all --include-archived
# JSON出力(CI/CD統合用)
/michi:spec-status <feature> --json
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-status を拡張し、品質メトリクス、外部連携ステータス、タイムライン情報を追加表示します。
Michi: Spec Tasks with JIRA Sync Option
Base Command Reference
@.claude/commands/kiro/spec-tasks.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Quality Infrastructure Check
優先度: このMichi Extensionの指示は、base command(kiro版)の品質インフラチェックより優先されます。 Michi Extensionで言語検出と言語別チェックを実行し、base commandのNode.js固有チェックは上書きされます。
タスク生成前に、プロジェクトの言語を検出し、言語別の品質インフラ設定状況をチェックします。
Step 1: CI設定の確認とプラットフォーム選択
(spec-design.md と同様の手順)
Step 2: 言語検出とユーザー確認
(spec-design.md と同様の手順)
Step 3: 言語別チェック項目
(spec-design.md と同様のチェック項目表を参照)
Step 4: 結果表示フォーマット
(spec-design.md と同様の出力フォーマットを参照)
Step 5: 不足時の動作
-
警告メッセージを表示
- ✅必須項目の不足 → ⚠️ 警告
- ℹ️推奨項目の不足 → ℹ️ 情報表示(警告ではない)
-
tasks.md の先頭に言語別の品質インフラセットアップタスクを自動追加
-
処理は継続(タスク生成を実行)
言語別の自動追加タスク
Node.js の場合
## Quality Infrastructure Setup (Auto-added)
> ⚠️ このタスクは品質インフラチェックにより自動追加されました
以下の品質インフラが未設定です。実装前にセットアップを推奨:
**必須**:
- [ ] husky + lint-staged のセットアップ
- [ ] TypeScript strict mode の有効化 (tsconfig.json)
- [ ] CI の設定 (GitHub Actions or Screwdriver)
**推奨**:
- [ ] tsarch でアーキテクチャテスト追加
### セットアップ手順
#### husky + lint-staged
```bash
npm install --save-dev husky lint-staged
npx husky init
echo "npx lint-staged" > .husky/pre-commit
package.jsonに以下を追加:
"lint-staged": {
"*.{ts,tsx,js,jsx}": ["eslint --fix", "prettier --write"],
"*.{json,md,yml,yaml}": ["prettier --write"]
}
TypeScript strict mode
tsconfig.json:
{
"compilerOptions": {
"strict": true
}
}
tsarch
npm install --save-dev tsarch
src/__tests__/arch/architecture.test.ts:
import { filesOfProject } from 'tsarch';
describe('Architecture', () => {
it('should not have circular dependencies', async () => {
const files = await filesOfProject();
await expect(files).toHaveNoCycles();
});
it('domain should not depend on infrastructure', async () => {
const files = await filesOfProject();
await expect(
files.inFolder('domain')
).toNot.dependOnFiles(
files.inFolder('infrastructure')
);
});
});
Java の場合
## Quality Infrastructure Setup (Auto-added)
> ⚠️ このタスクは品質インフラチェックにより自動追加されました
以下の品質インフラが未設定です。実装前にセットアップを推奨:
**必須**:
- [ ] Checkstyle/PMD の設定
- [ ] NullAway + Error Prone の設定 (Gradle/Maven)
- [ ] CI の設定 (GitHub Actions or Screwdriver)
**推奨**:
- [ ] Spotless プラグインの設定 (フォーマット)
- [ ] ArchUnit でアーキテクチャテスト追加
### セットアップ手順
#### Checkstyle (Gradle)
`build.gradle`:
```groovy
plugins {
id 'checkstyle'
}
checkstyle {
toolVersion = '10.12.0'
configFile = file("config/checkstyle/checkstyle.xml")
}
NullAway + Error Prone (Gradle)
build.gradle:
plugins {
id 'net.ltgt.errorprone' version '3.1.0'
}
dependencies {
errorprone 'com.google.errorprone:error_prone_core:2.23.0'
errorprone 'com.uber.nullaway:nullaway:0.10.15'
}
tasks.withType(JavaCompile).configureEach {
options.errorprone {
check("NullAway", CheckSeverity.ERROR)
option("NullAway:AnnotatedPackages", "com.yourcompany")
}
}
ArchUnit
build.gradle:
dependencies {
testImplementation 'com.tngtech.archunit:archunit-junit5:1.2.0'
}
Spotless (オプション)
build.gradle:
plugins {
id 'com.diffplug.spotless' version '6.23.0'
}
spotless {
java {
googleJavaFormat()
}
}
Python の場合
## Quality Infrastructure Setup (Auto-added)
> ⚠️ このタスクは品質インフラチェックにより自動追加されました
以下の品質インフラが未設定です。実装前にセットアップを推奨:
**必須**:
- [ ] ruff または black の設定 (pyproject.toml)
- [ ] CI の設定 (GitHub Actions or Screwdriver)
**推奨**:
- [ ] pre-commit framework のセットアップ
- [ ] mypy strict mode の設定
- [ ] import-linter でインポート制約検証
### セットアップ手順
#### ruff
`pyproject.toml`:
```toml
[tool.ruff]
line-length = 100
target-version = "py311"
select = ["E", "F", "W", "I", "N"]
[tool.ruff.lint]
ignore = []
mypy strict
pyproject.toml:
[tool.mypy]
strict = true
warn_return_any = true
warn_unused_configs = true
import-linter
pyproject.toml:
[tool.importlinter]
root_package = "your_package"
[[tool.importlinter.contracts]]
name = "Layer dependencies"
type = "layers"
layers = [
"presentation",
"application",
"domain",
]
pre-commit
.pre-commit-config.yaml:
repos:
- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.1.6
hooks:
- id: ruff
args: [--fix]
- id: ruff-format
PHP の場合
## Quality Infrastructure Setup (Auto-added)
> ⚠️ このタスクは品質インフラチェックにより自動追加されました
以下の品質インフラが未設定です。実装前にセットアップを推奨:
**必須**:
- [ ] PHPStan の設定 (phpstan.neon, level=max推奨)
- [ ] CI の設定 (GitHub Actions or Screwdriver)
**推奨**:
- [ ] GrumPHP または Captain Hook のセットアップ
- [ ] deptrac でレイヤー依存検証
### セットアップ手順
#### PHPStan
`phpstan.neon`:
```neon
parameters:
level: max
paths:
- src
- tests
composer.json:
{
"require-dev": {
"phpstan/phpstan": "^1.10"
},
"scripts": {
"phpstan": "phpstan analyse"
}
}
deptrac
deptrac.yaml:
deptrac:
paths:
- ./src
layers:
- name: Presentation
collectors:
- type: className
regex: .*\\Presentation\\.*
- name: Application
collectors:
- type: className
regex: .*\\Application\\.*
- name: Domain
collectors:
- type: className
regex: .*\\Domain\\.*
ruleset:
Presentation:
- Application
Application:
- Domain
Domain: []
GrumPHP (オプション)
grumphp.yml:
grumphp:
tasks:
phpstan:
level: max
composer_normalize: ~
Michi Extension: JIRA Sync Prompt
このコマンドは cc-sdd 標準の /kiro:spec-tasks を拡張し、タスク生成完了後にJIRA同期オプションを提示します。
機能追加内容
-
タスク生成完了後の次ステップ案内:
- JIRA連携が設定されている場合: JIRA同期の選択肢(A/B/C形式)を表示
- JIRA連携が未設定の場合: 実装フェーズへの案内 + JIRA設定ヒントを表示
-
環境変数による条件分岐:
- 以下の環境変数がすべて設定されている場合のみ、JIRA同期の選択肢を表示
ATLASSIAN_URLATLASSIAN_EMAILATLASSIAN_API_TOKEN
タスク生成完了後のフロー
基底コマンド /kiro:spec-tasks によるタスク生成が完了した後、以下のフローを実行してください:
Step 1: 環境変数チェック
# JIRA連携の環境変数をチェック
if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
JIRA_CONFIGURED=true
else
JIRA_CONFIGURED=false
fi
Step 2a: JIRA連携が設定されている場合の表示
JIRA_CONFIGURED=true の場合、以下のメッセージと選択肢を表示:
============================================
タスク生成完了 - JIRA同期オプション
============================================
次のアクション:
A) JIRAにタスクを同期する(推奨: タスク管理を一元化)
→ `michi jira:sync {{FEATURE_NAME}}` を実行
B) JIRAへの同期をスキップして実装に進む
→ `/michi:spec-impl {{FEATURE_NAME}}` を実行
C) 何もせずにこのまま終了する
選択 (A/B/C): _
選択肢の説明:
- A: Epic/Story/Subtaskを自動作成し、タスクをJIRAに同期します
- B: JIRA同期をスキップして直接TDD実装フェーズに進みます
- C: タスク生成のみで終了し、ユーザーが手動で次のステップを選択します
Step 2b: JIRA連携が未設定の場合の表示
JIRA_CONFIGURED=false の場合、以下のメッセージを表示:
============================================
タスク生成完了
============================================
次のステップ:
→ `/michi:spec-impl {{FEATURE_NAME}}` で実装を開始
---
ℹ️ ヒント: JIRA連携を使用すると、タスクを自動的にJIRAに同期できます。
設定方法: 以下の環境変数を .env に追加してください:
- ATLASSIAN_URL=https://your-domain.atlassian.net
- ATLASSIAN_EMAIL=your-email@company.com
- ATLASSIAN_API_TOKEN=your-api-token
詳細はドキュメントを参照: docs/guides/atlassian-integration.md
Michi Extension: Task Diff Size Guidelines
タスク分割時に、各サブタスクの git diff サイズを考慮してください。
推奨サイズ
- 目標: 各サブタスクで 200-400 行の diff
- 最大: 500 行まで(超過時は分割を検討)
- 警告: 400行超過時は分割を推奨
除外対象ファイル(行数カウント対象外)
- ロックファイル: package-lock.json, yarn.lock, pnpm-lock.yaml, composer.lock, Gemfile.lock, poetry.lock, Pipfile.lock, Cargo.lock, go.sum
- 自動生成ファイル: .min.js, .min.css, .map, dist/, build/, coverage/, .next/*, *.d.ts, .generated.ts, snapshots/
分割戦略
タスクが大きすぎる場合の分割方法:
-
水平分割(レイヤー別)
- model/repository → service/logic → controller/handler
- 例: 「User CRUD」→「User model作成」「User service作成」「User controller作成」
-
垂直分割(機能スライス別)
- core機能 → validation → error handling → edge cases
- 例: 「認証機能」→「ログインcore」「バリデーション追加」「エラーハンドリング」
-
フェーズ分割(段階別)
- 基本実装 → テスト追加 → 最適化
- 例: 「検索機能」→「基本検索」「フィルター追加」「パフォーマンス最適化」
タスク生成時の確認事項
タスク分割完了後、以下を確認してください:
- 各サブタスクの予想diff行数が500行以内か
- 大きなサブタスクは適切に分割されているか
- ロックファイルや自動生成ファイルを含むタスクはその旨が明記されているか
実装上の注意点
-
基底コマンドの実行結果を維持:
/kiro:spec-tasksの「Output Description」セクションで出力されるタスクサマリーは維持してください- Michi Extensionの選択肢はその後に追加で表示します
-
言語設定の考慮:
- メッセージは日本語固定(将来的にspec.jsonの言語設定に対応する可能性あり)
-
ユーザーインタラクション:
- 選択肢を表示した後、ユーザーの入力を待ちます
- 選択に応じて適切なコマンド/処理を案内または実行してください
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:spec-tasks を拡張し、Phase 0.6(JIRA同期)への誘導を Next Phase として案内します。また、タスク粒度ガイドライン(git diff 500行制限)を提供し、適切なタスク分割を支援します。
Michi: Custom Steering with Template Suggestions
Base Command Reference
@.claude/commands/kiro/steering-custom.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Smart Template Recommendations
Custom steering作成時、ドメインに応じたテンプレートを推奨:
ドメイン別テンプレート提案
入力されたドメインから、最適なテンプレートを提案:
| ドメイン | 推奨テンプレート | 用途 |
|---|---|---|
api, rest, graphql | api-standards.md | API設計規約 |
auth, security, permission | authentication.md, security.md | 認証・セキュリティ |
db, database, schema | database.md | DB設計規約 |
deploy, ci, cd | deployment.md | デプロイ戦略 |
error, logging, monitoring | error-handling.md | エラー処理規約 |
test, qa, testing | testing.md | テスト戦略 |
インタラクティブ提案フロー
$ /michi:steering-custom api
📝 Creating custom steering: api
🎯 Suggested templates:
1. api-standards.md (RESTful API design guidelines)
2. security.md (API authentication & authorization)
3. error-handling.md (API error responses)
Would you like to use a template? [y/N]:
テンプレートカスタマイズ
テンプレート使用時、プロジェクト固有の情報を埋め込み:
- プロジェクト名
- 技術スタック(package.jsonから取得)
- 既存のAPI仕様(swagger.yaml等があれば)
出力例
✅ Custom steering created: .michi/steering/api-standards.md
📚 Related templates available:
- .michi/settings/templates/steering-custom/api-standards.md
- .michi/settings/templates/steering-custom/security.md
💡 To add more custom steering:
/michi:steering-custom <another-domain>
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:steering-custom を拡張し、ドメイン別のスマートなテンプレート推奨を追加します。
Michi: Steering with Integration Check
Base Command Reference
@.claude/commands/kiro/steering.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Integration Setup Validation
Steering document作成時、プロジェクトの連携設定を確認:
事前確認
Steering document作成前に、以下をチェック:
-
JIRA/Confluence連携設定:
# 環境変数チェック - ATLASSIAN_URL - ATLASSIAN_EMAIL - ATLASSIAN_API_TOKEN -
.michi/project.json設定:
{ "jiraProjectKeys": ["PROJ"], "confluenceSpaces": { "prd": "PRD", "qa": "QA" } }
Steering作成後の推奨アクション
✅ Steering document created
📚 Next Steps:
1. **Project設定確認**:
/michi:config:check-security
2. **JIRA連携テスト** (設定済みの場合):
michi jira:test-connection
3. **最初のSpec作成**:
/michi:spec-init "feature description"
Integration Setup Guide
連携が未設定の場合、セットアップガイドを提示:
⚠️ JIRA/Confluence integration not configured
To enable integration:
1. Configure environment variables:
/michi:config:init --global-env
2. Update project.json:
/michi:config:init --project
See: docs/guides/atlassian-integration.md
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:steering を拡張し、JIRA/Confluence連携設定の確認と、セットアップガイダンスを追加します。
Michi: Test Planning (Phase 0.3-0.4)
Development Guidelines
{{DEV_GUIDELINES}}
Overview
This command integrates Phase 0.3 (Test Type Selection) and Phase 0.4 (Test Specification Creation) into a single, guided workflow. The AI will help you select appropriate test types based on your design document and create comprehensive test specifications.
Prerequisites
Before running this command, ensure:
- Phase 0.2 (Design) has been completed
.michi/specs/{feature}/design.mdexistsspec.jsonshowsdesign.approved: true
Workflow
Phase 0.3: Test Type Selection
-
Read Design Document
- Load
.michi/specs/{feature}/design.md - Extract Testing Strategy section
- Analyze project requirements to determine appropriate test types
- Load
-
Recommend Test Types Based on the design analysis, recommend appropriate test types:
- Unit Test (単体テスト): Required for all features with business logic
- Integration Test (統合テスト): Required when multiple components interact
- E2E Test: Required for user-facing features
- Performance Test (パフォーマンステスト): Required for APIs or high-load features
- Security Test (セキュリティテスト): Required for authentication, authorization, or data handling features
-
User Selection Use
AskUserQuestionto let the user select which test types to implement:Question: "どのテストタイプを実装しますか?(複数選択可)" Options: - Unit Test (単体テスト) - 推奨 - Integration Test (統合テスト) - 推奨 - E2E Test - 推奨(ユーザー向け機能の場合) - Performance Test (パフォーマンステスト) - Security Test (セキュリティテスト) - 推奨(認証・認可機能の場合)Set
multiSelect: trueto allow multiple selections. -
Save Selection Create
.michi/specs/{feature}/test-type-selection.json:{ "featureName": "{feature}", "selectedTypes": ["unit", "integration", "e2e", "performance", "security"], "timestamp": "2025-12-09T12:00:00Z", "phase": "0.3" }
Phase 0.4: Test Specification Creation
For each selected test type, create a test specification document:
-
Read Template Load the appropriate template from:
- Unit:
docs/user-guide/templates/test-specs/unit-test-spec-template.md - Integration:
docs/user-guide/templates/test-specs/integration-test-spec-template.md - E2E:
docs/user-guide/templates/test-specs/e2e-test-spec-template.md - Performance:
docs/user-guide/templates/test-specs/performance-test-spec-template.md - Security:
docs/user-guide/templates/test-specs/security-test-spec-template.md
- Unit:
-
Extract Design Information From
design.md, extract:- Architecture diagrams
- Component interfaces
- API endpoints
- Data models
- Testing Strategy section
-
Generate Test Specification Use the template structure and design information to create a comprehensive test specification:
- Replace template placeholders with actual feature details
- Generate specific test cases based on requirements and design
- Include requirement traceability IDs
- Add coverage targets (95% for critical code, 80% minimum)
-
Save Test Specification Create
.michi/specs/{feature}/test-specs/{test-type}-test-spec.md:unit-test-spec.mdintegration-test-spec.mde2e-test-spec.mdperformance-test-spec.mdsecurity-test-spec.md
-
Update spec.json Update phase information in
spec.json:{ "phase": "test-planning-completed", "testPlanning": { "phase03Completed": true, "phase04Completed": true, "testTypesSelected": ["unit", "integration", "e2e"], "testSpecsGenerated": ["unit", "integration", "e2e"] } }
Output Structure
After completion, the following structure will be created:
.michi/specs/{feature}/
├── spec.json (updated)
├── requirements.md
├── design.md
├── test-type-selection.json (NEW)
└── test-specs/ (NEW)
├── unit-test-spec.md
├── integration-test-spec.md
├── e2e-test-spec.md
├── performance-test-spec.md (optional)
└── security-test-spec.md (optional)
Next Steps
After completing test planning, guide the user to the next phase:
Recommended: Design Validation (Optional)
/michi:validate-design {feature-name}
This command will:
- Review the design quality
- Verify test planning completion ✅
- Check requirement traceability
Or: Proceed to Task Generation
/michi:spec-tasks {feature-name} [-y]
This will generate implementation tasks based on requirements, design, and test specifications.
Important: Test planning (Phase 0.3-0.4) ensures that test implementation is properly included in the task breakdown, leading to comprehensive TDD implementation.
Error Handling
- Feature not found: Display error and guide user to run
/kiro:spec-initfirst - Design not approved: Display error and guide user to complete Phase 0.2 first
- Template read failure: Use fallback structure and warn user
- User cancels selection: Save partial progress and allow resumption
Michi Extension: This command provides an integrated, AI-guided workflow for test planning that enhances the standard cc-sdd flow.
Michi: Design Validation with Test Planning
Base Command Reference
@.claude/commands/kiro/validate-design.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Test Planning Readiness Check
設計レビューで GO 判定後、Phase 0.3-0.4(テスト計画)が完了しているか確認します。
Post-Validation Checklist
設計が承認された場合(GO Decision)、以下を確認してください:
テスト計画完了確認
-
.michi/specs/$1/test-specs/ディレクトリが存在するか - テスト仕様書が作成されているか(Phase 0.4 完了)
- テストタイプが選択されているか(Phase 0.3 完了)
未完了の場合の推奨アクション:
Phase 0.3-0.4 が未完了の場合は、タスク生成前に完了することを推奨します:
-
Phase 0.3: テストタイプの選択
- 参照:
docs/user-guide/testing/test-planning-flow.md#phase-03-テストタイプの選択 - 設計書の Testing Strategy セクションを基に決定
- 参照:
-
Phase 0.4: テスト仕様書の作成
- テンプレート:
- 単体テスト:
docs/user-guide/templates/test-specs/unit-test-spec-template.md - 統合テスト:
docs/user-guide/templates/test-specs/integration-test-spec-template.md
- 単体テスト:
- 出力先:
.michi/specs/$1/test-specs/
- テンプレート:
-
完了後:
/michi:spec-tasks $1でタスク生成に進む
Next Phase Guidance
テスト計画完了済みの場合:
/michi:spec-tasks $1でタスク生成
テスト計画未完了の場合:
- Phase 0.3-0.4 を実施してから
/michi:spec-tasks $1 - または
/michi:spec-design $1を再実行して Next Phase ガイダンスを確認
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:validate-design を拡張し、Michi 固有のテスト計画完了確認を追加します。
Michi: Gap Analysis with Detailed Report
Base Command Reference
@.claude/commands/kiro/validate-gap.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Enhanced Gap Analysis Report
Gap分析結果を構造化されたレポートで出力:
拡張分析項目
-
コードカバレッジギャップ:
- 要件に対する実装箇所の特定
- 未実装機能の一覧化
- 既存コードの再利用可能性評価
-
アーキテクチャギャップ:
- 設計書との整合性チェック
- 技術的負債の検出
- パフォーマンスボトルネックの可能性
-
テストギャップ:
- テストカバレッジ目標との差異
- 欠けているテストケース
- テスト戦略との整合性
Gap Analysis Report構造
# Gap Analysis Report: <feature>
## Executive Summary
- Total Requirements: 15
- Implemented: 3
- Partial: 5
- Not Implemented: 7
- Gap Score: 47%
## Detailed Gaps
### 1. Feature Gaps
| Requirement ID | Status | Implementation Location | Notes |
|----------------|--------|-------------------------|-------|
| REQ-001 | ✅ Done | src/auth/login.ts:45 | Complete |
| REQ-002 | ⚠️ Partial | src/auth/logout.ts:23 | Missing error handling |
| REQ-003 | ❌ Missing | - | Not implemented |
### 2. Architecture Gaps
- Missing: Database migration strategy
- Inconsistent: Error handling approach
- Technical Debt: Legacy code in auth module
### 3. Test Coverage Gaps
- Unit Tests: 45% (Target: 95%)
- Integration Tests: Missing for auth flow
- E2E Tests: Not implemented
## Recommendations
### Priority 1 (Critical)
1. Implement REQ-003, REQ-005
2. Add error handling to REQ-002
### Priority 2 (Important)
1. Increase unit test coverage to 95%
2. Refactor legacy auth code
### Priority 3 (Nice to Have)
1. Add integration tests
2. Document architecture decisions
JIRA連携オプション
Gap分析結果からJIRAチケットを自動作成:
# Gap分析結果をJIRAチケット化
/michi:validate-gap <feature> --create-jira-tickets
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:validate-gap を拡張し、詳細な構造化レポートとJIRA連携オプションを追加します。
Michi: Implementation Validation with Quality Gates
Base Command Reference
@.claude/commands/kiro/validate-impl.md
Development Guidelines
{{DEV_GUIDELINES}}
Michi Extension: Quality Gates Validation
実装検証時、Michi固有の品質ゲートを適用:
拡張検証項目
-
TDD準拠チェック:
- 全タスクに対応するテストの存在確認
- テストカバレッジ95%達成確認
- テストファーストの原則遵守確認
-
5フェーズ品質自動化チェック:
Phase A: License & Version Audit ├─ OSS License check └─ Dependency version check (LTS/EOL) Phase 1: TDD Implementation ├─ Test coverage >= 95% └─ All tests passing Phase 3: Code Review ├─ PR created └─ Review comments resolved Phase 4: Coverage Validation ├─ Coverage threshold met └─ Critical paths covered Phase B: Archive Preparation ├─ Release notes created └─ Documentation updated -
セキュリティチェック:
- 入力値検証の実装確認
- 認証・認可の実装確認
- セキュアコーディング原則の遵守
Validation Report
# Implementation Validation Report: <feature>
## Quality Gates Status
### ✅ Passed (7/10)
- TDD: All tests passing (1022 tests)
- Coverage: 96% (Target: 95%)
- License Audit: All dependencies compliant
- Code Review: PR #166 merged
- Documentation: README updated
### ⚠️ Warnings (2/10)
- Performance: 3 slow queries detected
- Security: Missing rate limiting on API endpoint
### ❌ Failed (1/10)
- E2E Tests: 2 scenarios not implemented
## Detailed Findings
### Requirements Compliance
| Requirement | Implemented | Tests | Notes |
|-------------|-------------|-------|-------|
| REQ-001 | ✅ | ✅ | Complete |
| REQ-002 | ✅ | ⚠️ | Missing edge case tests |
| REQ-003 | ❌ | ❌ | Not implemented |
### Design Compliance
- Architecture: ✅ Onion Architecture maintained
- API Contracts: ✅ All endpoints match design
- Database Schema: ⚠️ Missing index on users.email
### Task Completion
- Completed: 23/24 tasks
- Remaining: Task 6.4 (E2E tests)
## Recommendations
### Critical (Fix before merge)
1. Implement REQ-003
2. Add missing E2E test scenarios
### Important (Fix in follow-up PR)
1. Add index on users.email
2. Implement rate limiting
3. Optimize slow queries
### Optional
1. Add edge case tests for REQ-002
自動修正コマンド(将来実装予定)
以下のコマンドは現在実装されていませんが、将来のバージョンで追加予定です:
自動修正提案
検出された問題に対する修正コマンドを提案:
# 欠けているテストを生成
/michi:generate-tests <feature> --missing-only
# セキュリティ問題の修正
/michi:fix-security <feature> --auto
# パフォーマンス最適化
/michi:optimize <feature> --slow-queries
Michi 固有機能: このコマンドは cc-sdd 標準の /kiro:validate-impl を拡張し、5フェーズ品質自動化チェック、セキュリティ検証、自動修正提案を追加します。
Sponsors
Details
- Marketplace
- sk8metalme/michi-old
- Source
- plugins/michi
- Category
- Community