mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
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>
This commit is contained in:
161
PLUGIN_INSTALL.md
Normal file
161
PLUGIN_INSTALL.md
Normal file
@@ -0,0 +1,161 @@
|
||||
# SuperClaude Plugin Installation Guide
|
||||
|
||||
## 公式インストール方法(推奨)
|
||||
|
||||
### 前提条件
|
||||
|
||||
1. **ripgrep のインストール**
|
||||
```bash
|
||||
brew install ripgrep
|
||||
```
|
||||
|
||||
2. **環境変数の設定**(~/.zshrc または ~/.bashrc に追加)
|
||||
```bash
|
||||
export USE_BUILTIN_RIPGREP=0
|
||||
```
|
||||
|
||||
3. **シェルの再起動**
|
||||
```bash
|
||||
exec $SHELL
|
||||
```
|
||||
|
||||
### インストール手順
|
||||
|
||||
#### 方法A: ローカルマーケットプレイス経由(推奨)
|
||||
|
||||
1. Claude Code でマーケットプレイスを追加:
|
||||
```
|
||||
/plugin marketplace add /Users/kazuki/github/superclaude
|
||||
```
|
||||
|
||||
2. プラグインをインストール:
|
||||
```
|
||||
/plugin install pm-agent@superclaude-local
|
||||
```
|
||||
|
||||
3. Claude Code を再起動
|
||||
|
||||
4. 動作確認:
|
||||
```
|
||||
/pm
|
||||
/research
|
||||
/index-repo
|
||||
```
|
||||
|
||||
#### 方法B: 開発者モード(直接コピー)
|
||||
|
||||
**注意**: この方法は開発中のテスト用です。公式方法(方法A)の使用を推奨します。
|
||||
|
||||
```bash
|
||||
# プロジェクトルートで実行
|
||||
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` を編集してください。
|
||||
|
||||
## トラブルシューティング
|
||||
|
||||
### コマンドが認識されない場合
|
||||
|
||||
1. **ripgrep の確認**:
|
||||
```bash
|
||||
which rg
|
||||
rg --version
|
||||
```
|
||||
|
||||
インストールされていない場合:
|
||||
```bash
|
||||
brew install ripgrep
|
||||
```
|
||||
|
||||
2. **環境変数の確認**:
|
||||
```bash
|
||||
echo $USE_BUILTIN_RIPGREP
|
||||
```
|
||||
|
||||
設定されていない場合:
|
||||
```bash
|
||||
echo 'export USE_BUILTIN_RIPGREP=0' >> ~/.zshrc
|
||||
exec $SHELL
|
||||
```
|
||||
|
||||
3. **プラグインの確認**:
|
||||
```bash
|
||||
ls -la ~/.claude/plugins/pm-agent/
|
||||
```
|
||||
|
||||
存在しない場合は再インストール:
|
||||
```bash
|
||||
make reinstall-plugin-dev
|
||||
```
|
||||
|
||||
4. **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/` にあります。
|
||||
|
||||
変更を反映するには:
|
||||
```bash
|
||||
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
|
||||
Reference in New Issue
Block a user