
michi
Michi - AI-driven Spec-Driven Development workflow for Claude Code
- version
- 1.6.0
Install
/plugin install michi@sk8metalme-michiRun it inside Claude Code after adding the marketplace with /plugin marketplace add sk8metalme/michi.
Contents
Discovered from sourceSkills 20
analyze-gap: Gap分析
Gap分析スキルは、既存コードベースと新規実装の差分を分析し、統合ポイントを特定します。
概要
このスキルは以下を実行します:
- 既存コードベース分析:
- 既存のアーキテクチャを把握
- 既存のAPI・データモデルを確認
- 新規実装との差分分析:
- 新規実装が既存コードとどのように統合されるか
- 競合する部分を特定
- 統合ポイント特定:
- インターフェースの統合ポイント
- データモデルの統合ポイント
- ワークフローの統合ポイント
- 実装戦略提案:
- 段階的な統合戦略
- リスク回避策
- ロールバック計画
- Gap分析レポート: 分析結果と実装戦略を記載
使用方法
自動発動
以下のキーワードで自動発動します:
- 「Gap分析したい」
- 「既存コードとの統合を分析」
- 既存システムへの新機能追加時に自動提案
明示的発動
/michi analyze-gap {pj-name}
例:
/michi analyze-gap user-auth
サブエージェント活用(並列探索)
既存コードベースの探索を3つのExploreエージェントで並列実行します:
Phase 1: 並列コードベース探索
| エージェント | 対象 | 目的 | 出力 |
|---|---|---|---|
| アーキテクチャ探索 | src/, lib/, packages/ | レイヤー構造、設計パターン特定 | アーキテクチャ構造レポート |
| API探索 | routes/, controllers/, api/ | 既存APIエンドポイント一覧 | API仕様リスト |
| データモデル探索 | models/, entities/, migrations/ | DBスキーマ、リレーション | データモデルリスト |
Phase 2: 統合分析(メインエージェント)
- Phase 1の結果を統合
- 新規実装との差分を分析
- Gap分析レポート生成
メリット:
- コードベース探索を大幅に高速化(並列実行により)
- 複数の観点から並行して分析
- 各エージェントが独立して動作し、結果を統合
実行内容
1. 既存コードベース分析
既存アーキテクチャの把握:
- レイヤー構造
- 使用技術スタック
- 設計パターン
既存API・データモデルの確認:
- REST API エンドポイント一覧
- データベーススキーマ
- 外部サービス連携
2. 新規実装との差分分析
新規実装の影響範囲:
- 新規追加されるAPI
- 新規追加されるテーブル
- 既存APIの変更
競合する部分を特定:
- 既存のユーザー認証と新規実装の認証
- 既存のデータモデルと新規実装のデータモデル
- 既存のワークフローと新規実装のワークフロー
3. 統合ポイント特定
インターフェースの統合ポイント:
- API Gateway との統合
- フロントエンドとの統合
- 外部サービスとの統合
データモデルの統合ポイント:
- 既存テーブルとの外部キー
- 共有されるマスターデータ
- データ移行が必要な部分
ワークフローの統合ポイント:
- 既存の処理フローに新機能を組み込む
- イベント駆動の統合
4. 実装戦略提案
段階的な統合戦略:
- Phase 1: 独立した機能として実装(既存コードに影響なし)
- Phase 2: API統合(新規APIを既存フロントエンドから呼び出し)
- Phase 3: データ統合(既存データと新規データを連携)
- Phase 4: ワークフロー統合(既存処理フローに組み込み)
リスク回避策:
- Feature Flagを使用して段階的にロールアウト
- Blue-Green Deployment で切り替え
- カナリアリリースで段階的に展開
ロールバック計画:
- データベース変更のロールバックスクリプト
- Feature Flagでの機能無効化
- 以前のバージョンへのデプロイ手順
5. Gap分析レポート
分析結果を以下の形式でレポートします:
# Gap分析レポート: {pj-name}
## 既存コードベース
### アーキテクチャ
- Monolithic Architecture
- Backend: Node.js + Express
- Frontend: React + Redux
- Database: PostgreSQL
### 既存API
- POST /api/session - セッション管理
- GET /api/profile - プロフィール取得
### 既存データモデル
- sessions テーブル
- profiles テーブル
## 新規実装との差分
### 新規追加
- POST /api/users - ユーザー登録
- POST /api/login - ログイン
- users テーブル
### 既存APIの変更
- なし
### 競合箇所
- 既存の sessions テーブルと新規の users テーブルの連携
## 統合ポイント
### インターフェース統合
- API Gateway: 既存エンドポイントと新規エンドポイントを統合
- フロントエンド: ログインページから新規ログインAPIを呼び出し
### データモデル統合
- sessions.user_id → users.id の外部キー追加
### ワークフロー統合
- 既存のセッション管理に新規のユーザー認証を組み込み
## 実装戦略
### Phase 1: 独立実装
- users テーブル作成
- POST /api/users, POST /api/login 実装
- 既存コードに影響なし
### Phase 2: API統合
- フロントエンドから新規ログインAPIを呼び出し
- Feature Flag で新旧ログインを切り替え
### Phase 3: データ統合
- sessions.user_id → users.id の外部キー追加
- 既存セッションデータを移行
### Phase 4: ワークフロー統合
- 既存のセッション管理に新規ユーザー認証を完全統合
- 旧ログインAPIを廃止
## リスク回避策
- Feature Flag: `use_new_auth` で新旧切り替え
- Blue-Green Deployment: 問題発生時は即座に切り戻し
- カナリアリリース: 5% → 25% → 50% → 100%
## ロールバック計画
1. Feature Flag で旧ログインに切り戻し
2. 外部キー制約を削除
3. 新規テーブルをドロップ(必要に応じて)
次のステップ
Gap分析が完了したら、次のステップに進みます:
統合戦略に基づいてタスクを分割
/michi create-tasks {pj-name}
段階的に実装
Phase 1から順番に実装し、各Phaseごとに検証します。
/michi dev {pj-name}
参照
- アーキテクチャガイド:
docs/master-docs/structure.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
create-tasks- タスク分割(統合戦略に基づく)dev- TDD実装(段階的に実装)
archive-pj: プロジェクトアーカイブ
プロジェクトアーカイブスキルは、完了したプロジェクトをアーカイブに移動し、作業ディレクトリをクリーンに保ちます。
概要
このスキルは以下を実行します:
- 完了確認: プロジェクトが完了しているか確認
- メタデータ移動:
.michi/pj/YYYYMMDD-{pj-name}/を.michi/archive-pj/{pj-name}-{timestamp}/に移動 - 仕様書保持:
docs/michi/YYYYMMDD-{pj-name}/は Git で管理されたまま保持 - アーカイブ記録: アーカイブ日時をメタデータに記録
使用方法
自動発動
以下のキーワードで自動発動します:
- 「プロジェクトをアーカイブしたい」
- 「完了したのでアーカイブ」
- project.json の
phase: "implementation-complete"の場合
明示的発動
/michi archive-pj {pj-name}
例:
/michi archive-pj user-auth
実行内容
1. 完了確認
以下を確認します:
- プロジェクトのフェーズが
implementation-completeまたは手動アーカイブ許可 - すべてのタスクが完了している
- テストが合格している
2. メタデータ移動
以下のディレクトリを移動します:
移動前:
.michi/pj/YYYYMMDD-{pj-name}/
移動後:
.michi/archive-pj/{pj-name}-{timestamp}/
timestamp: アーカイブ日時(例: 20260117-150000)
3. メタデータ更新
project.json に以下を追加:
{
"archivedAt": "2026-01-17T15:00:00Z",
"archivedBy": "claude-code"
}
4. 仕様書は保持
仕様書(docs/michi/YYYYMMDD-{pj-name}/)は Git で管理されたまま保持されます。
これにより、過去のプロジェクトを参照できます。
次のステップ
アーカイブ後、新しいプロジェクトを開始できます:
/michi launch-pj "新しいプロジェクト説明"
アーカイブ解除
アーカイブされたプロジェクトを復元する場合:
# 手動で .michi/archive-pj/ から .michi/pj/ に移動
mv .michi/archive-pj/{pj-name}-{timestamp} .michi/pj/YYYYMMDD-{pj-name}
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
show-status- ステータス表示(アーカイブ前に確認)launch-pj- 新規プロジェクト初期化(アーカイブ後に実行)switch-pj- プロジェクト切り替え
create-design: 設計書作成
設計書作成スキルは、C4モデルによるアーキテクチャ設計、シーケンス図、データモデルを生成します。
概要
このスキルは以下を実行します:
- 要件定義参照: requirements.md を読み込んで要件を把握
- C4モデル設計: Context, Container, Component, Code の4レベルで設計
- シーケンス図作成: 主要な処理フローをシーケンス図で表現
- データモデル設計: エンティティ、属性、リレーションを定義
- 設計書生成:
docs/michi/YYYYMMDD-{pj-name}/spec/architecture.mddocs/michi/YYYYMMDD-{pj-name}/spec/sequence.mddocs/michi/YYYYMMDD-{pj-name}/spec/design.md
- フェーズ更新: project.json のフェーズを
design-generatedに更新
使用方法
自動発動
以下のキーワードで自動発動します:
- 「設計書を作成したい」
- 「アーキテクチャを設計」
- project.json の
phase: "requirements-generated"の場合
明示的発動
/michi create-design {pj-name}
例:
/michi create-design user-auth
実行内容
1. 要件定義参照
docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md を読み込んで要件を把握します。
2. C4モデル設計
C4モデルの4レベルで設計を行います:
Level 1: Context(コンテキスト図)
- システムの境界を定義
- 外部システムとの関係を明示
Level 2: Container(コンテナ図)
- アプリケーション、データベース、サービスを定義
- コンテナ間の通信を明示
Level 3: Component(コンポーネント図)
- 各コンテナ内のコンポーネントを定義
- コンポーネント間の依存関係を明示
Level 4: Code(コード図)
- クラス構造を定義
- 主要なインターフェースを明示
3. シーケンス図作成
主要な処理フローをMermaidシーケンス図で表現します:
sequenceDiagram
participant User
participant API
participant Auth
participant DB
User->>API: POST /login
API->>Auth: authenticate(credentials)
Auth->>DB: findUser(email)
DB-->>Auth: user
Auth-->>API: token
API-->>User: 200 OK (token)
4. データモデル設計
エンティティ、属性、リレーションを定義します:
## エンティティ
### User
- id: UUID (PK)
- email: String (Unique)
- passwordHash: String
- createdAt: DateTime
- updatedAt: DateTime
### Session
- id: UUID (PK)
- userId: UUID (FK -> User.id)
- token: String (Unique)
- expiresAt: DateTime
5. 設計書生成
以下のファイルを作成します:
- architecture.md: C4モデルによるアーキテクチャ設計
- sequence.md: シーケンス図
- design.md: 詳細設計(データモデル、API仕様、エラーハンドリングなど)
6. フェーズ更新
project.json のフェーズを更新します:
{
"phase": "design-generated",
"updatedAt": "2026-01-17T00:00:00Z"
}
7. TODO抽出の自動提案
設計書生成後、Claude は自動的に TODO 抽出を提案します:
設計書を生成しました。
設計上のリスクや不明点を TODO として管理しますか?
- manage-todos scan {pj-name} を実行
ユーザーが同意した場合、manage-todos scan を実行して、設計書から TODO を抽出します。
次のステップ
設計が完了したら、次のステップに進みます:
推奨: TODO抽出
設計書からリスクや不明点を抽出してTODO管理を更新します。
manage-todos スキルを使用してTODOを抽出します:
/michi manage-todos scan {pj-name}
または自動発動:
TODOを確認したい
抽出対象:
- 設計上のリスク(Risk)
- 技術選定の仮定(Assumption)
- 詳細設計の不明点(Question)
- 技術的負債(Tech Debt)
オプション1: テスト計画
plan-tests スキルを使用してテスト計画を作成します。
/michi plan-tests {pj-name}
オプション2: タスク分割
create-tasks スキルを使用してタスクに分割します。
/michi create-tasks {pj-name}
参照
- C4モデル: https://c4model.com/
- Mermaid構文: https://mermaid.js.org/
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル:
plan-tests- テスト計画作成create-tasks- タスク分割
create-requirements: 要件定義書作成
要件定義書作成スキルは、EARS形式の要件定義を生成し、プロジェクトの要件を明確化します。
概要
このスキルは以下を実行します:
- ultrathink自動有効化: 深い分析のためにultrathinkモードを有効化
- マスタードキュメント参照: プロジェクト横断の共通知識と整合を取る
- EARS形式要件定義: Easy Approach to Requirements Syntax 形式で要件を記述
- 要件定義書生成:
docs/michi/YYYYMMDD-{pj-name}/spec/requirements.mdを作成 - フェーズ更新: project.json のフェーズを
requirements-generatedに更新
使用方法
自動発動
以下のキーワードで自動発動します:
- 「要件定義したい」
- 「要件を作成」
- project.json の
phase: "initialized"の場合
明示的発動
/michi create-requirements {pj-name}
例:
/michi create-requirements user-auth
実行内容
1. ultrathink自動有効化
深い分析のため、ultrathinkモードを自動的に有効化します。
2. マスタードキュメント参照
以下のマスタードキュメントを参照して、プロジェクト横断の整合性を確保します:
docs/master-docs/structure.md- システム構造docs/master-docs/tech.md- 技術スタックdocs/master-docs/product.md- プロダクト要件
3. EARS形式要件定義
EARS(Easy Approach to Requirements Syntax)形式で要件を記述します:
EARS形式のテンプレート:
- Ubiquitous: システムは常に〜すること
- Event-driven: 〜の場合、システムは〜すること
- State-driven: 〜の状態において、システムは〜すること
- Optional: 必要に応じて、システムは〜してもよい
- Unwanted: 〜の場合、システムは〜してはならない
4. 要件定義書生成
docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md を作成します:
# 要件定義書: {pj-name}
## プロジェクト概要
...
## 機能要件
### FR-001: ...
- **種類**: Ubiquitous
- **要件**: システムは常に〜すること
- **優先度**: 高
- **受入条件**: ...
### FR-002: ...
...
## 非機能要件
### NFR-001: パフォーマンス
...
### NFR-002: セキュリティ
...
## 制約条件
...
## 参照
- マスタードキュメント: docs/master-docs/
5. フェーズ更新
project.json のフェーズを更新します:
{
"phase": "requirements-generated",
"updatedAt": "2026-01-17T00:00:00Z"
}
6. TODO抽出の自動提案
要件定義書生成後、Claude は自動的に TODO 抽出を提案します:
要件定義書を生成しました。
不明点や仮定を TODO として管理しますか?
- manage-todos scan {pj-name} を実行
ユーザーが同意した場合、manage-todos scan を実行して、要件定義書から TODO を抽出します。
次のステップ
要件定義が完了したら、次のステップに進みます:
推奨: TODO抽出
要件定義書から不明点や仮定を抽出してTODO管理を開始します。
manage-todos スキルを使用してTODOを抽出します:
/michi manage-todos scan {pj-name}
または自動発動:
TODOを確認したい
抽出対象:
- 「前提条件」セクションの仮定(Assumption)
- 「制約事項」セクションの不明点(Question)
推奨: 設計書作成
create-design スキルを使用して設計書を作成します。
/michi create-design {pj-name}
または自動発動:
設計書を作成したい
参照
- EARS形式ガイドライン:
~/.michi/settings/rules/ears-format.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル: create-design - 設計書作成
create-tasks: タスク分割
タスク分割スキルは、設計を実装可能なタスクに分割し、依存関係をマッピングします。
概要
このスキルは以下を実行します:
- 設計書参照: design.md, architecture.md, test-plan を読み込んで設計を把握
- タスク分割: 1-3日単位のタスクに分割
- 依存関係マッピング: タスク間の依存関係を明示
- 優先度設定: タスクの優先度を設定
- タスク一覧生成:
docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.mdを作成 - フェーズ更新: project.json のフェーズを
tasks-generatedに更新
使用方法
自動発動
以下のキーワードで自動発動します:
- 「タスクに分割したい」
- 「タスク一覧を作成」
- project.json の
phase: "design-generated"またはtest-plan-generatedの場合に自動提案
明示的発動
/michi create-tasks {pj-name}
例:
/michi create-tasks user-auth
サブエージェント活用(Plan + Explore)
タスク分割をPlanエージェントで実行し、設計書読み込みをExploreエージェントに委譲します:
Phase 1: 設計書収集(Explore x 2)
| エージェント | 対象 | 出力 |
|---|---|---|
| 設計書収集 | design.md, architecture.md | 設計サマリー |
| テスト計画収集 | test-plan/strategy.md | テスト戦略サマリー |
Phase 2: タスク分割分析(Plan)
Planエージェントで以下を分析:
- タスクの粒度(1-3日単位)
- 依存関係のトポロジカルソート
- 優先度設定
Phase 3: ファイル生成(メインエージェント)
- tasks.md生成
- project.json更新
Planエージェント活用のメリット:
- タスク分割に特化した分析
- 依存関係の正確なマッピング
- 実装順序の最適化
Exploreエージェント活用のメリット:
- 設計書の高速読み込み
- コンテキスト収集の効率化
実行内容
1. 設計書参照
以下のファイルを読み込んで設計を把握します:
docs/michi/YYYYMMDD-{pj-name}/spec/design.mddocs/michi/YYYYMMDD-{pj-name}/spec/architecture.mddocs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.md
2. タスク分割
1-3日単位のタスクに分割します:
分割原則:
- 粒度: 1タスクは1-3日で完了できる規模
- 独立性: 可能な限り独立して実装できるタスク
- テスト駆動: 各タスクには対応するテストが含まれる
- コードサイズ: 1タスクあたり最大500行の変更(推奨)
3. 依存関係マッピング
タスク間の依存関係を明示します:
## タスク一覧
### TASK-001: データベーススキーマ作成
- **説明**: User テーブルを作成
- **依存**: なし
- **優先度**: 高
- **見積もり**: 1日
### TASK-002: ユーザー登録API実装
- **説明**: POST /api/users エンドポイントを実装
- **依存**: TASK-001
- **優先度**: 高
- **見積もり**: 2日
### TASK-003: ログインAPI実装
- **説明**: POST /api/login エンドポイントを実装
- **依存**: TASK-001, TASK-002
- **優先度**: 高
- **見積もり**: 2日
4. タスク一覧生成
docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.md を作成します:
# タスク一覧: {pj-name}
## プロジェクト概要
...
## タスク依存関係図
```mermaid
graph TD
TASK001[TASK-001: DB Schema]
TASK002[TASK-002: User Registration API]
TASK003[TASK-003: Login API]
TASK004[TASK-004: E2E Test]
TASK001 --> TASK002
TASK001 --> TASK003
TASK002 --> TASK004
TASK003 --> TASK004
タスク一覧
Phase 1: データベース
- TASK-001: データベーススキーマ作成
Phase 2: API実装
- TASK-002: ユーザー登録API実装
- TASK-003: ログインAPI実装
Phase 3: テスト
- TASK-004: E2Eテスト実装
### 5. フェーズ更新
project.json のフェーズを更新します:
```json
{
"phase": "tasks-generated",
"updatedAt": "2026-01-17T00:00:00Z"
}
次のステップ
タスク分割が完了したら、次のステップに進みます:
推奨: TDD実装
dev スキルを使用してTDD実装を開始します。
/michi dev {pj-name}
または自動発動:
実装したい
参照
- コードサイズガイドライン:
../../rules/code-size-rules.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル: dev - TDD実装 + 品質自動化
dev: TDD実装 + 品質自動化
TDD実装 + 品質自動化スキルは、テスト駆動開発(Red-Green-Refactor)サイクルで実装を行い、包括的な品質管理を実施します。
概要
このスキルは以下のフェーズを自動実行します:
Phase 6.1: 実装準備
- タスク一覧を確認
- TODO状況確認(高優先度TODOの警告表示)
- ブランチ作成(feature/{pj-name})
- 実装対象タスクを選択
Phase 6.2: 事前品質監査
- OSS License Check(
oss-license-checkerエージェント) - Version Audit(
stable-version-auditorエージェント) - 問題検出時は修正を実行
Phase 6.3: TDD実装(Red-Green-Refactor)
- Red: テストを先に書く(失敗することを確認)
- Green: 最小限の実装でテストを通す
- Refactor: コードを整理・改善
- 1タスクあたり最大500行の変更を推奨
Phase 6.4: 自動修正ループ(最大5回)
- テスト実行
- 失敗時は自動修正を試行
- 最大5回までループ
- 5回失敗時はユーザーに報告
Phase 6.5: カバレッジ検証
- テストカバレッジを測定
- 95%以上を目標
- 不足時は追加テストを作成
Phase 6.6: Mutation Testing(オプション)
- Stryker / PIT を使用
- Mutation Score 80%以上を目標
Phase 6.7: 事後品質レビュー
- Code Review(
code-reviewエージェント) - Design Review(
design-reviewエージェント) - 問題検出時は修正を実行
Phase 6.8: コミット・PR作成
- git add / git commit
- gh pr create
- CI/CD実行確認
使用方法
自動発動
以下のキーワードで自動発動します:
- 「実装したい」
- 「TDDで実装」
- project.json の
phase: "tasks-generated"の場合に自動提案
明示的発動
/michi dev {pj-name}
例:
/michi dev user-auth
実行内容
Phase 6.1: 実装準備
-
タスク一覧確認:
docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.mdを読み込み- 未完了タスクを表示
-
TODO状況確認:
docs/michi/YYYYMMDD-{pj-name}/todos/todos.mdを読み込み- 未解決の高優先度TODOがある場合は警告表示
⚠️ 警告: 未解決の高優先度TODOがあります TODO-Q-001: 認証トークンの有効期限は何分にすべきか? 実装を続行しますか? ```text - ユーザーが続行を選択した場合のみ次に進む -
タスク選択:
- ユーザーに実装するタスクを選択させる
- 依存関係を確認
-
ブランチ作成:
git checkout -b feature/{pj-name}/{task-id}
Phase 6.2: 事前品質監査
サブエージェント活用(Bashエージェント並行実行):
品質監査を複数のBashエージェントで並行実行します:
| エージェント | タイプ | コマンド | 目的 |
|---|---|---|---|
| ライセンスチェック | Bash | npx license-checker --summary | OSS License 監査 |
| バージョン監査 | Bash | npm outdated --json | EOL/非推奨バージョン検出 |
| 依存脆弱性 | Bash | npm audit --json | 既知脆弱性チェック |
→ Critical検出時は即時停止
実行内容:
-
OSS License Check:
npx license-checker --summaryを実行- 違反ライセンスを検出
- 代替パッケージを提案
-
Version Audit:
npm outdated --jsonを実行- EOLバージョンを検出
- アップグレードを提案
-
問題修正:
- 検出された問題を自動修正
- 修正不可能な場合はユーザーに報告
メリット:
- 複数のnpmコマンドを並行実行
- 品質チェックの待ち時間を大幅短縮
- 各コマンドの結果を独立して評価
Phase 6.3: TDD実装
Red-Green-Refactor サイクル:
-
Red(失敗するテストを書く):
describe('User Registration', () => { it('should create a new user', async () => { const result = await createUser({ email: 'test@example.com', password: 'password123' }); expect(result).toBeDefined(); expect(result.id).toBeDefined(); }); }); -
Green(最小限の実装):
async function createUser(data: CreateUserInput): Promise<User> { // 最小限の実装 const user = await db.users.create(data); return user; } -
Refactor(コード整理):
async function createUser(data: CreateUserInput): Promise<User> { // バリデーション追加 validateEmail(data.email); validatePassword(data.password); // パスワードハッシュ化 const hashedPassword = await hashPassword(data.password); // ユーザー作成 const user = await db.users.create({ ...data, password: hashedPassword }); return user; }
Phase 6.4: 自動修正ループ
テスト実行 → 失敗 → 自動修正 → テスト再実行
(最大5回までループ)
Phase 6.5: カバレッジ検証
サブエージェント活用(Bashエージェント並行実行):
| エージェント | タイプ | コマンド | 目的 |
|---|---|---|---|
| テスト実行 | Bash | npm test -- --coverage | カバレッジ95%以上確認 |
| Mutation Testing | Bash | npx stryker run | テスト品質検証(オプション) |
npm test -- --coverage
カバレッジ目標:
- Statements: 95%以上
- Branches: 90%以上
- Functions: 95%以上
- Lines: 95%以上
メリット:
- カバレッジ測定とMutation Testingを並行実行
- 最終検証の時間を短縮
Phase 6.6: Mutation Testing(オプション)
npx stryker run
Mutation Score目標: 80%以上
Phase 6.7: 事後品質レビュー
-
Code Review:
- コード品質チェック
- セキュリティ脆弱性スキャン
- ベストプラクティス確認
-
Design Review:
- 設計書との整合性確認
- アーキテクチャ原則遵守確認
Phase 6.8: コミット・PR作成
-
コミット:
git add . git commit -m "feat: implement user registration API" -
PR作成:
gh pr create --title "feat: user registration" --body "..." -
CI/CD確認:
- GitHub Actions実行確認
- テスト合格確認
次のステップ
実装完了後、次のステップに進みます:
オプション1: 次のタスクを実装
dev スキルを再度実行して次のタスクを実装します。
/michi dev {pj-name}
オプション2: 実装検証
review-dev スキルを使用して実装を検証します。
/michi review-dev {pj-name}
オプション3: アーカイブ
すべてのタスクが完了したら、プロジェクトをアーカイブします。
/michi archive-pj {pj-name}
コードサイズ監視
code-size-monitor ルールにより、500行を超える変更は警告されます。
大規模な変更の場合は、タスクを分割することを推奨します。
参照
- コードサイズルール:
../../rules/code-size-rules.md - TDDガイドライン:
../references/workflow-guide.md#tdd - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル:
review-dev- 実装検証archive-pj- プロジェクトアーカイブ(完了時)
launch-pj: プロジェクト初期化
プロジェクト初期化スキルは、新しいプロジェクトを開始するための基盤を作成します。
概要
このスキルは以下を実行します:
- 機能名生成: プロジェクト説明から一意の機能名(YYYYMMDD-{pj-name}形式)を生成
- ディレクトリ構造作成:
.michi/pj/YYYYMMDD-{pj-name}/にメタデータディレクトリを作成docs/michi/YYYYMMDD-{pj-name}/に仕様書ディレクトリを作成
- メタデータ初期化:
project.jsonを作成し、フェーズをinitializedに設定 - 次フェーズ準備: 要件定義フェーズに進む準備を完了
使用方法
自動発動
以下のキーワードで自動発動します:
- 「新しいプロジェクトを開始したい」
- 「仕様を初期化」
- 「プロジェクトを作成」
明示的発動
/michi launch-pj "プロジェクト説明"
例:
/michi launch-pj "ユーザー認証機能"
実行内容
1. 機能名生成
プロジェクト説明から以下の形式で機能名を生成します:
YYYYMMDD-{pj-name}
例:
- "ユーザー認証機能" →
20260117-user-auth - "商品検索API" →
20260117-product-search-api
2. ディレクトリ構造作成
以下のディレクトリを作成します:
.michi/pj/YYYYMMDD-{pj-name}/ # メタデータ(.gitignore対象)
docs/michi/YYYYMMDD-{pj-name}/ # 仕様書(Git管理される)
├── spec/
├── tasks/
├── research/
├── test-plan/
└── todos/
3. メタデータ初期化
.michi/pj/YYYYMMDD-{pj-name}/project.json を作成:
{
"name": "{pj-name}",
"fullName": "YYYYMMDD-{pj-name}",
"description": "プロジェクト説明",
"phase": "initialized",
"createdAt": "2026-01-17T00:00:00Z",
"updatedAt": "2026-01-17T00:00:00Z"
}
次のステップ
プロジェクト初期化が完了したら、次のステップに進みます:
推奨: 要件定義
create-requirements スキルを使用して要件定義書を作成します。
/michi create-requirements {pj-name}
または自動発動:
要件定義したい
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル: create-requirements - 要件定義書作成
manage-todos: TODO管理
TODO管理スキルは、プロジェクトの不明点、仮定、リスク、技術的負債を一元管理するために使用します。
概要
このスキルは以下を実行します:
- TODO抽出: 既存ドキュメント(requirements.md、architecture.md、design.md、research.md)からTODOを抽出
- TODO追加: 新規TODOを対話的に追加
- TODO表示: カテゴリ別、優先度別にTODOを表示
- TODO解決: TODOを解決済みにマーク
TODOカテゴリ
| カテゴリ | 略称 | 説明 | 例 |
|---|---|---|---|
| Question | Q | 確認が必要な不明点 | 認証トークンの有効期限は? |
| Assumption | A | 暫定的に仮定している事項 | DBはPostgreSQLを使用すると仮定 |
| Risk | R | 識別されたリスク | 外部API障害時の動作が未定義 |
| Tech Debt | T | 技術的負債 | 一時的なハードコーディングあり |
使用方法
自動発動
以下のキーワードで自動発動します:
- 「TODOを確認したい」
- 「不明点を整理」
- 「仮定を確認」
- 「リスクを管理」
明示的発動(サブコマンド)
1. scan - TODO抽出
既存ドキュメントからTODOを抽出します。
/michi manage-todos scan {pj-name}
抽出対象:
docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md- 「前提条件」セクションの仮定
- 「制約事項」セクションの不明点
docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md- 設計上のリスク
- 技術選定の仮定
docs/michi/YYYYMMDD-{pj-name}/spec/design.md- 詳細設計の不明点
docs/michi/YYYYMMDD-{pj-name}/research/research.md- リスクセクション
src/**/*.ts,src/**/*.js- コード内のTODOコメント(// TODO:, /* TODO:)
認識パターン:
<!-- TODO: [Q] 認証トークンの有効期限は何分にすべきか? -->
- [ ] TODO: [A] DBはPostgreSQLを使用すると仮定
サブエージェント活用(並列TODO抽出):
scanサブコマンドで複数ドキュメントを並列検索します:
Phase 1: 並列TODO抽出
| エージェント | 対象 | パターン | 出力 |
|---|---|---|---|
| 要件定義TODO | spec/requirements.md | TODO: [Q], TODO: [A] | 要件TODOリスト |
| 設計TODO | spec/architecture.md, design.md | TODO: [R], TODO: [A], TODO: [T] | 設計TODOリスト |
| 調査ログTODO | research/research.md | すべてのカテゴリ | 調査TODOリスト |
| コードTODO | src//*.ts, src//*.js | // TODO:, /* TODO: | コードTODOリスト |
Phase 2: TODO統合(メインエージェント)
- Phase 1の結果をマージ
- 重複排除、優先度設定
- todos.md生成
メリット:
- ドキュメント横断検索の高速化
- 各ドキュメントを独立して探索
- TODO抽出精度の向上
2. show - TODO一覧表示
TODO一覧を表示します。
/michi manage-todos show {pj-name}
表示形式:
TODO一覧: user-auth
[Q] Question (2件)
TODO-Q-001 ⚠️ High | 認証トークンの有効期限は何分にすべきか?
TODO-Q-002 📌 Medium | パスワードの最小文字数は?
[A] Assumption (1件)
TODO-A-001 📌 Medium | DBはPostgreSQLを使用すると仮定
[R] Risk (1件)
TODO-R-001 ⚠️ High | 外部API障害時の動作が未定義
統計:
全TODO: 4件
未解決: 4件
高優先度: 2件
3. add - TODO追加
新規TODOを対話的に追加します。
/michi manage-todos add {pj-name}
対話フロー (AskUserQuestion ツール使用):
- カテゴリ選択(Q / A / R / T)
- AskUserQuestion でカテゴリを選択
- 優先度選択(High / Medium / Low)
- AskUserQuestion で優先度を選択
- TODO内容入力
- ユーザーに入力を促す
todos/todos.mdに追加- TODOをファイルに書き込み
4. resolve - TODO解決
TODOを解決済みにマークします。
/michi manage-todos resolve {pj-name} TODO-Q-001
実行内容:
- TODO内容を確認
- 指定されたTODO IDの内容を表示
- AskUserQuestion で解決を確認
- 解決内容を入力
- ユーザーに解決方法・決定事項を入力させる
- TODOを解決済みにマーク
- 解決日時を記録
- 解決内容を追記
project.jsonを更新
対話的な確認フロー:
TODO-Q-001の内容:
認証トークンの有効期限は何分にすべきか?
このTODOを解決済みにしますか?
> はい
解決内容を入力してください:
> 15分に決定。セキュリティ要件と合わせて確認済み。
✓ TODO-Q-001 を解決済みにマークしました
実行内容
1. TODOファイル構造
TODOは以下の構造で管理されます:
docs/michi/YYYYMMDD-{pj-name}/
└── todos/
└── todos.md # TODO一覧
2. todos.mdフォーマット
# TODO一覧: {pj-name}
## [Q] Question - 不明点
- [ ] TODO-Q-001 ⚠️ High | 認証トークンの有効期限は何分にすべきか?
- 発見元: requirements.md
- 登録日: 2026-01-17
- [x] TODO-Q-002 📌 Medium | パスワードの最小文字数は?
- 発見元: requirements.md
- 登録日: 2026-01-17
- 解決日: 2026-01-18
- 解決内容: 8文字以上に決定
## [A] Assumption - 仮定
- [ ] TODO-A-001 📌 Medium | DBはPostgreSQLを使用すると仮定
- 発見元: architecture.md
- 登録日: 2026-01-17
## [R] Risk - リスク
- [ ] TODO-R-001 ⚠️ High | 外部API障害時の動作が未定義
- 発見元: research.md
- 登録日: 2026-01-17
## [T] Tech Debt - 技術的負債
(なし)
---
統計:
- 全TODO: 3件
- 未解決: 3件
- 高優先度: 2件
既存スキルとの連携
create-requirements との連携
要件定義書生成後、以下を自動提案します:
要件定義書を生成しました。
TODOを抽出しますか?
- manage-todos scan {pj-name}
create-design との連携
設計書生成後、リスク・不明点をTODOとして抽出提案します。
show-status との連携
ステータス表示時にTODO状況サマリーを含めます:
プロジェクト: user-auth
フェーズ: design-generated
タスク進捗: 3 / 10 完了 (30%)
TODO状況: 未解決 4件(高優先度 2件)
次のアクション:
- 高優先度TODOを解決(manage-todos show)
- テスト計画を立てる(plan-tests)
dev との連携
実装開始前に高優先度TODOの警告を表示します:
⚠️ 警告: 未解決の高優先度TODOがあります
TODO-Q-001: 認証トークンの有効期限は何分にすべきか?
実装を続行しますか?
次のステップ
TODO管理後、フェーズに応じて次のステップを実行します:
| 現在のフェーズ | 次のステップ |
|---|---|
requirements-generated | create-design - 設計 |
design-generated | plan-tests または create-tasks |
tasks-generated | dev - TDD実装 |
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
create-requirements- 要件定義書作成create-design- 設計書作成show-status- ステータス表示dev- TDD実装
multi-repo-create-design: マルチリポジトリ設計
C4モデルによるアーキテクチャ設計を行い、クロスリポジトリ整合性を考慮します。
概要
- C4モデル設計: 全リポジトリ統合のアーキテクチャを設計
- コンテナ間連携: リポジトリ間の通信を設計
- データフロー設計: データの流れを明示
使用方法
/michi-multi-repo create-design {pj-name}
実行内容
統合設計書を作成します:
# 統合設計: EC Platform
## C4モデル
### Level 1: Context
- システム境界
- 外部システムとの関係
### Level 2: Container
- frontend-web: React SPA
- backend-api: Node.js API Server
- mobile-app: React Native App
### コンテナ間連携
- frontend-web → backend-api: REST API (HTTPS)
- mobile-app → backend-api: REST API (HTTPS)
## データフロー
```mermaid
graph LR
Frontend[frontend-web] -->|HTTPS| API[backend-api]
Mobile[mobile-app] -->|HTTPS| API
API --> DB[(PostgreSQL)]
## 次のステップ
```bash
/michi-multi-repo review-cross {pj-name}
次のスキル: multi-repo-review-cross
multi-repo-create-requirements: マルチリポジトリ要件定義
EARS形式の統合要件定義を生成し、リポジトリ間の依存関係を明記します。
概要
- EARS形式要件定義: 全リポジトリ統合の要件を定義
- リポジトリ間依存関係: 各リポジトリの役割と依存を明記
- インターフェース定義: リポジトリ間のインターフェースを定義
使用方法
/michi-multi-repo create-requirements {pj-name}
実行内容
統合要件定義書を作成します:
# 統合要件定義: EC Platform
## リポジトリ構成
### frontend-web
- 役割: Webフロントエンド
- 依存: backend-api
### backend-api
- 役割: APIサーバー
- 依存: なし
### mobile-app
- 役割: モバイルアプリ
- 依存: backend-api
## インターフェース定義
### backend-api → frontend-web
- API仕様: OpenAPI 3.0
- 認証: OAuth2
## 要件
### FR-001: ユーザー登録
- **リポジトリ**: backend-api, frontend-web, mobile-app
- **要件**: ユーザーは新規登録できる
次のステップ
/michi-multi-repo create-design {pj-name}
次のスキル: multi-repo-create-design
multi-repo-dev-all: 全リポジトリ並行実装
複数リポジトリで並行してTDD実装を行い、依存関係を考慮した実行順序で実装します。
概要
- 依存関係分析: リポジトリ間の依存を分析
- 実行順序決定: トポロジカルソートで順序を決定
- 並行実装: 依存のないリポジトリは並行実行
使用方法
/michi-multi-repo dev-all {pj-name}
サブエージェント活用(Plan + general-purpose)
複数リポジトリの並行実装をgeneral-purposeエージェントで実行します:
Phase 1: 依存関係分析(Plan)
Planエージェントで各リポジトリの依存関係を分析:
- トポロジカルソートで実行順序を決定
- 並行実行可能なリポジトリを特定
例:
backend-api: 依存なし → Phase 1で実装
frontend-web: backend-api に依存 → Phase 2で実装
mobile-app: backend-api に依存 → Phase 2で実装
Phase 2: 並行TDD実装(general-purpose x N)
依存関係のないリポジトリは並行してgeneral-purposeエージェントを起動:
- 各エージェントがdevスキル相当の処理を実行
- TDD実装(Red-Green-Refactor)
- カバレッジ確認
- PR作成
並行実行例:
Phase 1: backend-api を実装(general-purpose x 1)
Phase 2: frontend-web と mobile-app を並行実装(general-purpose x 2)
Phase 3: 統合確認(メインエージェント)
- すべてのリポジトリのPRを確認
- クロスリポジトリテストを実行
general-purposeエージェント活用のメリット:
- 各リポジトリで独立したTDD実装が可能
- 並行実行で全体の開発時間を短縮
- 各エージェントが完全な開発権限を持つ
Planエージェント活用のメリット:
- 依存関係の正確な分析
- 実行順序の最適化
- 並行実行タイミングの最適化
実行内容
依存関係分析
backend-api: 依存なし
frontend-web: backend-api に依存
mobile-app: backend-api に依存
実行順序
Phase 1: backend-api を実装
Phase 2: frontend-web と mobile-app を並行実装
並行実装
各リポジトリで以下を実行:
- ブランチ作成
- TDD実装(Red-Green-Refactor)
- テスト実行
- カバレッジ確認(95%以上)
- コミット・PR作成
完了条件
- すべてのリポジトリで実装完了
- すべてのテストが合格
- カバレッジ95%以上
- クロスリポジトリ整合性確認
次のステップ
全リポジトリの実装が完了したら、統合テストを実行します。
# 統合テスト実行
npm run test:integration
# アーカイブ
/michi archive-pj {pj-name}
参照
- マルチリポガイド:
../references/multi-repo-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル: archive-pj - プロジェクトアーカイブ(完了時)
multi-repo-launch-pj: マルチリポジトリプロジェクト初期化
マルチリポジトリプロジェクト初期化スキルは、複数のリポジトリにまたがるプロジェクトを初期化します。
概要
このスキルは以下を実行します:
- プロジェクト初期化: 統合仕様を管理するプロジェクトを作成
- リポジトリリスト作成: 対象リポジトリのリストを作成
- メタデータ作成:
templates/multi-repo/project.jsonから初期化
使用方法
明示的発動
/michi-multi-repo launch-pj "プロジェクト説明"
例:
/michi-multi-repo launch-pj "EC Platform"
実行内容
1. プロジェクト初期化
templates/multi-repo/project.json から初期化します:
{
"name": "ec-platform",
"fullName": "20260117-ec-platform",
"description": "EC Platform",
"type": "multi-repo",
"repositories": [
"frontend-web",
"backend-api",
"mobile-app"
],
"phase": "initialized"
}
2. ディレクトリ構造作成
.michi/pj/YYYYMMDD-{pj-name}/
docs/michi/YYYYMMDD-{pj-name}/
├── spec/
│ ├── requirements.md
│ ├── architecture.md
│ └── sequence.md
└── test-plan/
次のステップ
初期化が完了したら、統合要件定義を作成します。
/michi-multi-repo create-requirements {pj-name}
参照
- マルチリポガイド:
../references/multi-repo-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル: multi-repo-create-requirements - 統合要件定義
multi-repo-propagate: 各リポジトリへ仕様展開
統合仕様を各リポジトリに展開し、並行実行で効率化します。
概要
- 統合仕様読み込み: 統合要件定義・設計を読み込み
- リポジトリごとに仕様抽出: 各リポジトリに関連する部分を抽出
- 並行展開: 各リポジトリに仕様を展開(並行実行)
使用方法
/michi-multi-repo propagate {pj-name}
実行内容
各リポジトリに仕様を展開します:
並行実行:
- frontend-web: requirements.md, design.md を作成
- backend-api: requirements.md, design.md を作成
- mobile-app: requirements.md, design.md を作成
完了後、各リポジトリに仕様ファイルが配置されます。
展開先:
frontend-web/docs/specs/YYYYMMDD-{pj-name}/
backend-api/docs/specs/YYYYMMDD-{pj-name}/
mobile-app/docs/specs/YYYYMMDD-{pj-name}/
次のステップ
/michi-multi-repo dev-all {pj-name}
次のスキル: multi-repo-dev-all
multi-repo-review-cross: クロスリポジトリ整合性検証
各リポジトリの仕様間の整合性を検証し、インターフェース不整合を検出します。
概要
- インターフェース整合性: API仕様の一致を確認
- データモデル整合性: データ構造の一致を確認
- 依存関係検証: リポジトリ間の依存が正しいか確認
使用方法
/michi-multi-repo review-cross {pj-name}
サブエージェント活用(リポジトリ並列探索)
各リポジトリを個別のExploreエージェントで並列探索します:
Phase 1: リポジトリ並列探索(最大10個)
各リポジトリに対して1つのExploreエージェントを割り当て:
- API呼び出し / APIエンドポイント一覧
- 型定義
- 依存関係 → 各リポジトリの仕様サマリーを出力
Phase 2: クロスリポジトリ整合性検証(メインエージェント)
- Phase 1の結果を突合
- インターフェース不整合検出
- 依存関係グラフ生成
- 整合性レポート生成
メリット:
- 複数リポジトリの並列探索
- 探索時間を大幅短縮
- 各リポジトリの独立した分析
実行内容
クロスリポジトリ検証を実行します:
# クロスリポジトリ整合性検証結果
## インターフェース整合性
### API仕様
- ✅ backend-api の OpenAPI仕様とfrontend-web の型定義が一致
- ⚠️ mobile-app の型定義が古い(backend-api v1.2.0 vs mobile-app v1.1.0)
## データモデル整合性
- ✅ User型の定義が全リポジトリで一致
## 依存関係
- ✅ 循環依存なし
- ✅ 依存方向が正しい(frontend/mobile → backend)
次のステップ
/michi-multi-repo propagate {pj-name}
次のスキル: multi-repo-propagate
plan-tests: テスト計画作成
テスト計画作成スキルは、テスト戦略(Phase 0.3)とテスト仕様(Phase 0.4)を作成します。
概要
このスキルは以下を実行します:
- 設計書参照: design.md, architecture.md を読み込んで設計を把握
- テスト戦略作成(Phase 0.3): テスト方針、テストレベル、テスト環境を定義
- テスト仕様作成(Phase 0.4): 単体・統合・E2E・パフォーマンステストの詳細仕様を作成
- テスト計画書生成:
docs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.mddocs/michi/YYYYMMDD-{pj-name}/test-plan/unit/docs/michi/YYYYMMDD-{pj-name}/test-plan/integration/docs/michi/YYYYMMDD-{pj-name}/test-plan/e2e/docs/michi/YYYYMMDD-{pj-name}/test-plan/performance/
- フェーズ更新: project.json のフェーズを
test-plan-generatedに更新
使用方法
自動発動
以下のキーワードで自動発動します:
- 「テスト計画を立てたい」
- 「テスト戦略を作成」
- project.json の
phase: "design-generated"の場合に自動提案
明示的発動
/michi plan-tests {pj-name}
例:
/michi plan-tests user-auth
実行内容
1. 設計書参照
以下のファイルを読み込んで設計を把握します:
docs/michi/YYYYMMDD-{pj-name}/spec/design.mddocs/michi/YYYYMMDD-{pj-name}/spec/architecture.mddocs/michi/YYYYMMDD-{pj-name}/spec/requirements.md
2. テスト戦略作成(Phase 0.3)
docs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.md を作成します:
# テスト戦略: {pj-name}
## テスト方針
- TDD(テスト駆動開発)を基本とする
- カバレッジ95%以上を目標
- Mutation Testing を実施(オプション)
## テストレベル
### 単体テスト(Unit Test)
- 対象: 個別の関数・クラス
- ツール: Jest / Vitest
- カバレッジ目標: 95%以上
### 統合テスト(Integration Test)
- 対象: コンポーネント間の連携
- ツール: Supertest / TestContainers
- カバレッジ目標: 80%以上
### E2Eテスト(End-to-End Test)
- 対象: ユーザーシナリオ
- ツール: Playwright / Cypress
- カバレッジ目標: 主要シナリオ100%
### パフォーマンステスト(Performance Test)
- 対象: レスポンスタイム、スループット
- ツール: k6 / Artillery
- 目標: レスポンスタイム < 200ms
## テスト環境
- ローカル: Docker Compose
- CI/CD: GitHub Actions
- ステージング: AWS ECS
## テストデータ
- テストDBは毎回リセット
- Fixture を使用してデータを準備
## 継続的インテグレーション
- すべてのテストはPR作成時に自動実行
- テスト失敗時はマージブロック
3. テスト仕様作成(Phase 0.4)
各テストレベルの詳細仕様を作成します:
単体テスト仕様
docs/michi/YYYYMMDD-{pj-name}/test-plan/unit/{feature}.md:
# 単体テスト仕様: {feature}
## テストケース一覧
### TC-U-001: 正常系 - ユーザー登録
- 入力: email, password
- 期待結果: ユーザーが作成され、IDが返される
### TC-U-002: 異常系 - 重複メールアドレス
- 入力: 既存のメールアドレス
- 期待結果: エラーが返される(409 Conflict)
### TC-U-003: 異常系 - 無効なメールアドレス
- 入力: 無効な形式のメールアドレス
- 期待結果: バリデーションエラーが返される
統合テスト仕様
docs/michi/YYYYMMDD-{pj-name}/test-plan/integration/{feature}.md:
# 統合テスト仕様: {feature}
## テストケース一覧
### TC-I-001: API → DB連携
- 前提: DBが起動している
- 実行: POST /api/users
- 検証: DBにユーザーが保存されている
### TC-I-002: 認証フロー
- 前提: ユーザーが登録済み
- 実行: POST /api/login
- 検証: トークンが返され、セッションが保存されている
E2Eテスト仕様
docs/michi/YYYYMMDD-{pj-name}/test-plan/e2e/{scenario}.md:
# E2Eテスト仕様: ユーザー登録〜ログイン
## シナリオ
1. ユーザー登録ページにアクセス
2. メールアドレスとパスワードを入力
3. 登録ボタンをクリック
4. 確認メールを受信
5. メール内のリンクをクリック
6. ログインページにアクセス
7. 登録したメールアドレスとパスワードでログイン
8. ダッシュボードにリダイレクト
## 期待結果
- ダッシュボードに「ようこそ、{username}さん」と表示される
パフォーマンステスト仕様
docs/michi/YYYYMMDD-{pj-name}/test-plan/performance/{api}.md:
# パフォーマンステスト仕様: ログインAPI
## 負荷シナリオ
- Virtual Users: 100
- Duration: 5 minutes
- Ramp-up: 30 seconds
## 目標
- レスポンスタイム(P95): < 200ms
- エラー率: < 0.1%
- スループット: > 500 req/sec
4. フェーズ更新
project.json のフェーズを更新します:
{
"phase": "test-plan-generated",
"updatedAt": "2026-01-17T00:00:00Z"
}
次のステップ
テスト計画が完了したら、次のステップに進みます:
推奨: タスク分割
create-tasks スキルを使用してタスクに分割します。
/michi create-tasks {pj-name}
または自動発動:
タスクに分割したい
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
次のスキル: create-tasks - タスク分割
review-design: 設計レビュー
設計レビュースキルは、設計書の技術的妥当性、セキュリティ、テスト計画準備状況を確認します。
概要
このスキルは以下を実行します:
- 設計書読み込み: architecture.md, design.md, sequence.md を読み込み
- 技術的妥当性確認:
- アーキテクチャの整合性
- データモデルの正規化
- API設計のRESTful準拠
- セキュリティチェック:
- OWASP Top 10 準拠確認
- 認証・認可の実装確認
- データ暗号化の確認
- テスト計画準備状況確認:
- テストしやすい設計か
- モックしやすいインターフェースか
- レビュー結果レポート: 問題点と改善提案を記載
使用方法
自動発動
以下のキーワードで自動発動します:
- 「設計をレビューしたい」
- 「設計レビュー」
- project.json の
phase: "design-generated"の場合に自動提案
明示的発動
/michi review-design {pj-name}
例:
/michi review-design user-auth
サブエージェント活用(並列チェック)
設計書のレビューを3つのExploreエージェントで並列実行します:
Phase 1: 並列チェック
| エージェント | 対象 | チェック項目 | 出力 |
|---|---|---|---|
| 技術的妥当性チェック | architecture.md, design.md | レイヤー分離、依存関係、正規化、RESTful | 技術的問題リスト |
| セキュリティチェック | design.md, sequence.md | OWASP Top 10、認証・認可、暗号化 | セキュリティ問題リスト |
| テスタビリティチェック | architecture.md, design.md | DI使用、インターフェース分離、モック容易性 | テスタビリティ問題リスト |
Phase 2: レポート統合(メインエージェント)
- Phase 1の結果を統合
- 重大度分類(Critical/Major/Minor)
- レビュー結果レポート生成
メリット:
- レビュー品質の向上
- 複数の観点から独立して検証
- 検証タスクの並列化による時間短縮
実行内容
1. 設計書読み込み
以下のファイルを読み込みます:
docs/michi/YYYYMMDD-{pj-name}/spec/architecture.mddocs/michi/YYYYMMDD-{pj-name}/spec/design.mddocs/michi/YYYYMMDD-{pj-name}/spec/sequence.md
2. 技術的妥当性確認
アーキテクチャの整合性:
- レイヤー分離が適切か
- 依存関係が一方向か
- 責任分担が明確か
データモデルの正規化:
- 第3正規形まで正規化されているか
- 適切なインデックスが設計されているか
API設計のRESTful準拠:
- HTTPメソッドが適切に使用されているか
- ステータスコードが適切か
- リソース設計が適切か
3. セキュリティチェック
OWASP Top 10 準拠確認:
- SQL Injection対策
- XSS対策
- CSRF対策
- 認証・認可の実装
データ暗号化:
- パスワードのハッシュ化
- 通信の暗号化(HTTPS)
- 機密データの暗号化
4. テスト計画準備状況確認
テストしやすい設計:
- 依存性注入(DI)が使用されているか
- インターフェース分離がされているか
モックしやすいインターフェース:
- 外部依存がインターフェース化されているか
- テストダブルが使いやすいか
5. レビュー結果レポート
レビュー結果を以下の形式でレポートします:
# 設計レビュー結果: {pj-name}
## サマリー
- **合格/不合格**: 合格
- **重大な問題**: 0件
- **軽微な問題**: 2件
- **改善提案**: 3件
## 重大な問題
(なし)
## 軽微な問題
### LI-001: データベースインデックス不足
- **説明**: email カラムにインデックスがない
- **影響**: ログイン時のクエリ性能低下
- **推奨対応**: email カラムに UNIQUE INDEX を追加
### LI-002: エラーハンドリング不足
- **説明**: 外部API呼び出しのエラーハンドリングが不足
- **影響**: 外部API障害時にシステムが停止する可能性
- **推奨対応**: リトライロジックを追加
## 改善提案
### REC-001: キャッシュ層の追加
- **説明**: 頻繁にアクセスされるデータをキャッシュする
- **効果**: レスポンスタイム短縮
### REC-002: 非同期処理の導入
- **説明**: メール送信を非同期化する
- **効果**: ユーザーレスポンス改善
### REC-003: モニタリング設計
- **説明**: メトリクス・ログ・トレースを設計に含める
- **効果**: 運用時の問題検知が容易になる
次のステップ
設計レビューが完了したら、次のステップに進みます:
問題がある場合: 設計を修正
設計書を修正して、再度レビューを実行します。
/michi create-design {pj-name}
/michi review-design {pj-name}
問題がない場合: テスト計画またはタスク分割
/michi plan-tests {pj-name}
または
/michi create-tasks {pj-name}
参照
- セキュリティガイドライン:
~/.claude/security/CLAUDE-security-policy.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
create-design- 設計書作成(修正時)plan-tests- テスト計画作成(合格後)create-tasks- タスク分割(合格後)
review-dev: 実装検証
実装検証スキルは、実装されたコードの品質、テストカバレッジ、セキュリティ脆弱性を確認します。
概要
このスキルは以下を実行します:
- コード品質チェック:
- ESLint / Prettier / Checkstyle などの静的解析
- コードの複雑度測定
- コードスメル検出
- テストカバレッジ確認:
- カバレッジ95%以上を確認
- 未カバー箇所を特定
- セキュリティ脆弱性スキャン:
- Snyk / Trivy などのセキュリティスキャン
- OWASP Top 10 準拠確認
- 設計書との整合性確認:
- 実装が設計書に準拠しているか
- 検証結果レポート: 問題点と改善提案を記載
使用方法
自動発動
以下のキーワードで自動発動します:
- 「実装を検証したい」
- 「実装レビュー」
devスキルの Phase 6.7 で自動実行
明示的発動
/michi review-dev {pj-name}
例:
/michi review-dev user-auth
サブエージェント活用(並列検証)
実装検証をExploreエージェントとBashエージェントで並列実行します:
Phase 1: 並列検証
| エージェント | タイプ | 実行内容 | 出力 |
|---|---|---|---|
| コード品質チェック | Bash | npm run lint | 静的解析レポート |
| カバレッジ確認 | Bash | npm test -- --coverage | カバレッジレポート |
| セキュリティスキャン | Bash | npm audit && snyk test | 脆弱性リスト |
| 整合性確認 | Explore | 実装コード vs 設計書 | 不整合リスト |
| コードスメル検出 | Explore | 複雑度、重複、長い関数 | コードスメルリスト |
Phase 2: レポート統合(メインエージェント)
- Phase 1の結果を統合
- 合格/不合格判定
- 検証結果レポート生成
Bashエージェント活用のメリット:
- npm/yarnコマンドを並行実行
- セキュリティスキャンの待ち時間を短縮
- 各コマンドの出力を独立して収集
Exploreエージェント活用のメリット:
- コードベースの高速探索
- 設計書との整合性確認
- コードスメルの検出
実行内容
1. コード品質チェック
静的解析:
npm run lint
npm run format:check
コード複雑度測定:
- Cyclomatic Complexity: 10以下を推奨
- Cognitive Complexity: 15以下を推奨
コードスメル検出:
- 重複コード
- 長すぎる関数(50行以上)
- 長すぎるパラメータリスト(5個以上)
- 深いネスト(4階層以上)
2. テストカバレッジ確認
npm test -- --coverage
カバレッジ目標:
- Statements: 95%以上
- Branches: 90%以上
- Functions: 95%以上
- Lines: 95%以上
未カバー箇所の特定:
- カバレッジレポートを分析
- 未テスト箇所を特定
- 追加テストを提案
3. セキュリティ脆弱性スキャン
依存パッケージスキャン:
npm audit
snyk test
コンテナイメージスキャン:
trivy image {image-name}
OWASP Top 10 準拠確認:
- SQL Injection対策の実装確認
- XSS対策の実装確認
- CSRF対策の実装確認
- 認証・認可の実装確認
4. 設計書との整合性確認
以下を確認します:
- API仕様が設計書と一致しているか
- データモデルが設計書と一致しているか
- シーケンス図の処理フローと一致しているか
5. 検証結果レポート
検証結果を以下の形式でレポートします:
# 実装検証結果: {pj-name}
## サマリー
- **合格/不合格**: 合格
- **コード品質**: ✅ 問題なし
- **テストカバレッジ**: ✅ 96.5% (目標95%以上)
- **セキュリティ**: ⚠️ 軽微な問題1件
- **設計整合性**: ✅ 問題なし
## コード品質
### 静的解析
- ESLint: 0 errors, 0 warnings
- Prettier: フォーマット済み
### コード複雑度
- 最大 Cyclomatic Complexity: 8 (目標10以下)
- 最大 Cognitive Complexity: 12 (目標15以下)
### コードスメル
- 重複コード: 1箇所(utils.ts:45-60)
## テストカバレッジ
- Statements: 96.5%
- Branches: 91.2%
- Functions: 97.1%
- Lines: 96.3%
### 未カバー箇所
- src/auth.ts:line 105-110 (エラーハンドリング)
- 推奨: 例外発生時のテストを追加
## セキュリティ
### 依存パッケージ
- npm audit: 0 vulnerabilities
### OWASP Top 10
- SQL Injection: ✅ Parameterized Query使用
- XSS: ✅ エスケープ処理実装
- CSRF: ⚠️ CSRF tokenが未実装
- 推奨: CSRF tokenを追加
## 設計整合性
- API仕様: ✅ 設計書と一致
- データモデル: ✅ 設計書と一致
- シーケンス図: ✅ 処理フローと一致
次のステップ
実装検証が完了したら、次のステップに進みます:
問題がある場合: 修正
問題を修正して、再度検証を実行します。
# 修正後
/michi review-dev {pj-name}
問題がない場合: PR作成またはアーカイブ
# PR作成
gh pr create --title "feat: user authentication" --body "..."
# または全タスク完了時はアーカイブ
/michi archive-pj {pj-name}
参照
- コード品質ガイドライン:
~/.claude/team/CLAUDE-team-standards.md - セキュリティガイドライン:
~/.claude/security/CLAUDE-security-policy.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
dev- TDD実装(修正時)archive-pj- プロジェクトアーカイブ(完了時)
show-status: ステータス表示
ステータス表示スキルは、プロジェクトの現在の進捗状況を確認するために使用します。
概要
このスキルは以下の情報を表示します:
- プロジェクト基本情報: プロジェクト名、説明、作成日時
- 現在のフェーズ:
initialized,requirements-generated,design-generated,tasks-generated,implementation-completeなど - タスク進捗: 完了タスク数 / 全タスク数
- 次のアクション: 次に実行すべきステップの提案
使用方法
自動発動
以下のキーワードで自動発動します:
- 「進捗を確認したい」
- 「ステータスを表示」
- 「現在の状況は?」
明示的発動
/michi show-status {pj-name}
例:
/michi show-status user-auth
実行内容
1. プロジェクト情報読み込み
.michi/pj/YYYYMMDD-{pj-name}/project.json からメタデータを読み込みます。
2. 進捗状況分析
以下を分析します:
- 現在のフェーズ
- タスクの完了状況(
docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.mdを参照) - 承認状況(
project.jsonのapprovalsフィールド) - TODO状況(
docs/michi/YYYYMMDD-{pj-name}/todos/todos.mdを参照)- 全TODO数
- 未解決TODO数
- 高優先度TODO数
3. ステータス表示
以下の形式で表示します:
プロジェクト: user-auth
説明: ユーザー認証機能
フェーズ: design-generated
作成日: 2026-01-15
更新日: 2026-01-17
タスク進捗: 3 / 10 完了 (30%)
TODO状況: 未解決 4件(高優先度 2件)
次のアクション:
- 高優先度TODOを解決(manage-todos show)
- テスト計画を立てる(plan-tests)
- タスクに分割する(create-tasks)
次のステップ
ステータス確認後、フェーズに応じて次のステップを実行します:
| 現在のフェーズ | 次のステップ |
|---|---|
initialized | create-requirements - 要件定義 |
requirements-generated | create-design - 設計 |
design-generated | plan-tests または create-tasks |
tasks-generated | dev - TDD実装 |
implementation-complete | archive-pj - アーカイブ |
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
launch-pj- プロジェクト初期化archive-pj- プロジェクトアーカイブswitch-pj- プロジェクト切り替え
switch-pj: プロジェクト切り替え
プロジェクト切り替えスキルは、複数のプロジェクトを並行して管理する際に、現在作業中のプロジェクトを切り替えます。
概要
このスキルは以下を実行します:
- プロジェクト一覧表示:
.michi/pj/内の全プロジェクトを表示 - プロジェクト選択: ユーザーが切り替え先のプロジェクトを選択
- コンテキスト変更: 現在のコンテキストを切り替え先のプロジェクトに変更
- ステータス表示: 切り替え先のプロジェクトのステータスを表示
使用方法
自動発動
以下のキーワードで自動発動します:
- 「プロジェクトを切り替えたい」
- 「別のプロジェクトに切り替え」
- 「プロジェクトを変更」
明示的発動
/michi switch-pj
または、プロジェクト名を指定:
/michi switch-pj {pj-name}
例:
/michi switch-pj user-auth
実行内容
1. プロジェクト一覧表示
.michi/pj/ 内の全プロジェクトを表示します:
利用可能なプロジェクト:
1. 20260115-user-auth (要件定義完了)
2. 20260116-product-search (設計完了)
3. 20260117-payment-integration (初期化済み)
切り替え先のプロジェクトを選択してください。
2. プロジェクト選択
ユーザーがプロジェクトを選択します(番号またはプロジェクト名)。
3. コンテキスト変更
以下を更新します:
- 現在のプロジェクトコンテキスト
project.jsonのメタデータ- Claude のセッション変数
4. ステータス表示
切り替え後、選択されたプロジェクトのステータスを表示します:
プロジェクトを切り替えました: user-auth
プロジェクト: user-auth
フェーズ: design-generated
次のアクション: テスト計画(plan-tests)またはタスク分割(create-tasks)
使用例
並行開発のシナリオ
複数のプロジェクトを並行して進める場合:
- プロジェクトAで要件定義
- プロジェクトBに切り替えて設計
- プロジェクトAに戻って設計
- プロジェクトCを新規作成
- プロジェクトBに切り替えて実装
/michi launch-pj "プロジェクトA"
/michi create-requirements project-a
/michi switch-pj project-b
/michi create-design project-b
/michi switch-pj project-a
/michi create-design project-a
/michi launch-pj "プロジェクトC"
/michi switch-pj project-b
/michi dev project-b
次のステップ
プロジェクト切り替え後、show-status で現在のステータスを確認し、次のステップに進みます。
/michi show-status {pj-name}
参照
- ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
show-status- ステータス表示(切り替え後に確認)launch-pj- 新規プロジェクト初期化archive-pj- プロジェクトアーカイブ(完了後)
update-master-docs: マスタードキュメント更新
マスタードキュメント更新スキルは、プロジェクト横断の共通知識を更新します。
概要
このスキルは以下を実行します:
- マスタードキュメント読み込み: 既存のマスタードキュメントを確認
- 変更内容分析: プロジェクト固有の知見から共通化できる要素を抽出
- マスタードキュメント更新:
docs/master-docs/structure.md- システム構造docs/master-docs/tech.md- 技術スタックdocs/master-docs/product.md- プロダクト要件
- バージョン管理: 変更履歴を記録
使用方法
自動発動
以下のキーワードで自動発動します:
- 「マスタードキュメントを更新したい」
- 「共通知識を更新」
- プロジェクト完了時に自動提案
明示的発動
/michi update-master-docs
または、特定のドキュメントのみ更新:
/michi update-master-docs --doc structure
/michi update-master-docs --doc tech
/michi update-master-docs --doc product
実行内容
1. マスタードキュメント読み込み
以下のファイルを読み込みます:
docs/master-docs/
├── structure.md # システム構造
├── tech.md # 技術スタック
└── product.md # プロダクト要件
2. 変更内容分析
プロジェクト固有の知見から共通化できる要素を抽出します:
- 新しいアーキテクチャパターン
- 新しい技術スタック
- プロダクト要件の変更
- ベストプラクティス
3. マスタードキュメント更新
structure.md - システム構造
システム全体の構造を定義します:
# システム構造
## アーキテクチャ概要
### レイヤー構造
- Presentation Layer: API Gateway, UI
- Application Layer: Business Logic
- Domain Layer: Domain Models
- Infrastructure Layer: Database, External Services
## コンポーネント一覧
### API Gateway
- 役割: リクエストルーティング、認証・認可
- 技術: Kong / AWS API Gateway
### Authentication Service
- 役割: ユーザー認証
- 技術: OAuth2, JWT
tech.md - 技術スタック
プロジェクトで使用する技術スタックを定義します:
# 技術スタック
## 言語・フレームワーク
- **Backend**: Node.js 20.x, TypeScript 5.x
- **Frontend**: React 18.x, Next.js 14.x
- **Mobile**: React Native 0.73.x
## データベース
- **RDB**: PostgreSQL 16.x
- **NoSQL**: MongoDB 7.x
- **Cache**: Redis 7.x
## インフラ
- **Cloud**: AWS
- **Container**: Docker, Kubernetes
- **CI/CD**: GitHub Actions
product.md - プロダクト要件
プロダクト全体の要件を定義します:
# プロダクト要件
## ビジョン
...
## ターゲットユーザー
...
## 主要機能
1. ユーザー認証
2. 商品検索
3. 決済処理
...
## 非機能要件
- パフォーマンス: レスポンスタイム < 200ms
- 可用性: 99.9% SLA
- セキュリティ: OWASP Top 10 準拠
4. バージョン管理
変更履歴を各ドキュメントの末尾に記録します:
## 変更履歴
- 2026-01-17: ユーザー認証機能の追加 (user-auth プロジェクト)
- 2026-01-15: 商品検索APIの追加 (product-search プロジェクト)
次のステップ
マスタードキュメント更新後、次のプロジェクトで参照できるようになります。
新しいプロジェクトでは、更新されたマスタードキュメントを参照して要件定義・設計を行います。
/michi launch-pj "新しいプロジェクト"
/michi create-requirements new-project
注意事項
- 共通化のバランス: すべてをマスタードキュメントに書くのではなく、本当に共通化すべき要素のみを抽出
- プロジェクト固有の詳細: 各プロジェクトの詳細は、そのプロジェクトの仕様書に記載
- 定期的な見直し: 技術スタックやアーキテクチャの変更に応じて定期的に見直す
参照
- マスタードキュメント原則:
~/.michi/settings/rules/master-docs-principles.md - ワークフロー全体:
../references/workflow-guide.md - コマンドリファレンス:
../references/command-reference.md
関連スキル:
create-requirements- 要件定義(マスタードキュメントを参照)create-design- 設計(マスタードキュメントを参照)
Sponsors
Details
- Marketplace
- sk8metalme/michi
- Source
- plugins/michi
- Category
- Community