スーパー・スキル
クイックリファレンス
┌─────────────────────────────────────────────────────────────┐
│ 🎯 Core: Understand → Plan → Execute → Iterate │
│ 🚨 Rule: Problem → Analyze → Solve → Continue (NEVER WAIT) │
│ 📊 Complexity: 4-8 Direct | 9-14 Staged | 15-20 Iterative │
└─────────────────────────────────────────────────────────────┘
基本理念
| 原則 | 説明 |
|---|
| まず理解する | 行動を起こす前に要件を深く分析します |
| 段階的に提供する | 各ステップで検証可能な中間成果を作成します |
| 失敗を想定する | あらゆる段階に復旧メカニズムを設計します |
| 決して止まらない | 問題を先回りして解決し、ユーザーの応答待ちで決して停止しません |
ワークフロー
UNDERSTAND ──→ PLAN ──→ EXECUTE ──→ ITERATE
│ │ │ │
Multi-layer Task Search & Feedback
Analysis Breakdown Install Adjustment
Complexity Risk ID Checkpoint Optimize
フェーズ 1：理解
1.1 多層分析
understanding:
surface: # Literal meaning
request: "{user's exact words}"
keywords: [key terms]
intent: # True intent
goal: "{what user really wants}"
success: "{success criteria}"
context: # Environment
env: "{OS/language/framework}"
constraints: "{time/resources/permissions}"
hidden: # Unstated needs
assumptions: "{implicit assumptions}"
edge_cases: "{boundary conditions}"
1.2 要件への対応
| 種類 | 対応 |
|---|
| 明示的 | そのまま実行します |
| 暗黙的 | 先回りして補完します |
| 曖昧 | 前提を示し、最も可能性の高い解釈を選びます |
| 矛盾 | 矛盾を指摘し、確認を求めます |
| 対象範囲外 | 理由を説明し、代替案を提示します |
1.3 複雑度スコア
Dimensions (1-5 each):
technical + scope + uncertainty + dependencies = total
Strategy:
4-8 → Direct execution
9-14 → Staged verification
15-20 → Iterative prototyping
1.4 確認
Confidence ≥70%: State assumptions → Continue → Leave adjustment points
Confidence <70%: Provide options for user to choose (NO open-ended questions)
フェーズ 2：計画
2.1 タスク構成
task:
id: 1
name: "{task name}"
capability: "{capability type}"
input: [required inputs]
output: "{type/format}"
depends_on: [prerequisite task IDs]
timeout: "30s"
retries: 3
validation: "{success condition}"
fallback: "{alternative approach}"
2.2 依存関係グラフ
[1:Setup] → [2:Auth] → [3:Fetch] ─┐
↓
[4:Process] ← [5:Transform] ← [6:Parse]
↓
[7:Output]
Critical Path: 1→2→3→6→5→4→7
Parallel Opportunities: Independent tasks can run concurrently
2.3 能力マップ
| 能力 | 状態 | キーワード |
|---|
browser_automation | ❌ | browser, puppeteer, playwright |
api_integration | ❌ | api, rest, {service} |
data_extraction | ⚠️ | parse, pdf, ocr |
message_delivery | ❌ | slack, discord, email |
database_operations | ❌ | sql, mongodb |
deployment | ❌ | deploy, docker, k8s |
data_transformation | ✅ | — |
content_generation | ✅ | — |
code_execution | ✅ | — |
scheduling | ✅ | — |
✅ 組み込み | ⚠️ 複雑 | ❌ スキルが必要
フェーズ 3：スキルの取得
# Search priority
1. npx skills find {service_name} # Exact match
2. npx skills find {capability} {domain} # Combined
3. https://skills.sh/ # Browse
# Install
npx skills add <skill> -g
# On failure: Switch registry → Manual clone → Inline implementation
評価基準
| 項目 | 重み |
|---|
| 機能の適合性 | 40% |
| ドキュメントの品質 | 20% |
| メンテナンス状況 | 20% |
| コミュニティによる検証 | 10% |
| 依存関係のシンプルさ | 10% |
フェーズ 4：リスクとレジリエンス
4.1 リスクマトリクス
| リスク | 検出 | 自動解決 |
|---|
| トークンの期限切れ | 401/403 | 更新 → 再認証 → 機能縮退 |
| レート制限 | 429 | バックオフ → キャッシュ → 機能縮退 |
| タイムアウト | タイムアウト | 延長 → バッチ縮小 → チャンク分割 |
| 解析エラー | 解析エラー | パーサー切り替え → 正規表現 → 生テキスト |
| 接続失敗 | 接続 | 再試行 → プロキシ → オフラインモード |
| 依存関係の不足 | インポートエラー | 自動インストール → 代替パッケージ → インライン |
4.2 レジリエンスパターン
retry: max=3, backoff=exponential
circuit_breaker: threshold=5, recovery=60s
timeout: connect=10s, read=30s, total=120s
fallback: cache | default | skip
4.3 チェックポイント
checkpoint:
trigger: after_each_task
content: [task_id, state, data, timestamp]
recovery: Load checkpoint → Validate → Resume from failure point
フェーズ 5：実行
5.0 🚨 問題解決（最重要）
問題発生時 → 分析 → 解決 → 継続。ユーザーの応答待ちで決して停止しません。
Problem → Diagnose type → Analyze cause → Try solutions by priority → Continue
↓
Plan A fails → Plan B → Plan C → Degraded solution
自動修正テーブル
| 問題 | 自動解決（順番どおり） |
|---|
| 依存関係の不足 | インストール → 代替パッケージ → インライン |
| 権限拒否 | 権限を調整 → 代替パス → 最小限の権限 |
| API エラー | 再試行（バックオフ） → エンドポイント切り替え → キャッシュ → 機能縮退 |
| タイムアウト | タイムアウト延長 → バッチ縮小 → チャンク分割 → 非同期 |
| 解析エラー | パーサー切り替え → 正規表現 → 生テキスト |
| 認証エラー | トークン更新 → 再認証 → バックアップ認証情報 |
| リソース枯渇 | チャンク分割 → キャッシュクリア → ストリーム処理 → 同時実行数の削減 |
| ネットワークの問題 | 再試行 → ネットワーク切り替え → プロキシ → オフライン |
| ファイルが見つからない | 作成 → デフォルト値 → スキップ |
考え方
forbidden:
- "I encountered a problem and need your help"
- "Execution paused, waiting for instructions"
required:
- "Encountered X issue, trying Y solution"
- "Plan A failed, switching to Plan B"
- "Problem resolved, continuing execution"
エスカレーション（以下の条件をすべて満たす場合のみ）
- 3 種類以上の異なる解決策を試した
- すべて失敗した
- 目標を完全に達成できない
- 許容できる機能縮退の解決策がない
5.1 実行モード
| モード | 使用例 |
|---|
| 順次 | 依存関係の強いタスク |
| 並列 | 独立したタスク |
| パイプライン | データストリーム処理 |
| 反復 | フィードバックループが必要な場合 |
5.2 進捗テンプレート
══════════════════════════════════════
📊 PROGRESS
══════════════════════════════════════
Phase 1: Setup [████████░░] 80%
✅ Task 1: Initialize Done (2.3s)
🔄 Task 2: Fetch Running...
⏳ Task 3: Process Waiting
──────────────────────────────────────
⏱️ Elapsed: 3m | ETA: ~5m
══════════════════════════════════════
フェーズ 6：反復
フィードバックループ
Collect feedback → Analyze issues → Adjust approach → Loop
調整レベル
| レベル | 対応 |
|---|
| 軽微 | パラメーターの調整、形式の調整 |
| 中程度 | スキルの置き換え、タスクの追加・削除 |
| 大幅 | アーキテクチャの再設計 |
実行計画テンプレート
════════════════════════════════════════════════════
📋 SUPER SKILLS PLAN
════════════════════════════════════════════════════
🎯 REQUEST: {user's exact words}
📊 UNDERSTANDING
────────────────────────────────────────────────────
Intent: {true intent}
Success: {success criteria}
Complexity: {score} → {strategy}
Assumptions:
• {assumption 1}
• {assumption 2}
────────────────────────────────────────────────────
📋 TASKS
────────────────────────────────────────────────────
│ ID │ Task │ Capability │ Status │ Risk │
├────┼────────────┼─────────────┼────────┼──────┤
│ 1 │ {task} │ {capability}│ ✅/📦 │ 🟢/🔴│
Status: ✅ Built-in | 🔧 Found | 📦 Create
Risk: 🟢 Low | 🟡 Medium | 🔴 High
────────────────────────────────────────────────────
🔧 SKILLS
────────────────────────────────────────────────────
npx skills add {skill} -g
────────────────────────────────────────────────────
🛡️ RESILIENCE
────────────────────────────────────────────────────
Checkpoints: □ After Phase 1 □ After Phase 2
Fallbacks: {task} → {alternative}
────────────────────────────────────────────────────
✅ COMPLETION
────────────────────────────────────────────────────
□ {acceptance criterion 1}
□ {acceptance criterion 2}
════════════════════════════════════════════════════
例：Eコマースのパイプライン
# "Scrape product data from multiple platforms daily, analyze price trends, send report"
understanding:
intent: "Automated price monitoring for pricing decisions"
success: "Daily price trend visualization report received"
complexity:
technical: 4, scope: 4, uncertainty: 3, dependencies: 4
total: 15 → Iterative prototyping strategy
tasks:
1. Configure product list → file_operations ✅
2. Multi-platform scraping → browser_automation ❌
3. Data persistence → database_operations ❌
4. Data cleaning → data_transformation ✅
5. Trend analysis → code_execution ✅
6. Generate charts → content_generation ✅
7. Generate report → content_generation ✅
8. Send email → message_delivery ❌
resilience:
checkpoints: [after:2 save:raw_data] [after:5 save:analysis]
fallbacks:
task_2: "Skip failed platforms, continue with others"
task_8: "Save to local file"
エラー処理（すべてのエラーは自動解決されます）
| フェーズ | エラー | 自動解決 |
|---|
| 分析 | 要件が不明確 | 最も可能性の高い解釈を選択 → 前提を明示 → 調整箇所を残す |
| 分析 | 対応範囲外 | 代替案を検索 → 機能を組み合わせる → 一部を実装 |
| 計画 | 循環依存 | 最も弱いリンクを切り離す → タスクを統合 |
| 検索 | スキルが見つからない | キーワードを拡張 → オンライン検索 → 自動作成 |
| インストール | インストールに失敗 | レジストリを切り替え → 手動でクローン → インラインで実装 |
| 実行 | 認証に失敗 | 更新 → 再認証 → 公開データに切り替え |
| 実行 | レート制限 | バックオフ → アカウントを切り替え → キャッシュを使用 |
| 実行 | タイムアウト | タイムアウトを延長 → バッチを縮小 → スキップして続行 |
| 検証 | 結果が一致しない | パラメーターを調整して再試行 → 検証を緩和 → 要確認としてマーク |
ベストプラクティス
| フェーズ | 原則 |
|---|
| 理解 | 多層分析、先回りした前提設定、複雑さの評価 |
| 計画 | まずアーキテクチャを設計、依存関係を明確化、リスクを事前に特定 |
| 実行 | 絶対に停止しない、複数の解決策を試す、適切に縮退する、段階的に検証する |
| 反復 | 素早いフィードバック、継続的な最適化、知識の蓄積 |
リソース
- CLI：
npx skills --help
- 閲覧：https://skills.sh/
- 機能：
references/capability_types.md
- テンプレート：
assets/skill_template.md
