sequential-thinking

Sequential Thinking スキル

インストール

スタンドアロン実行ツール（任意）：このスキルは .claude/tools/optimization/sequential-thinking/executor.py を実行できます。必要なもの：

• Python 3.10+：python.org または winget install Python.Python.3.12（Windows）、brew install [email protected]（macOS）。
• MCP Python パッケージ：pip install mcp
• 実行ツールが存在しない場合や MCP がインストールされていない場合でも、このスキルはコンテキスト内のガイダンスを提供し、正常に終了します。

すべての機能を利用するには：スタンドアロン実行ツールを実行するには、Python スクリプト .claude/tools/optimization/sequential-thinking/executor.py が存在している必要があります。node .claude/tools/cli/doctor.mjs を実行して確認してください。実行ツールが見つからない場合、doctor が警告します。

チートシートとベストプラクティス

フレームワーク： Polya：（1）問題を理解する（2）計画を立てる（3）計画を実行する（4）振り返る。IDEAL：特定する → コンテキストを定義する → 戦略を検討する → 最善策を実行する → 振り返って学ぶ。

プロセス： 系統的に進めます。結果を予測し、取り組みを継続し、複数の視点から検討し、ペースを保ちながら自分の進捗を確認します。図、表、パターンを活用し、サブゴールに分解します。役立つ場合は逆算します。

テクニック： 思考に番号（thoughtNumber、totalThoughts）を付け、修正や分岐を可能にします。まず初期のステップ数を設定し、必要に応じて調整します。全体像が不明確な場合は、複数ステップにわたる分析や仮説検証に MCP の sequential-thinking ツールを使います。

認定とトレーニング

認定資格はありません。 問題解決フレームワーク：Polya（理解 → 計画 → 実行 → 振り返り）、IDEAL（特定 → 定義 → 探索 → 実行 → 振り返り）。スキルデータ： 系統的な手順、結果の予測、取り組みの継続、修正と分岐、図・表・パターンの活用。

フックとワークフロー

推奨フック： 任意で、計画の前や複雑なタスクの開始前にフックを使い、複数ステップにわたるタスクで sequential-thinking を提案できます。計画には planner（主に使用）と、作業の分解には master-orchestrator と併用します。

**ワークフロー：**planner（主に使用）と併用します。流れ：複雑なタスク → sequential-thinking を読み込む → 思考を出力する（MCP または実行ツール）→ 修正する → 実行する。ルーターが planner を割り当てる条件については core/router-decision を参照してください。

概要

このスキルは、柔軟に適応・発展できる思考プロセスを通じて、構造化された問題解決を支援します。それぞれの思考は、以前の洞察を発展させたり、問い直したり、修正したりできます。

コンテキストの削減： 約97％

• MCP モード：常時読み込みで約15,000トークン
• スキルモード：メタデータ約500トークン＋必要に応じた読み込み

使用する場面

• 複雑な問題を複数のステップに分解する
• 修正の余地を持たせた計画や設計を行う
• 軌道修正が必要になる可能性のある分析を行う
• 最初の時点では全体像が明確でない問題に取り組む
• コンテキストを維持する必要がある複数ステップの解決策を考える
• 無関係な情報を除外する
• 仮説を立てて検証する

クイックリファレンス

MCP の sequential thinking ツールを直接使用します：

// Via MCP tool
mcp__sequential -
  thinking__sequentialthinking({
    thought: 'First, let me analyze the problem...',
    thoughtNumber: 1,
    totalThoughts: 5,
    nextThoughtNeeded: true,
  });

ツール：sequentialthinking

思考を通じて動的かつ内省的な問題解決を行うための詳細なツールです。

パラメーター

パラメーター	型	説明
thought	string	現在の思考ステップ
thoughtNumber	integer	現在の思考番号（1、2、3...）
totalThoughts	integer	必要となる思考数の推定
nextThoughtNeeded	boolean	次の思考ステップが必要かどうか
isRevision	boolean	この思考が以前の思考を修正するかどうか
revisesThought	integer	再検討する思考番号
branchFromThought	integer	分岐元の思考番号
branchId	string	現在の分岐の識別子
needsMoreThoughts	boolean	「終了」時点でさらに思考が必要かどうか

主な機能

• 進行に応じて totalThoughts を増減できます
• 以前の思考に疑問を投げかけたり、修正したりできます
• 終わりと思われるところに到達した後でも、思考を追加できます
• 不確実性を表現し、代替案を検討できます
• 分岐や後戻りができます（非線形の思考）
• 解決策の仮説を生成し、検証できます

プロセス

1. 必要な思考数の初期見積もりを立てます
2. 以前の思考に自由に疑問を投げかけたり、修正したりします
3. 必要であれば、「終わり」に到達した後でも思考を追加します
4. 修正や分岐を行った思考に印を付けます
5. 適切な場合は解決策の仮説を生成します
6. Chain of Thought に基づいて仮説を検証します
7. 納得できるまで繰り返します
8. 本当に完了した場合に限り、nextThoughtNeeded: false を設定します

ツールの実行

逐次思考ツールは MCP 経由で利用できます。応答で直接使用してください：

// Execute a thinking step
mcp__sequential -
  thinking__sequentialthinking({
    thought: 'Your analysis here...',
    thoughtNumber: 1,
    totalThoughts: 5,
    nextThoughtNeeded: true,
  });

設定

MCP サーバーの設定は config.json に保存されています：

• コマンド：npx -y @modelcontextprotocol/server-sequential-thinking

関連項目

• 元の MCP サーバー：@modelcontextprotocol/server-sequential-thinking
• MCP Converter Skill：.claude/skills/mcp-converter/

絶対に守るべきルール

1. 仮説を検証する前に、絶対に nextThoughtNeeded: false を設定しないでください
2. 問題の複雑さが明らかになるにつれて、必ず totalThoughts を動的に調整してください
3. 分岐によって少なくとも 1 つの代替案を検討する前に、最初のアプローチに絶対に固執しないでください
4. 修正は必ず isRevision: true および revisesThought: N を明示して示してください
5. 仮説が未検証のままなら、見積もった思考数に達した時点で絶対に止めないでください

アンチパターン

アンチパターン	失敗する理由	正しいアプローチ
思考数の固定	解決策への確信度にかかわらず、任意の見積もりで思考が止まります	複雑さが増した場合は needsMoreThoughts: true を設定し、totalThoughts を増やします
分岐しない	代替案を検討せず、最初のアプローチに固執します	branchFromThought を使い、選択する前に複数の解決策を検討します
修正を省略する	誤った前提が修正されないまま、後続の思考に引き継がれます	すべての修正に isRevision: true および revisesThought: N を付けます
時期尚早な終了	未検証の仮説により、誤った解決策や不完全な解決策につながります	nextThoughtNeeded: false を設定する前に、仮説を明示的に検証します
不確実性の印がない	過信した結論が実行エージェントを誤った方向に導きます	暫定的な思考を明示し、確信のある推論と不確かな推論を区別します

メモリプロトコル（必須）

開始前： .claude/context/memory/learnings.md を読みます

完了後：

• 新しいパターン → .claude/context/memory/learnings.md
• 見つかった問題 → .claude/context/memory/issues.md
• 決定事項 → .claude/context/memory/decisions.md

中断を前提にしてください：メモリに記録されていないことは、起きていないことと同じです。