sc-design

システムおよびコンポーネント設計スキル

業界のベストプラクティスに基づくアーキテクチャ計画とインターフェース設計。

クイックスタート

# Architecture design
/sc:design [target] --type architecture

# API specification
/sc:design payment-api --type api --format spec

# Database schema
/sc:design e-commerce --type database --format diagram

動作フロー

1. 分析 - 要件と既存システムのコンテキストを調査します
2. 計画 - 種類と形式に基づいて設計アプローチを定義します
3. 設計 - ベストプラクティスに沿って仕様を作成します
4. 検証 - 保守性と拡張性を確認します
5. 文書化 - 図と仕様を生成します

フラグ

フラグ	種類	デフォルト	説明
--type	string	architecture	architecture、api、component、database
--format	string	spec	diagram、spec、code

エビデンス要件

このスキルでは、厳密なエビデンスは必要ありません。成果物は次のとおりです。

• 設計仕様と図
• インターフェース定義
• スキーマのドキュメント

設計の種類

アーキテクチャ（--type architecture）

• システム構造とコンポーネント間の関係
• 拡張性と信頼性のパターン
• サービスの境界と通信

API（--type api）

• RESTful/GraphQL エンドポイントの設計
• リクエスト／レスポンスのスキーマ
• 認証とバージョン管理

コンポーネント（--type component）

• インターフェースの契約と依存関係
• 状態管理のパターン
• 統合ポイント

データベース（--type database）

• エンティティ間の関係と制約
• 正規化とインデックス作成
• パフォーマンスに関する考慮事項

出力形式

図（--format diagram）

• ASCII または Mermaid の図
• コンポーネント間の関係の可視化
• データフローの表現

仕様（--format spec）

• API 向け OpenAPI/Swagger
• 詳細なインターフェースのドキュメント
• 技術要件

コード（--format code）

• インターフェース定義
• 型宣言
• スケルトン実装

例

システムアーキテクチャ

/sc:design user-management --type architecture --format diagram
# Component relationships, data flow, scalability patterns

API 設計

/sc:design payment-api --type api --format spec
# OpenAPI spec with endpoints, schemas, auth patterns

コンポーネントインターフェース

/sc:design notification-service --type component --format code
# TypeScript/Python interfaces with clear contracts

データベーススキーマ

/sc:design inventory-db --type database --format diagram
# ER diagrams with relationships and constraints

MCP 統合

PAL MCP（設計の検証）

ツール	使用する場面	目的
mcp__pal__planner	アーキテクチャ計画	設計上の意思決定における分岐を伴う逐次的な計画
mcp__pal__consensus	設計上の意思決定	アーキテクチャ上の選択を複数のモデルで検証
mcp__pal__thinkdeep	複雑なシステム	システム要件の詳細な分析
mcp__pal__chat	ブレインストーミング	協力的な設計の検討
mcp__pal__apilookup	API 標準	最新の API 設計のベストプラクティスを取得

PAL の使用パターン

# Architecture planning
mcp__pal__planner(
    step="Designing microservices architecture for e-commerce platform",
    step_number=1,
    total_steps=4,
    more_steps_needed=True
)

# Validate design with consensus
mcp__pal__consensus(
    models=[
        {"model": "gpt-5.2", "stance": "for"},
        {"model": "gemini-3-pro", "stance": "against"},
        {"model": "deepseek", "stance": "neutral"}
    ],
    step="Evaluate: Should we use event sourcing for the order management system?"
)

# Deep system analysis
mcp__pal__thinkdeep(
    step="Analyzing scalability requirements for real-time notification system",
    hypothesis="WebSocket with Redis pub/sub will handle 100k concurrent users",
    confidence="medium",
    focus_areas=["scalability", "reliability", "performance"]
)

Rube MCP（ドキュメントとコラボレーション）

ツール	使用する場面	目的
mcp__rube__RUBE_SEARCH_TOOLS	外部ツール	図の作成やドキュメント作成のツールを検索
mcp__rube__RUBE_MULTI_EXECUTE_TOOL	設計の共有	Notion、Confluence、Slack に投稿
mcp__rube__RUBE_CREATE_UPDATE_RECIPE	設計ワークフロー	再利用可能な設計プロセスを保存

Rube の使用パターン

# Create design document in Notion
mcp__rube__RUBE_SEARCH_TOOLS(queries=[
    {"use_case": "create notion page", "known_fields": "database:Architecture"}
])

mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "NOTION_CREATE_PAGE", "arguments": {
        "title": "Payment API Design v2",
        "content": "## Overview\n..."
    }}
])

# Share design for review
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
        "channel": "#architecture",
        "text": "New design ready for review: Payment API v2"
    }},
    {"tool_slug": "JIRA_CREATE_ISSUE", "arguments": {
        "project": "ARCH",
        "summary": "Review: Payment API Design",
        "issue_type": "Task"
    }}
])

フラグ（拡張）

フラグ	種類	デフォルト	説明
--pal-plan	bool	false	PAL planner を使用して体系的に設計
--consensus	bool	false	複数モデルの合意により設計を検証
--share	string	-	Rube 経由で共有（notion、confluence、slack）
--create-ticket	bool	false	Rube 経由でレビュー用チケットを作成

ツールの連携

• Read - 要件分析
• Grep/Glob - パターン分析
• Write - 設計ドキュメントの作成
• Bash - 外部ツールとの連携
• PAL MCP - 設計計画、合意による検証、詳細な分析
• Rube MCP - ドキュメントの共有、コラボレーション、レビューのワークフロー