@sk8metal/michi-cli 0.8.7 → 0.11.0

package/scripts/utils/tasks-format-validator.ts

@@ -35,7 +35,7 @@ export function validateTasksFormat(tasksPath: string): void {
     throw new Error(
       'tasks.md appears to be in AI-DLC format instead of Michi workflow format.\n' +
         'Detected "- [ ] 1." pattern without Phase structure.\n' +
-        'Please regenerate tasks.md using /kiro:spec-tasks command with correct template.',
+        'Please regenerate tasks.md using /michi:spec-tasks command with correct template.',
     );
   }
 
@@ -72,7 +72,7 @@ export function validateTasksFormat(tasksPath: string): void {
       'tasks.md does not match either workflow structure.\n\n' +
         `Missing required phases (new workflow):\n${missingNewPhases.map((p) => `  - ${p}`).join('\n')}\n\n` +
         `Missing phases (legacy workflow):\n${missingLegacyPhases.map((p) => `  - ${p}`).join('\n')}\n\n` +
-        'Please regenerate tasks.md using /kiro:spec-tasks command with the latest template.',
+        'Please regenerate tasks.md using /michi:spec-tasks command with the latest template.',
     );
   }
 
@@ -100,7 +100,7 @@ export function validateTasksFormat(tasksPath: string): void {
     throw new Error(
       'tasks.md does not contain valid Story headers.\n' +
         'Expected format: "### Story X.Y: Title"\n' +
-        'Please regenerate tasks.md using /kiro:spec-tasks command.',
+        'Please regenerate tasks.md using /michi:spec-tasks command.',
     );
   }
 

package/templates/claude/agents/e2e-first-planner/AGENT.md

@@ -3,7 +3,7 @@ name: e2e-first-planner
 description: |
   E2Eファースト開発計画を自動生成する実行エージェント。
   Walking Skeleton、MVP計画、縦割りタスク分割を提案。
-  タスク分割フェーズ（/kiro:spec-tasks実行時）に PROACTIVELY 使用してください。
+  タスク分割フェーズ（/michi:spec-tasks実行時）に PROACTIVELY 使用してください。
 allowed-tools: Bash, Read, Grep, Glob
 ---
 

package/templates/claude/agents/mermaid-validator/AGENT.md

