@sk8metal/michi-cli 0.10.1 → 0.12.0

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

@@ -0,0 +1,117 @@
+---
+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
+```
+
+---
+
+## 実装上の注意点
+
+1. **基底コマンドの実行結果を維持**:
+   - `/kiro:spec-tasks` の「Output Description」セクションで出力されるタスクサマリーは維持してください
+   - Michi Extensionの選択肢はその**後**に追加で表示します
+
+2. **言語設定の考慮**:
+   - メッセージは日本語固定（将来的にspec.jsonの言語設定に対応する可能性あり）
+
+3. **ユーザーインタラクション**:
+   - 選択肢を表示した後、ユーザーの入力を待ちます
+   - 選択に応じて適切なコマンド/処理を案内または実行してください
+
+---
+
+**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、Phase 0.6（JIRA同期）への誘導を Next Phase として案内します。これにより、タスク分割からJIRA連携へのスムーズな移行を実現します。

package/templates/claude-agent/rules/code-size-monitor.md

@@ -0,0 +1,26 @@
+---
+globs:
+  - "src/**/*"
+  - "scripts/**/*"
+  - "test/**/*"
+  - "tests/**/*"
+alwaysApply: false
+---
+
+# Code Generation Size Monitoring
+
+PROACTIVELY: /michi:spec-impl の各タスク完了後に使用。
+
+## Reference
+@templates/claude-agent/rules/code-size-rules.md
+
+## Execution Timing
+1. 各sub-task完了後
+2. コミット前
+3. 長時間のコーディングセッション中（3-5ファイル変更ごと）
+
+## Actions on Threshold Exceeded
+500行超過時:
+A) 現在の変更でPRを作成する（推奨）
+B) 作業を続行する（警告付き）
+C) 分割戦略を提案してもらう

package/templates/claude-agent/rules/code-size-rules.md

@@ -0,0 +1,32 @@
+# Code Size Rules
+
+## Threshold
+
+| Metric | Value |
+|--------|-------|
+| Maximum Diff Lines | 500 lines |
+| Warning Threshold | 400 lines |
+
+## Target Paths
+- src/
+- scripts/
+- test/
+- tests/
+
+## Exclusion Patterns (Lock Files)
+- package-lock.json, yarn.lock, pnpm-lock.yaml
+- composer.lock, Gemfile.lock, poetry.lock, Pipfile.lock
+- Cargo.lock, go.sum
+
+## Exclusion Patterns (Generated Files)
+- *.min.js, *.min.css, *.map
+- dist/*, build/*, coverage/*, .next/*
+- *.d.ts, *.generated.ts, `__snapshots__/*`
+
+## Status Indicators
+
+| Status | Condition |
+|--------|-----------|
+| ✅ OK | diff < 400 lines |
+| ⚠️ Warning | 400 <= diff < 500 lines |
+| ❌ Exceeded | diff >= 500 lines |

package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md

@@ -44,7 +44,7 @@
 設計が承認された場合（GO Decision）:
 1. Phase 0.3: テストタイプの選択を実施
 2. Phase 0.4: テスト仕様書の作成を実施
-3. Phase 0.5: タスク分割（`/kiro:spec-tasks`）に進む
+3. Phase 0.5: タスク分割（`/michi:spec-tasks`）に進む
 
 詳細は [テスト計画フロー](docs/user-guide/testing/test-planning-flow.md) を参照してください。
 

package/docs/context.md

@@ -1,59 +0,0 @@
-# プロジェクトコンテキスト
-
-## 現在のタスク
-Issue #58: テンプレートディレクトリ名の整合性修正
-
-## 進捗状況
-- **開始日時**: 2025-11-17 (月)
-- **現在フェーズ**: Phase 0 - 計画策定
-- **完了率**: 0%
-
-## タスク概要
-
-### Issue #58: テンプレートディレクトリ名の不整合修正
-- **優先度**: 低（技術的負債）
-- **工数**: 0.5h（予想）
-- **ステータス**: 🔄 進行中
-
-## 問題の詳細
-
-### 現状
-- **テンプレートソース**: `templates/claude-agent/rules/`
-- **配置先**: `.claude/subagents`
-
-`rules`という名前のディレクトリが`subagents`という名前で配置されるため、新規開発者にとって混乱を招く。
-
-### 影響範囲
-- **重大度**: 低（機能的には動作している）
-- **保守性**: 中（新規開発者への混乱）
-- **リスク**: 低（テンプレートコピーロジックのみに限定）
-
-### 推奨解決策
-**Option 1** (推奨): テンプレートディレクトリをリネーム
-- `templates/claude-agent/rules/` → `templates/claude-agent/subagents/`
-- シンプルで明確、一貫性がある
-
-**Option 2**: 柔軟なテンプレート命名をサポート
-- `EnvironmentConfig`に`rulesDirTemplateName`を追加
-- より柔軟だが複雑性が増す
-
-## 影響ファイル
-- `templates/claude-agent/rules/` (リネーム対象)
-- `src/commands/setup-existing.ts` (変数名を確認)
-
-## 前提条件
-- Issue #55, #56は完了済み
-- 全テストスイート成功（235 passed）
-
-## 完了条件
-- [ ] テンプレートディレクトリを`subagents`にリネーム
-- [ ] 全テストスイート成功
-- [ ] Lintエラーなし
-- [ ] ドキュメント更新（必要に応じて）
-
-## メモ
-- TDD原則を遵守（既存テストで動作確認）
-- Option 1（リネームのみ）を採用予定
-
----
-最終更新: 2025-11-17 (月) - Issue #58開始

package/docs/michi-development/contributing/development.md

@@ -1,341 +0,0 @@
-# Michi 開発環境セットアップガイド
-
-このガイドは、Michiプロジェクト自体の開発に貢献したい開発者向けのセットアップ手順です。
-
-Michiを使ってプロジェクト開発を始めたい場合は、[利用者向けセットアップガイド](../getting-started/setup.md)を参照してください。
-
-## 前提条件
-
-- Node.js 20.x以上
-- npm 10.x以上
-- Git または Jujutsu (jj)
-- Cursor IDE または VS Code
-- GitHub CLI (gh) - PR作成時に使用
-
-## 1. リポジトリのフォーク・クローン
-
-### Gitを使う場合
-
-```bash
-# リポジトリをフォーク（GitHubのWebインターフェースで実行）
-
-# フォークしたリポジトリをクローン
-git clone https://github.com/YOUR_USERNAME/michi
-cd michi
-
-# 上流リポジトリをremoteに追加
-git remote add upstream https://github.com/sk8metalme/michi
-```
-
-### Jujutsu (jj) を使う場合
-
-```bash
-# リポジトリをクローン
-jj git clone https://github.com/YOUR_USERNAME/michi
-cd michi
-
-# 上流リポジトリを設定
-jj git remote add upstream https://github.com/sk8metalme/michi
-```
-
-## 2. 依存関係のインストール
-
-```bash
-npm install
-```
-
-## 3. cc-sddのインストール（開発用）
-
-```bash
-# Cursor IDE を使用する場合
-npx cc-sdd@latest --lang ja --cursor
-
-# Claude Code を使用する場合
-npx cc-sdd@latest --lang ja --claude
-```
-
-## 4. 環境変数の設定
-
-開発環境でも、Confluence/JIRA連携のテストのために環境変数が必要です。
-
-```bash
-# テンプレートファイルをコピー
-cp env.example .env
-```
-
-詳細な設定方法は、[利用者向けセットアップガイド](../getting-started/setup.md#3-環境変数の設定)を参照してください。
-
-## 5. 開発ワークフロー
-
-### ブランチ戦略
-
-- `main`: 本番環境相当（常にデプロイ可能な状態）
-- `feature/XXX`: 機能開発用
-- `bugfix/XXX`: バグ修正用
-- `docs/XXX`: ドキュメント更新用
-
-### 開発サイクル
-
-1. **issueを作成** または 既存のissueを確認
-2. **ブランチを作成**
-   ```bash
-   git checkout -b feature/your-feature-name
-   # または jj new -m "feature/your-feature-name"
-   ```
-3. **コードを実装**
-4. **テストを追加・実行**
-5. **コミット**
-6. **PRを作成**
-
-## 6. コーディング規約
-
-### TypeScript
-
-- **Strict Mode**: `tsconfig.json`で厳格な型チェックを有効化
-- **ESLint**: すべてのコードはESLintルールに準拠
-- **Prettier**: コードフォーマットは自動化
-
-### コミットメッセージ
-
-[Conventional Commits](https://www.conventionalcommits.org/)形式を使用：
-
-```
-<type>(<scope>): <subject>
-
-<body>
-
-<footer>
-```
-
-**Type:**
-- `feat`: 新機能
-- `fix`: バグ修正
-- `docs`: ドキュメント変更
-- `style`: コードフォーマット（ロジック変更なし）
-- `refactor`: リファクタリング
-- `test`: テスト追加・修正
-- `chore`: ビルドプロセスやツールの変更
-
-**例:**
-```
-feat(confluence): Confluence階層構造のカスタマイズ機能を追加
-
-- config.jsonでhierarchy.modeを設定可能に
-- simple/detailedの2モードをサポート
-
-Closes #123
-```
-
-## 7. テストの実行
-
-### 全テストを実行
-
-```bash
-npm run test:run
-```
-
-### watchモードでテスト
-
-```bash
-npm test
-```
-
-### カバレッジ確認
-
-```bash
-npm run test:coverage
-```
-
-**カバレッジ目標**: 95%以上
-
-### 型チェック
-
-```bash
-npm run type-check
-```
-
-## 8. リントとフォーマット
-
-### リント実行
-
-```bash
-npm run lint
-```
-
-### リント自動修正
-
-```bash
-npm run lint:fix
-```
-
-### フォーマット
-
-```bash
-npm run format
-```
-
-## 8-1. Pre-commitフック（自動リント・テスト）
-
-このプロジェクトでは、**husky**と**lint-staged**を使用して、コミット前に自動的にリントとテストを実行します。
-
-### 動作
-
-コミットを実行すると、以下の処理が自動的に実行されます：
-
-1. **lint-staged**: ステージングされたファイルに対して自動リント・フォーマット
-   - TypeScript/JavaScriptファイル: ESLint自動修正 + Prettierフォーマット
-   - JSON/Markdown/YAMLファイル: Prettierフォーマット
-2. **テスト実行**: すべてのテストを実行（`npm run test:run`）
-
-### フックをスキップする場合（非推奨）
-
-緊急時のみ、以下の方法でフックをスキップできます：
-
-```bash
-# Gitの場合
-git commit --no-verify -m "緊急修正"
-
-# Jujutsuの場合
-jj commit --no-verify -m "緊急修正"
-```
-
-**注意**: フックをスキップしたコミットは、CI/CDで失敗する可能性があります。
-
-### フックの設定確認
-
-```bash
-# pre-commitフックの内容を確認
-cat .husky/pre-commit
-
-# lint-stagedの設定を確認
-cat package.json | grep -A 10 "lint-staged"
-```
-
-## 9. ビルドとパッケージング
-
-### TypeScriptビルド
-
-```bash
-npm run build
-```
-
-### ローカルでのパッケージテスト
-
-```bash
-# パッケージをリンク
-npm link
-
-# 他のプロジェクトでテスト
-cd /path/to/test-project
-npm link @sk8metal/michi-cli
-
-# テスト後、リンクを解除
-npm unlink @sk8metal/michi-cli
-```
-
-## 10. PRの作成
-
-### PR作成前のチェックリスト
-
-- [ ] すべてのテストがパス
-- [ ] カバレッジが95%以上
-- [ ] ESLintエラーが0件
-- [ ] TypeScript型エラーが0件
-- [ ] コミットメッセージがConventional Commits形式
-- [ ] ドキュメントを更新（必要に応じて）
-
-### PRの作成
-
-```bash
-# GitHubにプッシュ
-git push origin feature/your-feature-name
-
-# PRを作成
-gh pr create --title "feat: 機能の説明" --body "詳細な説明"
-```
-
-### Jujutsuの場合
-
-```bash
-# 変更をコミット
-jj commit -m "feat: 機能の説明"
-
-# GitHubにプッシュ
-jj git push
-
-# PRを作成
-gh pr create --title "feat: 機能の説明" --body "詳細な説明"
-```
-
-### PRテンプレート
-
-```markdown
-## 概要
-何を実装したか簡潔に説明
-
-## 変更内容
-- 変更点1
-- 変更点2
-
-## テスト
-- [ ] 単体テスト追加
-- [ ] E2Eテスト追加（必要に応じて）
-- [ ] 手動テスト実施
-
-## チェックリスト
-- [ ] テストがパス
-- [ ] カバレッジ95%以上
-- [ ] ESLintエラー0件
-- [ ] ドキュメント更新
-
-## 関連Issue
-Closes #123
-```
-
-## 11. CI/CDパイプライン
-
-プッシュすると、以下のCI/CDパイプラインが自動実行されます：
-
-- **リント**: ESLint実行
-- **型チェック**: TypeScriptコンパイル
-- **テスト**: Vitest実行
-- **カバレッジ**: Codecovにアップロード
-- **セキュリティスキャン**: npm auditとSnyk
-
-詳細は [CI/CDガイド](./ci-cd.md) を参照してください。
-
-## 12. トラブルシューティング
-
-### npm install でエラーが出る
-
-キャッシュをクリア：
-```bash
-npm cache clean --force
-rm -rf node_modules package-lock.json
-npm install
-```
-
-### テストが失敗する
-
-```bash
-# キャッシュをクリア
-npm run test:run -- --clearCache
-
-# 特定のテストのみ実行
-npm run test:run -- path/to/test-file.test.ts
-```
-
-### GitHub認証エラー
-
-```bash
-gh auth status
-gh auth login
-gh auth setup-git
-```
-
-## 参考リンク
-
-- [コントリビューションガイド](../../CONTRIBUTING.md)
-- [リリース手順](./release.md)
-- [CI/CD設定](./ci-cd.md)
-- [Jujutsu公式ドキュメント](https://martinvonz.github.io/jj/)