@sk8metal/michi-cli 0.11.0 → 0.13.0

package/templates/codex/prompts/confluence-sync.md

@@ -1,177 +0,0 @@
----
-description: Confluenceへのドキュメント同期 - Michi仕様書をConfluenceに連携
-argument-hint: [FEATURE=<機能名>]
----
-# Michi Confluence Sync
-
-機能「$1」の仕様ドキュメントをConfluenceに同期します。
-
-## 前提条件
-
-### 環境変数の設定
-以下の環境変数が必要です：
-```bash
-ATLASSIAN_URL=https://your-domain.atlassian.net
-ATLASSIAN_EMAIL=your-email@example.com
-ATLASSIAN_API_TOKEN=your-api-token
-```
-
-### プロジェクトメタデータ
-`.kiro/project.json`に以下が設定されていること：
-- `confluenceSpaceKey`: Confluenceスペースキー
-- `confluenceLabels`: 自動付与するラベル
-
-## 同期対象ファイル
-
-以下のファイルをConfluenceページに変換して同期します：
-
-1. **要件定義書**
-   - ソース: `.kiro/specs/$1/requirements.md`
-   - タイトル: `[$1] 要件定義`
-
-2. **設計ドキュメント**
-   - ソース: `.kiro/specs/$1/design.md`
-   - タイトル: `[$1] 設計書`
-
-3. **タスク一覧**（オプション）
-   - ソース: `.kiro/specs/$1/tasks.md`
-   - タイトル: `[$1] タスク管理`
-
-## 実行手順
-
-### 1. 環境変数の確認
-```typescript
-// 必要な環境変数をチェック
-const requiredEnvVars = [
-  'ATLASSIAN_URL',
-  'ATLASSIAN_EMAIL',
-  'ATLASSIAN_API_TOKEN'
-];
-
-for (const envVar of requiredEnvVars) {
-  if (!process.env[envVar]) {
-    console.error(`❌ ${envVar} が設定されていません`);
-    process.exit(1);
-  }
-}
-```
-
-### 2. プロジェクトメタデータの読み込み
-```typescript
-import { readFileSync } from 'fs';
-
-const projectMeta = JSON.parse(
-  readFileSync('.kiro/project.json', 'utf-8')
-);
-
-const spaceKey = projectMeta.confluenceSpaceKey;
-const labels = projectMeta.confluenceLabels || [];
-```
-
-### 3. Confluence APIクライアントの初期化
-```typescript
-import { ConfluenceClient } from '../path/to/confluence-client';
-
-const confluence = new ConfluenceClient({
-  url: process.env.ATLASSIAN_URL!,
-  email: process.env.ATLASSIAN_EMAIL!,
-  apiToken: process.env.ATLASSIAN_API_TOKEN!
-});
-```
-
-### 4. Markdownファイルの読み込みと変換
-```typescript
-const requirements = readFileSync(
-  `.kiro/specs/$1/requirements.md`,
-  'utf-8'
-);
-
-// Markdown → Confluence Storage Format変換
-const confluenceHtml = convertMarkdownToConfluence(requirements);
-```
-
-### 5. ページの作成または更新
-```typescript
-// 既存ページの検索
-const existingPage = await confluence.findPageByTitle(
-  spaceKey,
-  `[$1] 要件定義`
-);
-
-if (existingPage) {
-  // 更新
-  await confluence.updatePage(existingPage.id, {
-    title: `[$1] 要件定義`,
-    body: confluenceHtml,
-    version: existingPage.version + 1
-  });
-  console.log('✅ ページを更新しました');
-} else {
-  // 新規作成
-  const newPage = await confluence.createPage({
-    spaceKey,
-    title: `[$1] 要件定義`,
-    body: confluenceHtml,
-    labels
-  });
-  console.log('✅ ページを作成しました:', newPage.url);
-}
-```
-
-### 6. 同期結果の報告
-```typescript
-console.log('\n📊 Confluence同期結果:');
-console.log(`  機能: $1`);
-console.log(`  スペース: ${spaceKey}`);
-console.log(`  同期ファイル数: 2`);
-console.log(`  ラベル: ${labels.join(', ')}`);
-```
-
-## エラーハンドリング
-
-### 認証エラー
-```
-❌ Confluence API認証失敗
-- ATLASSIAN_URLが正しいか確認
-- API Tokenが有効か確認
-- メールアドレスが正しいか確認
-```
-
-### スペースが見つからない
-```
-❌ Confluenceスペースが見つかりません
-- .kiro/project.jsonのconfluenceSpaceKeyを確認
-- スペースへのアクセス権限を確認
-```
-
-### ページ作成失敗
-```
-❌ ページ作成に失敗しました
-- スペースへの書き込み権限を確認
-- タイトルの重複がないか確認
-```
-
-## Markdown変換の注意点
-
-Confluenceは独自のStorage Format（XHTML）を使用するため、以下に注意：
-
-- **コードブロック**: \`\`\`言語 → `<ac:structured-macro ac:name="code">`
-- **表**: GitHub Markdown → Confluence Table
-- **画像**: 相対パス → Confluence添付ファイル
-- **リンク**: 他の.mdファイル → Confluenceページリンク
-
-## 参考リソース
-
-- [Confluence REST API ドキュメント](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/)
-- [Storage Format仕様](https://confluence.atlassian.com/doc/confluence-storage-format-790796544.html)
-- Michiの`scripts/utils/confluence-client.ts`実装を参照
-
-## 使用例
-
-```bash
-# Codex CLIから実行
-/prompts:confluence-sync FEATURE=user-authentication
-
-# 複数ファイルを一括同期（カスタムスクリプト）
-node scripts/sync-all-specs-to-confluence.js
-```

package/templates/codex/rules/README.md

@@ -1,210 +0,0 @@
-# Codex CLI + Michi Integration Guide
-
-## 🎉 Updated Integration with cc-sdd
-
-**Good News!** Codex CLIは[cc-sdd](https://github.com/gotalab/cc-sdd)と統合することで、Michiワークフローを完全にサポートできるようになりました。
-
-## Quick Start
-
-### Step 1: Install cc-sdd (Required)
-
-```bash
-npx cc-sdd@latest --codex --lang ja
-```
-
-**cc-sddがインストールするもの:**
-- ✅ 11個の `/kiro:*` コマンド（`.codex/commands/`）
-- ✅ `AGENTS.md`（`.codex/docs/`）
-- ✅ `.kiro/` ディレクトリ構造
-- ✅ Spec-Driven Development (SDD) ワークフロー
-
-### Step 2: Install Michi Extensions (Automatic)
-
-Michiのセットアップ時に自動的にインストールされます:
-
-```bash
-npx @sk8metal/michi-cli setup-existing --codex --lang ja
-```
-
-**Michi拡張がインストールするもの:**
-- ✅ `/prompts:confluence-sync` コマンド（Confluence連携）
-- ✅ `AGENTS.override.md`（Michi固有ルール）
-- ✅ `.kiro/project.json`（プロジェクトメタデータ）
-
----
-
-## Available Commands
-
-### cc-sdd Commands (11 total)
-
-| Command | Description |
-|---------|-------------|
-| `/kiro:steering` | プロジェクトメモリの生成・更新 |
-| `/kiro:steering-custom` | ドメイン固有ステアリングファイル作成 |
-| `/kiro:spec-init` | 新規仕様フォルダ初期化 |
-| `/kiro:spec-requirements` | 要件定義書作成（EARS形式） |
-| `/kiro:spec-design` | 設計ドキュメント作成 |
-| `/michi:spec-tasks` | タスク分割（並列実行可能） |
-| `/kiro:spec-impl` | TDDベース実装 |
-| `/kiro:spec-status` | ワークフロー進捗確認 |
-| `/kiro:validate-gap` | 既存コードとのギャップ分析 |
-| `/kiro:validate-design` | 設計レビュー |
-| `/kiro:validate-impl` | 実装品質検証 |
-
-### Michi Commands (1 total)
-
-| Command | Description |
-|---------|-------------|
-| `/prompts:confluence-sync` | 仕様ドキュメントをConfluenceに同期 |
-
----
-
-## Workflow Example
-
-### 1. 初期化
-```bash
-/kiro:steering
-```
-→ プロジェクトメモリ（structure.md、tech.md、product.md）を生成
-
-### 2. 仕様作成
-```bash
-/kiro:spec-init FEATURE=user-authentication
-/kiro:spec-requirements FEATURE=user-authentication
-/kiro:spec-design FEATURE=user-authentication
-```
-
-### 3. Confluence同期 (Michi拡張)
-```bash
-/prompts:confluence-sync FEATURE=user-authentication
-```
-→ requirements.mdとdesign.mdをConfluenceページに変換
-
-### 4. 実装
-```bash
-/michi:spec-tasks FEATURE=user-authentication
-/kiro:spec-impl FEATURE=user-authentication
-```
-
-### 5. 検証
-```bash
-/kiro:validate-impl FEATURE=user-authentication
-```
-
----
-
-## Confluence Integration Setup
-
-### 環境変数設定
-`.env`ファイルに以下を追加:
-
-```bash
-ATLASSIAN_URL=https://your-domain.atlassian.net
-ATLASSIAN_EMAIL=your-email@example.com
-ATLASSIAN_API_TOKEN=your-api-token
-```
-
-### プロジェクトメタデータ設定
-`.kiro/project.json`に以下を追加:
-
-```json
-{
-  "confluenceSpaceKey": "YOUR_SPACE",
-  "confluenceLabels": ["ai-development", "michi"]
-}
-```
-
----
-
-## File Structure
-
-```
-project/
-├── .codex/
-│   ├── commands/          # cc-sdd: /kiro:* commands
-│   ├── docs/
-│   │   └── AGENTS.md      # cc-sdd: Base project context
-│   └── prompts/           # Michi: /prompts:* commands
-│       └── confluence-sync.md
-├── .kiro/
-│   ├── project.json       # Michi: Project metadata
-│   ├── specs/             # cc-sdd: Feature specifications
-│   │   └── {feature}/
-│   │       ├── requirements.md
-│   │       ├── design.md
-│   │       ├── tasks.md
-│   │       └── spec.json
-│   ├── steering/          # cc-sdd: AI guidance documents
-│   │   ├── structure.md
-│   │   ├── tech.md
-│   │   └── product.md
-│   └── settings/          # cc-sdd: Templates and rules
-└── AGENTS.override.md     # Michi: Project-specific rules
-```
-
----
-
-## Project Metadata
-
-Reference `.kiro/project.json` for project information:
-
-- **Project ID**: {{PROJECT_ID}}
-- **Language**: {{LANG_CODE}}
-- **JIRA Key**: (from project.json)
-- **Confluence Space**: (from project.json)
-- **Confluence Labels**: (from project.json)
-
----
-
-## Michi-Specific Features
-
-### 1. Multi-Language Support
-- Node.js/TypeScript (npm)
-- Java (Gradle only)
-- PHP (Composer)
-
-### 2. Master Test Approach
-- 常に最新の仕様を反映（履歴管理なし）
-- Phase A: Auto (unit, lint, build)
-- Phase B: Manual (integration, e2e, performance, security)
-
-### 3. CI/CD Integration
-- GitHub Actions
-- Screwdriver
-
-### 4. Release Flow
-- セマンティックバージョニング（v<major>.<minor>.<patch>）
-- Confluence手順書
-- JIRA Release管理
-
----
-
-## Troubleshooting
-
-### Q1: cc-sddコマンドが見つからない
-```bash
-# 再インストール
-npx cc-sdd@latest --codex --lang ja
-```
-
-### Q2: Confluence同期が失敗する
-```bash
-# 環境変数を確認
-cat .env | grep ATLASSIAN
-
-# 接続テスト
-curl -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \
-  "$ATLASSIAN_URL/wiki/rest/api/content"
-```
-
-### Q3: AGENTS.override.mdが反映されない
-Codex CLIは`AGENTS.md`と`AGENTS.override.md`を自動的にマージします。プロジェクトルートに配置されていることを確認してください。
-
----
-
-## Learn More
-
-- **cc-sdd**: https://github.com/gotalab/cc-sdd
-- **Michi Documentation**: https://github.com/sk8metalme/michi
-- **Codex CLI**: https://developers.openai.com/codex/cli
-- **Confluence API**: https://developer.atlassian.com/cloud/confluence/rest/v2/

package/templates/cursor/commands/kiro/kiro-spec-impl.md

@@ -1,244 +0,0 @@
-# kiro:spec-impl - Spec Implementation Command
-
-## Overview
-
-This command implements the specifications defined in `tasks.md` following TDD (Test-Driven Development) practices with automatic JIRA integration.
-
-**Key Features:**
-
-- Automatic JIRA info detection from `spec.json`
-- Updates both Epic AND first Story status
-- Creates PR and adds JIRA comments automatically
-
-## Arguments
-
-- `$ARGUMENTS`: Feature name (e.g., "user-auth")
-
-**Note:** JIRA ticket keys are automatically detected from `.kiro/specs/{feature}/spec.json`. No need to specify them manually.
-
-## Pre-requisites
-
-1. `.kiro/specs/{feature}/tasks.md` must exist
-2. `.kiro/specs/{feature}/spec.json` must contain JIRA info (run `michi jira:sync` first)
-3. Environment variables must be configured:
-   - `ATLASSIAN_URL`: JIRA instance URL
-   - `ATLASSIAN_EMAIL`: JIRA user email
-   - `ATLASSIAN_API_TOKEN`: JIRA API token
-   - `GITHUB_TOKEN`: GitHub API token
-   - ~~`GITHUB_REPO`: GitHub repository (owner/repo format)~~ **Deprecated (v0.5.0+)**: Repository info is now automatically loaded from `.kiro/project.json`
-
-## Execution Flow
-
-### 1. Parse Arguments
-
-```
-Input: $ARGUMENTS
-Expected format: "<feature-name>"
-Example: "user-auth"
-```
-
-Extract:
-
-- `FEATURE_NAME`: Feature name from arguments
-
-### 2. JIRA Info Detection (Automatic)
-
-Read JIRA information from `.kiro/specs/$FEATURE_NAME/spec.json`:
-
-```json
-{
-  "jira": {
-    "epicKey": "PROJ-123",
-    "storyKeys": ["PROJ-124", "PROJ-125"],
-    "epicUrl": "https://..."
-  }
-}
-```
-
-**If JIRA info is missing:**
-
-- Ask user: "JIRA info not found. Skip JIRA integration? (y/n)"
-- If yes: Continue without JIRA integration
-- If no: Stop and suggest running `michi jira:sync $FEATURE_NAME` first
-
-### 3. Start Processing (JIRA Status Update)
-
-**Automatically move Epic AND first Story to "In Progress":**
-
-This is handled internally. The workflow will:
-
-1. Transition Epic to "In Progress"
-2. Transition first Story to "In Progress"
-
-### 4. Implementation Phase (TDD)
-
-Read the tasks from `.kiro/specs/$FEATURE_NAME/tasks.md` and implement each Story following TDD:
-
-For each Story in tasks.md:
-
-1. **Read Story Requirements**
-   - Parse the Story section from tasks.md
-   - Identify acceptance criteria and subtasks
-
-2. **Write Tests First (Red)**
-   - Create test files based on acceptance criteria
-   - Run tests to verify they fail
-
-3. **Implement Code (Green)**
-   - Write minimal code to pass tests
-   - Follow the existing code patterns in the project
-
-4. **Refactor (Blue)**
-   - Clean up code while keeping tests green
-   - Apply project coding standards
-
-5. **Commit Changes**
-   - Create atomic commits for each Story
-   - Use conventional commit format: `feat($FEATURE_NAME): Story title`
-
-### 5. Code Review Phase (Automatic)
-
-**Automatically review the implemented code:**
-
-For each Story implementation:
-
-1. **Code Review (/review)**
-   - Execute `/review` command automatically
-   - Analyze the implementation for code quality issues
-   - Check for best practices and potential bugs
-
-2. **Fix Issues if Found**
-   - If review identifies issues, automatically fix them
-   - Commit the fixes
-   - Re-run `/review` to verify fixes
-   - Repeat until `/review` passes without critical issues
-
-3. **Security Review (/security-review)**
-   - Execute `/security-review` command automatically
-   - Scan for security vulnerabilities
-   - Check for common security issues (SQL injection, XSS, etc.)
-
-4. **Fix Security Issues if Found**
-   - If security issues are identified, automatically fix them
-   - Commit the security fixes
-   - Re-run `/security-review` to verify fixes
-   - Repeat until `/security-review` passes without critical issues
-
-**Review Loop:**
-- Maximum iterations: 3 per review type
-- If issues persist after 3 iterations, report to user and ask for manual intervention
-
-### 6. PR Creation Confirmation
-
-**Ask user before creating PR:**
-
-After all reviews pass successfully, ask the user:
-
-```
-✅ All reviews completed successfully!
-   - Code Review: PASSED
-   - Security Review: PASSED
-
-Would you like to create a Pull Request now? (y/n)
-```
-
-- **If yes**: Proceed to End Processing (Step 7)
-- **If no**: Stop workflow, save current state
-  - User can manually create PR later using:
-    - `jj git push --bookmark <branch-name>`
-    - `gh pr create --head <branch-name> --base main`
-
-### 7. End Processing (PR Creation & JIRA Update)
-
-**Automatically complete the workflow:**
-
-This is handled internally. The workflow will:
-
-1. Push the branch to remote
-2. Create a Pull Request on GitHub
-3. Move Epic AND first Story to "Ready for Review"
-4. Add PR link as a comment on the Epic
-
-## Usage Examples
-
-```
-/kiro:spec-impl user-auth
-```
-
-```
-/kiro:spec-impl payment-gateway
-```
-
-## Workflow Comparison
-
-### Before (3 steps with manual JIRA keys)
-
-```bash
-michi spec-impl:start user-auth PROJ-123
-/kiro:spec-impl user-auth PROJ-123
-michi spec-impl:complete user-auth PROJ-123
-```
-
-### After (1 command with auto-detection)
-
-```
-/kiro:spec-impl user-auth
-# JIRA info auto-detected from spec.json
-# Epic + first Story -> "In Progress"
-# TDD implementation
-# Automatic code review (/review)
-#   - Fix issues if found
-#   - Re-review until passed
-# Automatic security review (/security-review)
-#   - Fix security issues if found
-#   - Re-review until passed
-# Ask user: "Create PR now? (y/n)"
-#   - If yes:
-#     - PR creation
-#     - Epic + first Story -> "Ready for Review"
-#     - PR link commented on JIRA
-#   - If no:
-#     - Save state, exit workflow
-```
-
-## JIRA Status Mapping
-
-Default status names (customizable in `.michi/config.json`):
-
-| Phase | Default Status   | Targets            |
-| ----- | ---------------- | ------------------ |
-| Start | In Progress      | Epic + First Story |
-| End   | Ready for Review | Epic + First Story |
-
-To customize, add to `.michi/config.json`:
-
-```json
-{
-  "jira": {
-    "statusMapping": {
-      "inProgress": "In Progress",
-      "readyForReview": "Ready for Review"
-    }
-  }
-}
-```
-
-## Error Handling
-
-- **JIRA info not found**: Interactive prompt to skip JIRA integration
-- **JIRA transition fails**: Check available transitions for the current status
-- **Review fails (max iterations exceeded)**: Report issues to user and ask for manual intervention
-- **Security review fails (max iterations exceeded)**: Report vulnerabilities to user and ask for manual intervention
-- **User declines PR creation**: Save current state, workflow stops (user can create PR manually later)
-- **PR creation fails**: Ensure the branch is pushed to remote
-- **JIRA comment fails**: The PR URL is still returned for manual update
-
-## Notes
-
-- JIRA info is automatically detected from `spec.json` (populated by `michi jira:sync`)
-- Both Epic AND first Story are updated together
-- The branch name defaults to `feature/{feature-name}`
-- Individual JIRA operations can still be done via `michi jira:transition` and `michi jira:comment`
-- Code reviews (`/review` and `/security-review`) are executed automatically after implementation
-- Review loop has a maximum of 3 iterations per review type to prevent infinite loops
-- User can decline PR creation and manually create it later if needed