sc-explain

コードと概念の説明スキル

深さや形式を柔軟に調整した、学習に役立つ説明です。

クイックスタート

# Basic code explanation
/sc:explain authentication.js --level basic

# Framework concept
/sc:explain react-hooks --level intermediate --context react

# System architecture
/sc:explain microservices-system --level advanced --format interactive

動作の流れ

1. 分析 - 対象のコードまたは概念を調べます
2. 評価 - 対象者のレベルと説明の深さを判断します
3. 構成 - 段階的に複雑さを高める説明を計画します
4. 生成 - 例を交えたわかりやすい説明を作成します
5. 検証 - 正確さと学習効果を確認します

フラグ

フラグ	型	デフォルト	説明
--level	string	intermediate	basic、intermediate、advanced
--format	string	text	text、examples、interactive
--context	string	-	ドメインのコンテキスト（react、security など）

有効化されるペルソナ

• communicator - 学習に最適化された説明
• architect - システム設計のコンテキスト
• guardian - セキュリティ対策の説明

MCP 統合

PAL MCP（多角的な説明）

ツール	使用するタイミング	目的
mcp__pal__consensus	複雑なトピック	複数の視点による検証
mcp__pal__chat	明確化	別の説明を得る
mcp__pal__thinkdeep	深い概念	多段階の探究
mcp__pal__apilookup	最新の API	最新のドキュメントを取得
mcp__pal__challenge	正確さの確認	説明の正しさを検証

PAL の使用パターン

# Multi-perspective explanation for complex topic
mcp__pal__consensus(
    models=[
        {"model": "gpt-5.2", "stance": "neutral"},
        {"model": "gemini-3-pro", "stance": "neutral"}
    ],
    step="Explain: How does React's reconciliation algorithm work?"
)

# Get alternative explanation approach
mcp__pal__chat(
    prompt="Explain React hooks to someone familiar with Vue composition API",
    model="gpt-5.2",
    thinking_mode="medium"
)

# Deep dive into complex concept
mcp__pal__thinkdeep(
    step="Understanding Kubernetes pod scheduling algorithm",
    hypothesis="Priority-based scheduling with resource constraints",
    confidence="medium",
    focus_areas=["scheduling", "resource_management", "affinity"]
)

# Verify explanation accuracy
mcp__pal__challenge(
    prompt="Is my explanation of OAuth2 refresh tokens technically accurate?"
)

# Get current API/framework documentation
mcp__pal__apilookup(
    prompt="Get current React 19 documentation for use hook"
)

Rube MCP（調査と共有）

ツール	使用するタイミング	目的
mcp__rube__RUBE_SEARCH_TOOLS	ウェブ調査	チュートリアル、ドキュメント、例を探す
mcp__rube__RUBE_MULTI_EXECUTE_TOOL	説明の共有	Notion、Slack などに投稿

Rube の使用パターン

# Research current best practices
mcp__rube__RUBE_SEARCH_TOOLS(queries=[
    {"use_case": "web search", "known_fields": "query:React 19 new features explained"}
])

# Share explanation with team
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "NOTION_CREATE_PAGE", "arguments": {
        "title": "Understanding: React Concurrent Mode",
        "content": "## Overview\n..."
    }},
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
        "channel": "#learning",
        "text": "New explainer: React Concurrent Mode fundamentals"
    }}
])

フラグ（拡張）

フラグ	型	デフォルト	説明
--pal-consensus	bool	false	多角的な検証に PAL を使用
--pal-deep	bool	false	複雑なトピックに PAL の thinkdeep を使用
--research	bool	false	ウェブ調査に Rube を使用
--share	string	-	Rube 経由で共有（notion、slack、confluence）

根拠に関する要件

このスキルでは、確固たる根拠は必要ありません。次の点に重点を置いてください。

• 明確で正確な説明
• 適切な例
• 段階的な複雑さ

説明のレベル

基本（--level basic）

• 基礎的な概念
• 簡単な例
• 初心者にもわかりやすい言葉

中級（--level intermediate）

• 実装の詳細
• 一般的なパターン
• ベストプラクティス

上級（--level advanced）

• 詳細な技術情報
• エッジケースとトレードオフ
• パフォーマンスへの影響

形式のオプション

テキスト（--format text）

• 文章による説明
• 段階的な解説
• 概念の概要

例（--format examples）

• コードサンプル
• 変更前と変更後の比較
• 実際の活用例

インタラクティブ（--format interactive）

• 段階的な情報開示
• フォローアップの提案
• 探究の進め方

例

コードの説明

/sc:explain src/auth/jwt.js --level basic
# What the code does, how it works, why it's structured this way

フレームワークの概念

/sc:explain useEffect --level intermediate --context react
# Hook lifecycle, dependency arrays, cleanup patterns

アーキテクチャの説明

/sc:explain event-driven-architecture --level advanced
# Patterns, trade-offs, implementation strategies

セキュリティの概念

/sc:explain oauth2-flow --level basic --context security
# Authorization flow, tokens, security considerations

ツールの連携

• Read/Grep/Glob - コード分析
• TodoWrite - 複数部分からなる説明の追跡
• Task - 複雑な説明の委任