* Fix(docs): READMEをプロジェクトの現状に合わせて修正 README.mdに、未実装のTypeScriptプラグインシステム(v2.0+)に関するドキュメントが含まれていました。これにより、インストールを試みるユーザーに深刻な混乱を招き、時間と第一印象を損なう原因となっていました。 このコミットは、README.mdをプロジェクトの現状(v4.2.0)を正確に反映するように修正します。 - 存在しないTypeScriptプラグインに関する誤解を招く指示や機能説明をすべて削除しました。 - インストールセクションの冒頭に、プラグインシステムが将来のv5.0で計画されている機能であることを明確にするための警告文を追加しました。 - 現在の安定バージョンに対して、`pipx`またはgitクローンを使用する明確で検証済みのインストール手順を提供しました。 - 未実装の機能に基づいていた古いセクション(「V1.xからのアップグレード」やプラグインに関する「トラブルシューティング」など)を削除しました。 - 「What's New」セクションを、現在のv4.2リリースに関連するものに更新しました。 この変更により、ユーザーから報告された問題が解決され、ドキュメントが新規および既存のコントリビューターにとって信頼できるリソースであることが保証されます。 ユーザーのフィードバックに対応し、根本原因を解決することで間接的に課題#466をクローズします。 関連課題: #419 (プラグインシステムの提案) * docs: Fix misleading plugin system documentation Fixes multiple issues reported in GitHub where users wasted hours following installation instructions for non-existent features. Changes: - README.md: Correct version from 4.2.0 to 4.1.6 (matches VERSION file) - README.md: Already had warning about v5.0 plugin system (no change needed) - CLAUDE.md: Add prominent warnings that TypeScript plugin system does NOT exist - CLAUDE.md: Clarify .claude-plugin/ directory is planned for v5.0, not v4.1.6 - CLAUDE.md: Document actual v4.1.6 installation method (pipx/install.sh) - CLAUDE.md: List features that DON'T work yet (plugin commands, marketplace, etc.) Background: - Issue #419: Plugin system is a PROPOSAL, not implemented - .claude-plugin/ directory does not exist in any branch - Current v4.1.6 uses slash commands via `superclaude install` - TypeScript plugin system planned for v5.0 (no ETA) This prevents users from wasting 3-4 hours trying to use features that don't exist, as reported by multiple users. Refs: #419 * docs: Fix version numbers in i18n README files Update version badges in localized README files to match actual version. Changes: - README-ja.md: 4.1.5 → 4.1.6 - README-zh.md: 4.1.5 → 4.1.6 - README-kr.md: 4.1.5 → 4.1.6 All localized READMEs now correctly reflect the current version from the VERSION file (4.1.6). Note: These files did not contain misleading plugin system documentation, only the version number needed correction. --------- Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com>
13 KiB
📊 フレームワーク統計
| コマンド数 | エージェント | モード | MCPサーバー |
|---|---|---|---|
| 21 | 14 | 5 | 6 |
| スラッシュコマンド | 専門AI | 動作モード | 統合サービス |
🎯 概要
SuperClaudeはメタプログラミング設定フレームワークで、動作指示の注入とコンポーネント統制を通じて、Claude Codeを構造化開発プラットフォームに変換します。強力なツールとインテリジェントエージェントを備えたシステム化されたワークフロー自動化を提供します。
⚡ クイックインストール
インストール方法を選択
| 方法 | コマンド | 最適な用途 |
|---|---|---|
| 🐍 pipx | pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install |
✅ 推奨 - Linux/macOS |
| 📦 pip | pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install |
従来のPython環境 |
| 🌐 npm | npm install -g @bifrost_inc/superclaude && superclaude install |
クロスプラットフォーム、Node.jsユーザー |
⚠️ 重要:SuperClaude V3からのアップグレード
SuperClaude V3がインストールされている場合は、V4をインストールする前にアンインストールする必要があります:
# V3を最初にアンインストール
関連するファイルとディレクトリをすべて削除:
*.md *.json および commands/
# その後V4をインストール
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install
✅ アップグレード時に保持される内容:
- ✓ カスタムスラッシュコマンド(
commands/sc/外のもの) - ✓
CLAUDE.md内のカスタム内容 - ✓ Claude Codeの
.claude.json、.credentials.json、settings.json、settings.local.json - ✓ 追加したカスタムエージェントとファイル
⚠️ 注意: V3の他のSuperClaude関連.jsonファイルは競合を引き起こす可能性があるため削除してください。
💡 PEP 668エラーのトラブルシューティング
# オプション1:pipxを使用(推奨)
pipx install SuperClaude
# オプション2:ユーザーインストール
pip install --user SuperClaude
# オプション3:強制インストール(注意して使用)
pip install --break-system-packages SuperClaude
💖 プロジェクトを支援
正直に言うと、SuperClaudeの維持には時間とリソースが必要です。
Claude Maxサブスクリプションだけでもテスト用に月100ドルかかり、それに加えてドキュメント、バグ修正、機能開発に費やす時間があります。 日常の作業でSuperClaudeの価値を感じていただけるなら、プロジェクトの支援をご検討ください。 数ドルでも基本コストをカバーし、開発を継続することができます。
コード、フィードバック、または支援を通じて、すべての貢献者が重要です。このコミュニティの一員でいてくれてありがとう!🙏
☕ Ko-fi一回限りの貢献 |
🎯 Patreon月額支援 |
💜 GitHub柔軟な階層 |
あなたの支援により可能になること:
| 項目 | コスト/影響 |
|---|---|
| 🔬 Claude Maxテスト | 検証とテスト用に月100ドル |
| ⚡ 機能開発 | 新機能と改善 |
| 📚 ドキュメンテーション | 包括的なガイドと例 |
| 🤝 コミュニティサポート | 迅速な問題対応とヘルプ |
| 🔧 MCP統合 | 新しいサーバー接続のテスト |
| 🌐 インフラストラクチャ | ホスティングとデプロイメントのコスト |
注意: ただし、プレッシャーはありません。フレームワークはいずれにしてもオープンソースのままです。人々がそれを使用し、評価していることを知るだけでもモチベーションになります。コード、ドキュメント、または情報の拡散による貢献も助けになります!🙏
🎉 V4の新機能
バージョン4は、コミュニティフィードバックと実際の使用パターンに基づいて重要な改善をもたらします。
🤖 よりスマートなエージェントシステム14の専門エージェントがドメイン専門知識を持ちます:
|
📝 改良された名前空間すべてのコマンドに**
|
🔧 MCPサーバー統合6つの強力なサーバーが連携:
|
🎯 動作モード異なるコンテキストのための5つの適応モード:
|
⚡ 最適化されたパフォーマンスより小さなフレームワーク、より大きなプロジェクト:
|
📚 ドキュメントの全面見直し開発者のための完全な書き直し:
|
📚 ドキュメント
🇯🇵 SuperClaude完全日本語ガイド
| 🚀 はじめに | 📖 ユーザーガイド | 🛠️ 開発者リソース | 📋 リファレンス |
|---|---|---|---|
|
|
🤝 貢献
SuperClaudeコミュニティに参加
あらゆる種類の貢献を歓迎します!お手伝いできる方法は以下のとおりです:
| 優先度 | 領域 | 説明 |
|---|---|---|
| 📝 高 | ドキュメント | ガイドの改善、例の追加、タイプミス修正 |
| 🔧 高 | MCP統合 | サーバー設定の追加、統合テスト |
| 🎯 中 | ワークフロー | コマンドパターンとレシピの作成 |
| 🧪 中 | テスト | テストの追加、機能の検証 |
| 🌐 低 | 国際化 | ドキュメントの他言語への翻訳 |