@@ -0,0 +1,257 @@
+---
+name: mermaid-validator
+description: |
+  Mermaid図の構文検証と自動修正を行う実行エージェント。
+  architecture.md生成時やドキュメント編集時に PROACTIVELY 使用してください。
+allowed-tools: Bash, Read, Grep, Glob, Edit, Write, WebFetch
+---
+
+# Mermaid Validator Agent
+
+## 目的
+
+Markdownファイル内のMermaid図を検証し、構文エラーを検出して自動修正する。
+
+## 前提条件
+
+- Mermaid図を含むMarkdownファイルが存在
+- 検証対象: `docs/**/*.md`, `*.md`
+
+## 参照すべきスキル
+
+実行前に必ず `.claude/skills/mermaid-validator/SKILL.md` を確認し、そのガイドラインに従ってMermaid図を検証してください。
+
+## 実行フロー
+
+### Step 1: Mermaid図の検出
+
+```bash
+# Mermaid図を含むMarkdownファイルを検索
+echo "=== Mermaid diagrams found in: ==="
+find . -name "*.md" -exec grep -l '```mermaid' {} \; | head -20
+```
+
+### Step 2: Mermaid図の抽出と検証
+
+各ファイルから Mermaid ブロックを抽出し、構文チェックを実行:
+
+```bash
+# ファイルからMermaid図を抽出
+FILE="docs/michi/project/overview/architecture.md"
+
+# Mermaidブロックを抽出
+sed -n '/```mermaid/,/```/p' "$FILE" > /tmp/extracted-mermaid.txt
+
+# 抽出結果を確認
+cat /tmp/extracted-mermaid.txt
+```
+
+### Step 3: 構文エラーの検出
+
+以下の項目をチェック:
+
+#### 3.1 C4モデルの検証
+
+```bash
+# C4モデルの構文チェック
+grep -E 'C4(Context|Container|Component)' /tmp/extracted-mermaid.txt
+
+# タイトル行のチェック（コロンが含まれていないか）
+grep -E '^\s*title:' /tmp/extracted-mermaid.txt && echo "ERROR: 'title:' should be 'title' (no colon)"
+
+# Rel()の引数チェック（4つの引数が必須）
+grep -E 'Rel\(' /tmp/extracted-mermaid.txt | grep -v 'Rel([^,]+,[^,]+,[^,]+,[^,]+)' && echo "WARNING: Rel() requires 4 arguments"
+```
+
+#### 3.2 シーケンス図の検証
+
+```bash
+# シーケンス図の矢印記法チェック
+grep -E 'sequenceDiagram' /tmp/extracted-mermaid.txt && {
+    # 不正な矢印記法を検出（->, -->, -x ではなく ->>, -->>, ->> を使用すべき）
+    grep -E '([A-Za-z]+)->([A-Za-z]+):' /tmp/extracted-mermaid.txt && echo "WARNING: Use '->' instead of '->'"
+}
+```
+
+#### 3.3 グラフの検証
+
+```bash
+# サブグラフのインデントチェック
+grep -E 'subgraph' /tmp/extracted-mermaid.txt && {
+    # サブグラフの直後の行がインデントされていない場合
+    grep -A 1 'subgraph' /tmp/extracted-mermaid.txt | grep -v '^\s\+' && echo "WARNING: Subgraph content should be indented"
+}
+```
+
+#### 3.4 ER図の検証
+
+```bash
+# ER図のリレーションシップ記法チェック
+grep -E 'erDiagram' /tmp/extracted-mermaid.txt && {
+    # 不正なリレーションシップ記法を検出
+    grep -E '([A-Z_]+)\s*->\s*([A-Z_]+)' /tmp/extracted-mermaid.txt && echo "ERROR: Use proper ER relationship notation (e.g., ||--o{)"
+}
+```
+
+### Step 4: 自動修正
+
+検出されたエラーを自動修正:
+
+#### 修正ルール1: C4モデルのタイトル修正
+
+```bash
+# "title: System Context" → "title System Context"
+sed -i 's/^\s*title:\s*/    title /g' "$FILE"
+```
+
+#### 修正ルール2: シーケンス図の矢印記法修正
+
+```bash
+# "->" → "->>"（同期呼び出し）
+# ただし、既に "-->" の場合は修正しない
+sed -i 's/\([A-Za-z]\+\)->\([A-Za-z]\+\):/\1->>\2:/g' "$FILE"
+```
+
+#### 修正ルール3: サブグラフのインデント修正
+
+```bash
+# サブグラフ内のインデントを自動追加（簡易版）
+# 実際の実装では、構文解析が必要
+# ここではガイダンスのみ提供
+```
+
+#### 修正ルール4: ER図のリレーションシップ記法修正
+
+```bash
+# 簡易的な修正例（実際にはコンテキストに応じて調整が必要）
+# 1対多の場合
+sed -i 's/\([A-Z_]\+\)\s*->\s*\([A-Z_]\+\)/\1 ||--o{ \2/g' "$FILE"
+```
+
+### Step 5: 検証レポート出力
+
+修正内容をレポート形式で出力:
+
+```markdown
+# Mermaid検証レポート
+
+## 検証日時
+YYYY-MM-DD HH:MM:SS
+
+## 検証対象ファイル
+- `docs/michi/project/overview/architecture.md`
+- `docs/michi/project/overview/sequence.md`
+
+## 検出されたエラー
+
+### Critical（即時修正必要）
+
+#### architecture.md:15 - C4モデル: タイトル記法エラー
+- **エラー内容**: `title: System Context Diagram`
+- **修正内容**: `title System Context Diagram`
+- **ステータス**: ✅ 自動修正済み
+
+#### sequence.md:8 - シーケンス図: 矢印記法エラー
+- **エラー内容**: `User->Frontend: リクエスト`
+- **修正内容**: `User->>Frontend: リクエスト`
+- **ステータス**: ✅ 自動修正済み
+
+### Warning（推奨修正）
+
+#### architecture.md:45 - グラフ: サブグラフのインデント不足
+- **エラー内容**: サブグラフ内の要素がインデントされていない
+- **推奨修正**: 4スペースでインデント
+- **ステータス**: ⚠️ 手動修正を推奨
+
+### Info（任意対応）
+
+#### design.md:30 - Rel()の引数が3つのみ
+- **警告内容**: `Rel(user, system, "Uses")`
+- **推奨修正**: プロトコル情報を追加 `Rel(user, system, "Uses", "HTTPS")`
+- **ステータス**: 🟢 動作するが推奨形式ではない
+
+## サマリー
+
+- **検証ファイル数**: 3
+- **検出エラー数**: 5
+  - Critical: 2（自動修正済み）
+  - Warning: 2（要手動修正）
+  - Info: 1（任意対応）
+
+## 修正済みファイル
+
+以下のファイルが自動修正されました：
+- `docs/michi/project/overview/architecture.md`
+- `docs/michi/project/overview/sequence.md`
+
+## 次のステップ
+
+1. 修正内容を確認: `git diff docs/michi/project/overview/architecture.md`
+2. 残りのWarningを手動修正
+3. Mermaid Live Editorで最終確認: https://mermaid.live/
+```
+
+## 安全性ルール
+
+### 自動修正の範囲
+
+- ✅ 明らかな構文エラー（タイトル記法、矢印記法）
+- ✅ インデントの正規化
+- ❌ **構造的な変更は行わない**（ノード追加、削除、関係性変更）
+
+### 必須確認ケース
+
+1. **修正前のバックアップ**: 元のファイルを`.backup`として保存
+2. **修正内容の報告**: どのような修正を行ったかを明示
+3. **手動確認推奨**: 複雑な図は手動確認を推奨
+
+### 禁止事項
+
+- ❌ ユーザー確認なしでの構造的変更
+- ❌ 図の意味を変える修正
+- ❌ ノードやリレーションシップの追加・削除
+
+### 推奨パターン
+
+```
+AIエージェント:
+「Mermaid図の検証結果:
+
+🔴 Critical (2件)
+- architecture.md:15 - C4モデルのタイトル記法エラー → 自動修正済み
+- sequence.md:8 - シーケンス図の矢印記法エラー → 自動修正済み
+
+⚠️ Warning (1件)
+- architecture.md:45 - サブグラフのインデント不足 → 手動修正を推奨
+
+修正内容を確認しますか？
+A) git diffで差分確認
+B) Mermaid Live Editorで動作確認
+C) そのまま続行」
+```
+
+## Mermaid Live Editorでの検証
+
+修正後、Mermaid Live Editorで最終確認を推奨:
+
+```bash
+# 修正後のMermaid図を抽出
+sed -n '/```mermaid/,/```/p' architecture.md | sed '1d;$d' > /tmp/diagram.mmd
+
+echo "以下のURLで図を確認してください:"
+echo "https://mermaid.live/"
+echo ""
+echo "下記のコードをエディタに貼り付けてください:"
+cat /tmp/diagram.mmd
+```
+
+## CI/CD統合
+
+バージョン管理に組み込む場合、`ci-cd` スキル（`.claude/skills/ci-cd/SKILL.md`）を参照してください。
+
+## 参考資料
+
+- [Mermaid公式ドキュメント](https://mermaid.js.org/)
+- [Mermaid Live Editor](https://mermaid.live/)
+- [C4モデルガイド](https://c4model.com/)
+- [Mermaid CLI](https://github.com/mermaid-js/mermaid-cli)

package/templates/claude/agents/pr-resolver/AGENT.md

@@ -30,15 +30,27 @@ gh pr view <PR番号> --json number,title,state
 
 GitHub GraphQL APIでreviewThreadsを取得（`isResolved: false`）
 
-### 3. ユーザー確認
+### 3. CI/CDステータス確認
+
+CI／CDステータスを確認し、失敗しているjobがあれば、原因調査
+
+### 4. 未resolveスレッドについて対応するかどうか判断する
+
+tasks.mdを参考に、今後のタスクとして対応予定のものなのか、それとも、今すぐに対応すべき課題なのかを判断する
+
+### 5. CI/CDステータスが失敗だった時の対応
+
+失敗しているjobについてログを確認し、事実ベースで解決策を検討
+
+### 　6. ユーザー確認
 
 resolveするスレッドを提示し、確認を得る。
 
-### 4. resolve実行
+### 7. resolve実行
 
 `resolveReviewThread` mutationを実行。
 
-### 5. 結果報告
+### 8. 結果報告
 
 resolve済みスレッド数とステータスを報告。
 

package/templates/claude/commands/michi/e2e-plan.md

@@ -110,7 +110,7 @@ E2Eプランニング結果は以下の形式で出力されます：
 ## Phase 0.5統合
 
 このコマンドはPhase 0.5（タスク分割）で実行することを推奨します。
-`/kiro:spec-tasks` コマンドから呼び出すことも可能です。
+`/michi:spec-tasks` コマンドから呼び出すことも可能です。
 
 ## 言語設定
 

package/templates/claude/commands/michi/spec-design.md

@@ -66,10 +66,10 @@ Phase 0.3-0.4 完了後、以下のステップに進んでください:
 
 **推奨フロー**:
 1. `/michi:validate-design {feature}` で設計レビューを実施（任意）
-2. `/kiro:spec-tasks {feature}` でタスク生成
+2. `/michi:spec-tasks {feature}` でタスク生成
 
 **クイックフロー**:
-- `/kiro:spec-tasks {feature} -y` で自動承認してタスク生成
+- `/michi:spec-tasks {feature} -y` で自動承認してタスク生成
 
 **重要**: テスト計画（Phase 0.3-0.4）を完了してからタスク生成することで、実装タスクにテスト実装が適切に含まれます。
 

package/templates/claude/commands/michi/spec-tasks.md

@@ -0,0 +1,156 @@
+---
+name: /michi:spec-tasks
+description: Generate implementation tasks with JIRA sync option (Michi version)
+allowed-tools: Read, Write, Edit, MultiEdit, Glob, Grep, Bash
+argument-hint: <feature-name> [-y] [--sequential]
+---
+
+# Michi: Spec Tasks with JIRA Sync Option
+
+## Base Command Reference
+@.claude/commands/kiro/spec-tasks.md
+
+## Development Guidelines
+{{DEV_GUIDELINES}}
+
+---
+
+## Michi Extension: JIRA Sync Prompt
+
+このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、タスク生成完了後にJIRA同期オプションを提示します。
+
+### 機能追加内容
+
+1. **タスク生成完了後の次ステップ案内**:
+   - JIRA連携が設定されている場合: JIRA同期の選択肢（A/B/C形式）を表示
+   - JIRA連携が未設定の場合: 実装フェーズへの案内 + JIRA設定ヒントを表示
+
+2. **環境変数による条件分岐**:
+   - 以下の環境変数がすべて設定されている場合のみ、JIRA同期の選択肢を表示
+   - `ATLASSIAN_URL`
+   - `ATLASSIAN_EMAIL`
+   - `ATLASSIAN_API_TOKEN`
+
+---
+
+## タスク生成完了後のフロー
+
+基底コマンド `/kiro:spec-tasks` によるタスク生成が完了した後、以下のフローを実行してください:
+
+### Step 1: 環境変数チェック
+
+```bash
+# 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__/*
+
+### 分割戦略
+
+タスクが大きすぎる場合の分割方法:
+
+1. **水平分割（レイヤー別）**
+   - model/repository → service/logic → controller/handler
+   - 例: 「User CRUD」→「User model作成」「User service作成」「User controller作成」
+
+2. **垂直分割（機能スライス別）**
+   - core機能 → validation → error handling → edge cases
+   - 例: 「認証機能」→「ログインcore」「バリデーション追加」「エラーハンドリング」
+
+3. **フェーズ分割（段階別）**
+   - 基本実装 → テスト追加 → 最適化
+   - 例: 「検索機能」→「基本検索」「フィルター追加」「パフォーマンス最適化」
+
+### タスク生成時の確認事項
+
+タスク分割完了後、以下を確認してください:
+
+- [ ] 各サブタスクの予想diff行数が500行以内か
+- [ ] 大きなサブタスクは適切に分割されているか
+- [ ] ロックファイルや自動生成ファイルを含むタスクはその旨が明記されているか
+
+---
+
+## 実装上の注意点
+
+1. **基底コマンドの実行結果を維持**:
+   - `/kiro:spec-tasks` の「Output Description」セクションで出力されるタスクサマリーは維持してください
+   - Michi Extensionの選択肢はその**後**に追加で表示します
+
+2. **言語設定の考慮**:
+   - メッセージは日本語固定（将来的にspec.jsonの言語設定に対応する可能性あり）
+
+3. **ユーザーインタラクション**:
+   - 選択肢を表示した後、ユーザーの入力を待ちます
+   - 選択に応じて適切なコマンド/処理を案内または実行してください
+
+---
+
+**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、Phase 0.6（JIRA同期）への誘導を Next Phase として案内します。また、タスク粒度ガイドライン（git diff 500行制限）を提供し、適切なタスク分割を支援します。

