mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00

Files

kazuki c91a3a4805 refactor: migrate plugin structure from .claude-plugin to project root

Restructure plugin to follow Claude Code official documentation:
- Move TypeScript files from .claude-plugin/* to project root
- Create Markdown command files in commands/
- Update plugin.json to reference ./commands/*.md
- Add comprehensive plugin installation guide

Changes:
- Commands: pm.md, research.md, index-repo.md (new Markdown format)
- TypeScript: pm/, research/, index/ moved to root
- Hooks: hooks/hooks.json moved to root
- Documentation: PLUGIN_INSTALL.md, updated CLAUDE.md, Makefile

Note: This commit represents transition state. Original TypeScript-based
execution system was replaced with Markdown commands. Further redesign
needed to properly integrate Skills and Hooks per official docs.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-21 16:37:35 +09:00

3.9 KiB

Raw Blame History

SuperClaude Plugin Installation Guide

公式インストール方法（推奨）

前提条件

ripgrep のインストール
```
brew install ripgrep
```
環境変数の設定（~/.zshrc または ~/.bashrc に追加）
```
export USE_BUILTIN_RIPGREP=0
```
シェルの再起動
```
exec $SHELL
```

インストール手順

方法A: ローカルマーケットプレイス経由（推奨）

Claude Code でマーケットプレイスを追加:

/plugin marketplace add /Users/kazuki/github/superclaude

プラグインをインストール:

/plugin install pm-agent@superclaude-local

Claude Code を再起動
動作確認:
```
/pm
/research
/index-repo
```

方法B: 開発者モード（直接コピー）

注意: この方法は開発中のテスト用です。公式方法（方法A）の使用を推奨します。

# プロジェクトルートで実行
make reinstall-plugin-dev

Claude Code を再起動後、コマンドが利用可能になります。

インストールされるコマンド

/pm

PM Agent モードを起動。以下の機能を提供：

90%信頼度チェック（実装前）
並列実行最適化
トークン予算管理
エビデンスベース開発

/research

Deep Research モード。以下の機能を提供：

並列Web検索（Tavily MCP）
公式ドキュメント優先
ソース検証
信頼度付き結果

/index-repo

リポジトリインデックス作成。以下の機能を提供：

プロジェクト構造解析
94%トークン削減（58K → 3K）
エントリポイント特定
モジュールマップ生成

フックの自動実行

SessionStart フックにより、新しいセッション開始時に /pm コマンドが自動実行されます。

無効化したい場合は、~/.claude/plugins/pm-agent/hooks/hooks.json を編集してください。

トラブルシューティング

コマンドが認識されない場合

ripgrep の確認:
```
which rg
rg --version
```
インストールされていない場合：
```
brew install ripgrep
```

環境変数の確認:

echo $USE_BUILTIN_RIPGREP

設定されていない場合：

echo 'export USE_BUILTIN_RIPGREP=0' >> ~/.zshrc
exec $SHELL

プラグインの確認:
```
ls -la ~/.claude/plugins/pm-agent/
```
存在しない場合は再インストール：
```
make reinstall-plugin-dev
```
Claude Code を再起動

それでも動かない場合

Claude Code のバージョンを確認してください。2.0.x には既知のバグがあります：

GitHub Issue #8831: Custom slash commands not discovered

回避策：

NPM版に切り替える（Homebrew版にバグの可能性）
ripgrep をシステムにインストール（上記手順）

プラグイン構造（参考）

~/.claude/plugins/pm-agent/
├── plugin.json          # プラグインメタデータ
├── marketplace.json     # マーケットプレイス情報
├── commands/            # Markdown コマンド
│   ├── pm.md
│   ├── research.md
│   └── index-repo.md
└── hooks/
    └── hooks.json       # SessionStart フック設定

開発者向け情報

プラグインのソースコードは /Users/kazuki/github/superclaude/ にあります。

変更を反映するには：

make reinstall-plugin-dev
# Claude Code を再起動

サポート

問題が発生した場合は、以下を確認してください：

公式ドキュメント: https://docs.claude.com/ja/docs/claude-code/plugins
GitHub Issues: https://github.com/anthropics/claude-code/issues
プロジェクトドキュメント: CLAUDE.md, PLANNING.md

3.9 KiB Raw Blame History Unescape Escape