sc-analyze

分析・トラブルシューティングスキル

問題の診断と解決機能を備えた、複数ドメインにわたるコード分析です。

クイックスタート

# Quality analysis
/sc:analyze [target] --focus quality|security|performance|architecture

# Troubleshooting mode
/sc:analyze [issue] --troubleshoot --focus bug|build|performance|deployment

# With auto-fix
/sc:analyze "TypeScript errors" --troubleshoot --focus build --fix

動作フロー

1. 検出 - ソースファイルを分類し、言語を検出します
2. スキャン - ドメイン固有の分析手法を適用します
3. 評価 - 重要度に応じて優先順位付けした所見を生成します
4. 推奨 - 実行可能な推奨事項を作成します
5. レポート - 指標を含む包括的な分析を提示します

フラグ

フラグ	種類	デフォルト	説明
--focus	文字列	quality	quality、security、performance、architecture、bug、build、deployment
--troubleshoot	bool	false	問題診断モードを有効にします
--trace	bool	false	デバッグ用の詳細なトレース分析を行います
--fix	bool	false	安全な修正を自動適用します
--depth	文字列	standard	quick、standard、deep
--format	文字列	text	text、json、report

分析ドメイン

品質分析

• コードの問題点と保守性の問題
• パターン違反とアンチパターン
• 技術的負債の評価

セキュリティ分析

• 脆弱性スキャン
• コンプライアンス検証
• 認証・認可のレビュー

パフォーマンス分析

• ボトルネックの特定
• リソース使用パターン
• 最適化の機会

アーキテクチャ分析

• コンポーネント間の結合度の評価
• 依存関係の分析
• 設計パターンの評価

トラブルシューティングモード

--troubleshoot が有効な場合：

対象	動作
bug	エラー分析、スタックトレース、コード検査
build	ビルドログ、依存関係、設定の検証
performance	指標の分析、ボトルネックの特定
deployment	環境の分析、サービスの検証

例

セキュリティの詳細分析

/sc:analyze src/auth --focus security --depth deep

ビルド失敗の修正

/sc:analyze "compilation errors" --troubleshoot --focus build --fix

パフォーマンスの診断

/sc:analyze "slow API response" --troubleshoot --focus performance --trace

MCP 連携

PAL MCP（常に使用）

ツール	使用する場面	目的
mcp__pal__thinkdeep	複雑な問題	仮説検証を伴う多段階調査
mcp__pal__debug	バグのトラブルシューティング	体系的な根本原因分析
mcp__pal__codereview	品質分析	コード品質、セキュリティ、パフォーマンスの包括的なレビュー
mcp__pal__consensus	重大な所見	セキュリティ／アーキテクチャ上の問題を複数モデルで検証
mcp__pal__challenge	確度の低い所見	あいまいな問題について批判的思考を促す
mcp__pal__apilookup	依存関係の問題	バージョンの競合に関する最新の API ドキュメントを取得

PAL の使用パターン

# Deep investigation (--depth deep)
mcp__pal__thinkdeep(
    step="Investigating performance bottleneck in API layer",
    hypothesis="Database queries lack proper indexing",
    confidence="medium",
    relevant_files=["/src/api/users.py"]
)

# Security analysis (--focus security)
mcp__pal__codereview(
    review_type="security",
    findings="Authentication, authorization, injection vectors",
    issues_found=[{"severity": "high", "description": "SQL injection risk"}]
)

# Critical finding validation
mcp__pal__consensus(
    models=[
        {"model": "gpt-5.2", "stance": "for"},
        {"model": "gemini-3-pro", "stance": "against"}
    ],
    step="Evaluate: Is this a critical security vulnerability?"
)

Rube MCP（必要に応じて使用）

ツール	使用する場面	目的
mcp__rube__RUBE_SEARCH_TOOLS	外部分析	セキュリティスキャナーやリンターを検索
mcp__rube__RUBE_MULTI_EXECUTE_TOOL	問題の追跡	所見のチケットを作成
mcp__rube__RUBE_REMOTE_WORKBENCH	大規模分析	大規模なコードベースを処理

Rube の使用パターン

# Find and create Jira tickets for findings
mcp__rube__RUBE_SEARCH_TOOLS(queries=[
    {"use_case": "create jira issue", "known_fields": "project:SECURITY"}
])

# Notify team of critical findings
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {"channel": "#security", "text": "Critical finding..."}}
])

フラグ（拡張）

フラグ	種類	デフォルト	説明
--pal-deep	bool	false	PAL thinkdeep を使用して多段階分析を行います
--pal-review	bool	false	PAL codereview を使用して包括的なレビューを行います
--consensus	bool	false	PAL consensus を使用して重大な所見を検証します
--notify	文字列	-	Rube 経由で通知します（slack、jira、email）
--create-tickets	bool	false	Rube 経由で所見のチケットを作成します

ツールの連携

• Glob - ファイルの検出と構造分析
• Grep - パターン分析とコード検索
• Read - ソースの検査と設定の分析
• Bash - 外部ツールの実行
• Write - レポートの生成
• PAL MCP - 複数モデルによる分析、デバッグ、コードレビュー
• Rube MCP - 外部通知、チケット作成