From 92f1c8d7147c714739df35e5c55871b3195bd794 Mon Sep 17 00:00:00 2001
From: kazuki <kazuki@kazukinoMacBook-Air.local>
Date: Fri, 17 Oct 2025 02:41:55 +0900
Subject: [PATCH] docs: add suggested commands reference

---
 docs/reference/suggested-commands.md | 150 +++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 docs/reference/suggested-commands.md

diff --git a/docs/reference/suggested-commands.md b/docs/reference/suggested-commands.md
new file mode 100644
index 0000000..4e0e0a3
--- /dev/null
+++ b/docs/reference/suggested-commands.md
@@ -0,0 +1,150 @@
+# 推奨コマンド集
+
+## インストール・セットアップ
+```bash
+# 推奨インストール方法
+pipx install SuperClaude
+pipx upgrade SuperClaude
+SuperClaude install
+
+# または pip
+pip install SuperClaude
+pip install --upgrade SuperClaude
+SuperClaude install
+
+# コンポーネント一覧
+SuperClaude install --list-components
+
+# 特定コンポーネントのインストール
+SuperClaude install --components core
+SuperClaude install --components mcp --force
+```
+
+## 開発環境セットアップ
+```bash
+# 仮想環境作成（推奨）
+python3 -m venv .venv
+source .venv/bin/activate  # Linux/macOS
+# または
+.venv\Scripts\activate     # Windows
+
+# 開発用依存関係インストール
+pip install -e ".[dev]"
+
+# テスト用依存関係のみ
+pip install -e ".[test]"
+```
+
+## テスト実行
+```bash
+# すべてのテスト実行
+pytest
+
+# 詳細モード
+pytest -v
+
+# カバレッジ付き
+pytest --cov=superclaude --cov=setup --cov-report=html
+
+# 特定のテストファイル
+pytest tests/test_installer.py
+
+# 特定のテスト関数
+pytest tests/test_installer.py::test_function_name
+
+# 遅いテストを除外
+pytest -m "not slow"
+
+# 統合テストのみ
+pytest -m integration
+```
+
+## コード品質チェック
+```bash
+# フォーマット確認（実行しない）
+black --check .
+
+# フォーマット適用
+black .
+
+# 型チェック
+mypy superclaude setup
+
+# リンター実行
+flake8 superclaude setup
+
+# すべての品質チェックを実行
+black . && mypy superclaude setup && flake8 superclaude setup && pytest
+```
+
+## パッケージビルド
+```bash
+# ビルド環境クリーンアップ
+rm -rf dist/ build/ *.egg-info
+
+# パッケージビルド
+python -m build
+
+# ローカルインストールでテスト
+pip install -e .
+
+# PyPI公開（メンテナーのみ）
+python -m twine upload dist/*
+```
+
+## Git操作
+```bash
+# ステータス確認（必須）
+git status
+git branch
+
+# フィーチャーブランチ作成
+git checkout -b feature/your-feature-name
+
+# 変更をコミット
+git add .
+git diff --staged  # コミット前に確認
+git commit -m "feat: add new feature"
+
+# プッシュ
+git push origin feature/your-feature-name
+```
+
+## macOS（Darwin）固有コマンド
+```bash
+# ファイル検索
+find . -name "*.py" -type f
+
+# コンテンツ検索
+grep -r "pattern" ./
+
+# ディレクトリリスト
+ls -la
+
+# シンボリックリンク確認
+ls -lh ~/.claude
+
+# Python3がデフォルト
+python3 --version
+pip3 --version
+```
+
+## SuperClaude使用例
+```bash
+# コマンド一覧表示
+/sc:help
+
+# セッション管理
+/sc:load    # セッション復元
+/sc:save    # セッション保存
+
+# 開発コマンド
+/sc:implement "feature description"
+/sc:test
+/sc:analyze @file.py
+/sc:research "topic"
+
+# エージェント活用
+@agent-backend "create API endpoint"
+@agent-security "review authentication"
+```