package/templates/claude/commands/michi/test-planning.md

@@ -153,7 +153,7 @@ This command will:
 ### Or: Proceed to Task Generation
 
 ```bash
-/kiro:spec-tasks {feature-name} [-y]
+/michi:spec-tasks {feature-name} [-y]
 ```
 
 This will generate implementation tasks based on requirements, design, and test specifications.

package/templates/claude/commands/michi/validate-design.md

@@ -42,15 +42,15 @@ Phase 0.3-0.4 が未完了の場合は、タスク生成前に完了すること
      - 統合テスト: `docs/user-guide/templates/test-specs/integration-test-spec-template.md`
    - 出力先: `.kiro/specs/$1/test-specs/`
 
-3. **完了後**: `/kiro:spec-tasks $1` でタスク生成に進む
+3. **完了後**: `/michi:spec-tasks $1` でタスク生成に進む
 
 ### Next Phase Guidance
 
 **テスト計画完了済みの場合**:
-- `/kiro:spec-tasks $1` でタスク生成
+- `/michi:spec-tasks $1` でタスク生成
 
 **テスト計画未完了の場合**:
-- Phase 0.3-0.4 を実施してから `/kiro:spec-tasks $1`
+- Phase 0.3-0.4 を実施してから `/michi:spec-tasks $1`
 - または `/michi:spec-design $1` を再実行して Next Phase ガイダンスを確認
 
 ---