@sk8metal/michi-cli 0.10.1 → 0.12.0

package/scripts/utils/multi-repo-validator.ts

@@ -28,6 +28,8 @@ export interface LocalPathValidationResult extends ValidationResult {
   currentBranch: string | null;
   branchMatches: boolean;
   hasUncommittedChanges: boolean;
+  hasMichiSetup: boolean;
+  michiSetupCommand: string | null;
 }
 
 /**
@@ -156,6 +158,32 @@ export function validateRepositoryUrl(url: string): ValidationResult {
   };
 }
 
+/**
+ * Michi導入状況をチェック
+ * .kiro/project.json の存在でMichi導入済みと判定
+ *
+ * @param localPath - 子リポジトリのlocalPath
+ * @returns Michi導入済みかどうか
+ */
+export function hasMichiSetup(localPath: string): boolean {
+  const projectJsonPath = path.join(localPath, '.kiro', 'project.json');
+  return fs.existsSync(projectJsonPath);
+}
+
+/**
+ * Michi導入コマンドを生成
+ * パスに空白やシングルクォートが含まれる場合に対応
+ *
+ * @param localPath - 子リポジトリのlocalPath
+ * @returns セットアップコマンド文字列
+ */
+export function getMichiSetupCommand(localPath: string): string {
+  // シングルクォートをエスケープ: ' → '\''
+  // eslint-disable-next-line quotes
+  const escapedPath = localPath.replace(/'/g, "'\\''");
+  return `cd '${escapedPath}' && npx @sk8metal/michi-cli@latest init`;
+}
+
 /**
  * LocalPathのバリデーション
  * ディレクトリ存在、Gitリポジトリ、ブランチ、未コミット変更をチェック
@@ -175,6 +203,8 @@ export function validateLocalPath(
   let currentBranch: string | null = null;
   let branchMatches = false;
   let hasUncommittedChanges = false;
+  let hasMichiSetupResult = false;
+  let michiSetupCommand: string | null = null;
 
   // 1. localPath設定確認
   if (!repository.localPath) {
@@ -190,6 +220,8 @@ export function validateLocalPath(
       currentBranch,
       branchMatches,
       hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
     };
   }
 
@@ -211,6 +243,8 @@ export function validateLocalPath(
         currentBranch,
         branchMatches,
         hasUncommittedChanges,
+        hasMichiSetup: hasMichiSetupResult,
+        michiSetupCommand,
       };
     }
     exists = true;
@@ -225,6 +259,8 @@ export function validateLocalPath(
       currentBranch,
       branchMatches,
       hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
     };
   }
 
@@ -243,6 +279,8 @@ export function validateLocalPath(
       currentBranch,
       branchMatches,
       hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
     };
   }
   isGitRepository = true;
@@ -287,6 +325,16 @@ export function validateLocalPath(
     );
   }
 
+  // 6. Michi導入状況確認
+  hasMichiSetupResult = hasMichiSetup(localPath);
+
+  if (!hasMichiSetupResult) {
+    michiSetupCommand = getMichiSetupCommand(localPath);
+    warnings.push(
+      `Repository '${repository.name}' does not have Michi setup (.kiro/project.json not found)`,
+    );
+  }
+
   return {
     isValid: errors.length === 0,
     errors,
@@ -296,5 +344,7 @@ export function validateLocalPath(
     currentBranch,
     branchMatches,
     hasUncommittedChanges,
+    hasMichiSetup: hasMichiSetupResult,
+    michiSetupCommand,
   };
 }

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/scripts/utils/template-finder.ts

@@ -1,8 +1,8 @@
 /**
  * テンプレートファイル検索ユーティリティ
- * 
+ *
  * Issue #35: cc-sdd準拠のテンプレート検索
- * Cursor/Claude両環境のテンプレートを優先順位付きで検索
+ * Claude環境のテンプレートを検索
  */
 
 import { existsSync } from 'fs';
@@ -18,22 +18,16 @@ import { join } from 'path';
  * @example
  * ```typescript
  * const path = findTemplateFile('/path/to/michi', 'rules/github-ssot.mdc');
- * // returns: '/path/to/michi/templates/cursor/rules/github-ssot.mdc'
+ * // returns: '/path/to/michi/templates/claude/rules/github-ssot.mdc'
  * ```
  */
 export function findTemplateFile(michiPath: string, relativePath: string): string | null {
-  // 優先順位1: templates/cursor/
-  const cursorPath = join(michiPath, 'templates/cursor', relativePath);
-  if (existsSync(cursorPath)) {
-    return cursorPath;
-  }
-  
-  // 優先順位2: templates/claude/
+  // templates/claude/
   const claudePath = join(michiPath, 'templates/claude', relativePath);
   if (existsSync(claudePath)) {
     return claudePath;
   }
-  
+
   return null;
 }
 

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/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 ガイダンスを確認
 
 ---

package/templates/claude/commands/michi-multi-repo/impl-all.md

@@ -75,6 +75,24 @@ Multi-Repoプロジェクト **$1** の全リポジトリで `/michi:spec-impl`
 4. 各リポジトリのタスクファイル確認
    - `{localPath}/.kiro/specs/{feature}/tasks.md`
 
+### Step 2.5: localPath 検証
+
+各リポジトリについて以下を確認:
+
+- ✅ localPathが設定されているか
+- ✅ ディレクトリが存在するか
+- ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
+- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
+- ⚠️ 設定されたブランチと現在のブランチが一致するか
+- ⚠️ 未コミット変更がないか
+
+**検証失敗時の対応**:
+- localPath未設定: 警告を出力し、該当リポジトリをスキップ
+- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
+- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
+- ブランチ不一致: 警告を出力（続行可能）
+- 未コミット変更: 警告を出力（続行可能）
+
 ### Step 3: チェックポイント確認
 
 `docs/michi/$1/.checkpoint-impl.json` の存在を確認
@@ -248,7 +266,7 @@ repo-spec-executorサブエージェントを使用して、以下のリポジ
 
   タスクを生成してください:
   cd {localPath}
-  /kiro:spec-tasks {feature}
+  /michi:spec-tasks {feature}
   ```
 
 - **localPath未設定**:
@@ -256,8 +274,19 @@ repo-spec-executorサブエージェントを使用して、以下のリポジ
   警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
   ```
 
+- **Michi未セットアップ**:
+  ```
+  ⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
+
+  セットアップコマンド:
+  cd {localPath} && npx @sk8metal/michi-cli@latest init
+
+  セットアップ完了後、このコマンドを再実行してください。
+  ```
+
 ### Fallback Strategy
 - localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
 - サブエージェント失敗: チェックポイント保存し、リトライ可能にする
 - テスト失敗: 自動修正を試行（最大3回）、失敗時はチェックポイント保存
 

package/templates/claude/commands/michi-multi-repo/propagate-specs.md

@@ -57,12 +57,14 @@ Multi-Repoプロジェクト **$1** の全リポジトリに対して、仕様
 - ✅ localPathが設定されているか
 - ✅ ディレクトリが存在するか
 - ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
+- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
 - ⚠️ 設定されたブランチと現在のブランチが一致するか
 - ⚠️ 未コミット変更がないか
 
 **検証失敗時の対応**:
 - localPath未設定: 警告を出力し、該当リポジトリをスキップ
 - ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
+- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
 - ブランチ不一致: 警告を出力（続行可能）
 - 未コミット変更: 警告を出力（続行可能）
 
@@ -182,7 +184,7 @@ C) キャンセル
    `/michi-multi-repo:spec-review $1`
 
 2. 合格後、各リポジトリでタスク生成:
