@sk8metal/michi-cli

v0.22.0

Published

2 months ago

Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation

0High
0Medium
0Low

sk8metal

ai development workflow automation confluence jira atlassian spec-driven-development cc-sdd github

Michi (道)

Managed Intelligent Comprehensive Hub for Integration

AI駆動開発ワークフロー自動化プラットフォーム

概要

Michiは、開発フロー全体（要件定義→設計→タスク分割→実装→テスト→リリース）をAIで自動化するプラットフォームです。

Powered by cc-sdd

主な機能

✅ AI駆動開発: Claude Code統合
✅ テスト計画統合: Phase 0.3-0.4でテストタイプ選択とテスト仕様書作成
✅ 品質自動化: OSSライセンスチェック、バージョン監査、自動レビュー
✅ Confluence/JIRA連携: 自動同期、タスク管理、進捗追跡
✅ Multi-Repo管理: マイクロサービス・モノレポ対応
✅ 多言語サポート: Node.js、Java（Gradle）、PHP対応

コードアーキテクチャ

Michiは**オニオンアーキテクチャ（4層構造）**を採用しています：

┌─────────────────────────────────────────┐
│       Presentation Layer (CLI)          │  ← ユーザーインターフェース
├─────────────────────────────────────────┤
│       Application Layer (Use Cases)     │  ← ビジネスロジック調整
├─────────────────────────────────────────┤
│    Infrastructure Layer (External APIs) │  ← 外部サービス統合
├─────────────────────────────────────────┤
│       Domain Layer (Business Logic)     │  ← コアビジネスルール
└─────────────────────────────────────────┘

ハイブリッドアプローチ:

src/ - プロダクションコード（4層構造）
scripts/ - ビルド・開発ツール（層なし）

詳細はアーキテクチャガイドと移行ガイドを参照してください。

ワークフローアーキテクチャ

GitHub (.michi/specs/) ← 情報源（Single Source of Truth）
    ↓ 自動同期
Confluence ← ドキュメント管理
JIRA ← タスク管理・進捗追跡

クイックスタート

Claude Codeプラグイン（推奨）

前提条件: cc-sdd（Spec-Driven Development Core）をセットアップ

npx cc-sdd@latest --claude --lang ja

Michiプラグインのインストール - Claude Code内で実行:

/plugin marketplace add sk8metalme/michi
/plugin install michi@sk8metalme

推奨プラグイン - 併せてインストール:

/plugin marketplace add sk8metalme/ai-agent-setup
/plugin install design-review@ai-agent-setup
/plugin install oss-compliance@ai-agent-setup
/plugin install version-audit@ai-agent-setup
/plugin install e2e-planning@ai-agent-setup

CLIツール（外部ツール連携用）

JIRA/Confluence連携やリリース自動化には、CLIツールを併用します。

npm install -g @sk8metal/michi-cli

注意: michi setup --claude コマンドは廃止予定です。上記のプラグインインストールを使用してください。

基本的な使い方

# 1. 仕様を初期化
/kiro:spec-init "calculator-app: 四則演算を行う電卓アプリ"

# 2. 要件定義
/kiro:spec-requirements calculator-app

# 3. 設計（テスト計画統合版）
/michi:spec-design calculator-app

# 4. タスク分割（JIRA同期確認付き）
/michi:spec-tasks calculator-app

# 5. TDD実装
/michi:spec-impl calculator-app

詳細はクイックスタートガイドを参照してください。

ドキュメント

完全なドキュメントは docs/ を参照してください。

はじめに

クイックスタート - 5分で始めるMichi
インストール - インストール方法
環境設定 - 環境変数とワークフロー設定

ガイド

ワークフロー - 開発フロー全体の説明
Atlassian連携 - JIRA/Confluence連携
Multi-Repo管理 - マイクロサービス開発
Claude Code - Claude Code統合
統括動作確認手順書 - 全機能網羅の動作確認手順（85項目）

リファレンス

CLIコマンド - すべてのmichiコマンド
AIコマンド - /kiro:*, /michi:*コマンド
環境変数 - 環境変数一覧
アーキテクチャ - オニオンアーキテクチャ（4層構造）
移行ガイド - アーキテクチャ移行の詳細

トラブルシューティング

トラブルシューティング - よくある問題と解決策

ワークフロー構造

Michiは以下のフェーズで構成されています:

cc-sdd標準フェーズ

Phase 0.0-0.2: 仕様化（初期化、要件定義、設計）
Phase 0.5: タスク分割
Phase 2: TDD実装

Michi拡張フェーズ

Phase 0.3-0.4: テスト計画（テストタイプ選択、テスト仕様書作成）
Phase 0.6-0.7: 外部ツール連携（JIRA、Confluence）
Phase 1: 環境構築・基盤整備
Phase A: PR前自動テスト（単体テスト、Lint、ビルド）
Phase 3: 追加品質保証（PRマージ後）
Phase B: リリース準備テスト（統合、E2E、パフォーマンス、セキュリティ）
Phase 4-5: リリース準備と実行

詳細はワークフローガイドを参照してください。

技術スタック

対応言語・ツール

Node.js/TypeScript: npm
Java: Gradle（Mavenは非対応）
PHP: Composer

対応AIツール

Claude Code - AI駆動開発ツール（推奨）
Claude Code Subagents - カスタムサブエージェント統合

外部連携

Atlassian: Confluence（ドキュメント管理）、JIRA（タスク管理）
GitHub: Issue、PR、Actions

ライセンス

MIT License - 詳細は LICENSE を参照してください。

コントリビューション

貢献を歓迎します！詳細は CONTRIBUTING.md を参照してください。

サポート

GitHub Issues: https://github.com/sk8metalme/michi/issues
ドキュメント: docs/