-   各リポジトリで `/kiro:spec-tasks {feature}` を実行
+   各リポジトリで `/michi:spec-tasks {feature}` を実行
 
 3. 実装を開始:
    `/michi-multi-repo:impl-all $1`
@@ -255,6 +257,16 @@ C) キャンセル
   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
@@ -265,6 +277,7 @@ C) キャンセル
 
 ### Fallback Strategy
 - localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
 - サブエージェント失敗: チェックポイント保存し、リトライ可能にする
 - 全リポジトリ失敗: エラーレポート出力し、ユーザーに対処方法を案内
 

package/templates/claude/commands/michi-multi-repo/spec-review.md

@@ -53,13 +53,16 @@ Multi-Repoプロジェクト **$1** の全リポジトリを対象に、クロ
 ### Step 2: localPath 検証
 
 各リポジトリについて以下を確認:
+- localPathが設定されているか
 - ディレクトリが存在するか
-- Gitリポジトリか
+- Gitリポジトリか (`.git/`ディレクトリ確認)
+- Michiがセットアップ済みか (`.kiro/project.json`確認)
 - 仕様ファイルが存在するか
 
 **検証失敗時の対応**:
 - localPath未設定: 警告を出力し、スキップ
 - ディレクトリ不存在: エラーを出力し、スキップ
+- Michi未セットアップ: 警告を出力し、スキップ
 - 仕様ファイル不存在: 警告を出力し、利用可能情報でレビュー続行
 
 ### Step 3: サブエージェント起動
@@ -141,7 +144,7 @@ cross-repo-reviewerサブエージェントを使用して、以下のプロジ
 ### 次のステップ
 
 1. 各リポジトリでタスク生成:
-   各リポジトリで `/kiro:spec-tasks {feature}` を実行
+   各リポジトリで `/michi:spec-tasks {feature}` を実行
 
 2. 全リポジトリで実装を開始:
    `/michi-multi-repo:impl-all $1`
@@ -231,6 +234,16 @@ BLOCK問題が検出されました。修正が必須です。
   警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
   ```
 
+- **Michi未セットアップ**:
+  ```
+  ⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
+
+  セットアップコマンド:
+  cd {localPath} && npx @sk8metal/michi-cli@latest init
+
+  セットアップ完了後、このコマンドを再実行してください。
+  ```
+
 - **仕様ファイル不存在**:
   ```
   警告: リポジトリ '{name}' に仕様ファイルがありません。
@@ -241,6 +254,7 @@ BLOCK問題が検出されました。修正が必須です。
 
 ### Fallback Strategy
 - localPath未設定: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリでレビュー続行
 - 仕様ファイル不存在: 警告を出力し、利用可能な情報でレビュー
 - 通信エラー: リトライ後、該当リポジトリをスキップ
 

package/templates/claude-agent/agents/repo-spec-executor.md

@@ -108,6 +108,6 @@ michi init
 
 ### 次のステップ
 
-- `/kiro:spec-tasks user-authentication` でタスク生成
+- `/michi:spec-tasks user-authentication` でタスク生成
 - または `/michi:spec-impl user-authentication` で実装開始
 ```