cline-sdk

Cline SDK スキル

Cline SDK を使用して AI エージェントを構築するための統合スキルです。以下の判断ツリーから適切な開始点と API サーフェスを見つけ、詳細なリファレンスを参照してください。

重要なルール

Cline SDK のコードでは、以下のルールに従ってください。

1. npm install @cline/sdk を使用してインストールしてください。@cline/sdk パッケージは @cline/core を再エクスポートしますが、すべてのサブパッケージを直接再エクスポートするわけではありません。Core は ClineCore、Agent、createAgentRuntime、createTool、組み込みツールヘルパー、プロバイダーヘルパー、Llms 名前空間など、公開 SDK サーフェスを再エクスポートします。Core が再エクスポートしない API（AgentRuntime、createAgent、一部の低レベル型など）が必要な場合に限り、@cline/agents、@cline/llms、または @cline/shared からインポートしてください。
2. Node.js 22 以降が必要です。
3. ツールの定義には、@cline/sdk（または @cline/shared）の createTool() を使用してください。ツール名は snake_case にする必要があります。
4. エージェントが復旧できる場合は、ツールの execute 関数から構造化されたエラーデータを返すことを優先してください。直接使用する Agent は、スローされたツールエラーをエラーツール結果に変換します。また、ClineCore は、繰り返し発生する失敗したツールターンを、エラー上限の処理に加算することもできます。
5. エージェントループを終了するツール（「回答を送信」ツールなど）には、lifecycle: { completesRun: true } を使用してください。
6. ClineCore を使用する場合は、リソースをクリーンアップするため、処理が終わったら必ず dispose() を呼び出してください。
7. 直接使用する Agent と ClineCore では、イベントシステムが異なります。Agent では、agent.subscribe() を使用して AgentRuntimeEvent 型を取得します。テキストのストリーミングイベントは "assistant-text-delta" で、結果のテキストは result.outputText です。ClineCore では、cline.subscribe() を使用して CoreSessionEvent 型を取得します。ユーザー向けテキスト、推論、ツールの動作は、"agent_event" ペイロード（content_start、content_update、content_end、done）から表示してください。"chunk" イベントは、型付きテキストデルタではなく、{ stream, chunk, ts } を含む未加工のトランスポートチャンクとして扱ってください。ClineCore の結果テキストは result.text です。AgentRuntimeConfig にトップレベルの onEvent フィールドはありません。代わりに agent.subscribe() または hooks.onEvent を使用してください。agent.subscribe() で "content_update" や "content_start" を使用しないでください。これらは、ClineCore の agent_event イベント内で伝達される、ホスト向けの AgentEvent 型です。
8. 直接使用する Agent では、plugins は setup(context) が { tools, hooks } を返すシンプルなランタイムプラグインです。ClineCore では、extensions は manifest、setup(api, ctx)、および任意の hooks を持つ AgentPlugin オブジェクトです。直接使用する Agent.plugins に ClineCore プラグインの例を使用しないでください。
9. プラグインのスキルは登録するのではなく、ファイルベースです。registerSkill() も api.registerSkill もありません。プラグインには、<package>/skills/<name>/SKILL.md の下に SKILL.md ファイルとしてスキルを含める必要があります（必須のパッケージ構成です）。ホストがこれらを検出し、/slash-commands として自動的に表示するため、スキルに対して registerCommand を呼び出さないでください。プラグインの MCP サーバーには、"mcp" 機能を指定して api.registerMcpServer() を使用してください。設定済みエージェント（エージェントプロファイル）は .cline/agents/ 内の YAML ファイルであり、enableSpawnAgent が true の場合、subagent_<name> ツールとして読み込まれます。

このスキルの使い方

リファレンスファイルの構成

2 つの主要な API サーフェス（Agent と ClineCore）は、4 ファイル構成になっています。複数の領域にまたがる概念は、単一ファイルのガイドにまとめられています。

./references/<api>/ にある各主要 API サーフェスには、以下のファイルが含まれています。

ファイル	目的	読むタイミング
REFERENCE.md	概要、使用する場面、クイックスタート	必ず最初に読む
api.md	API 全般：クラス、メソッド、設定、型	コードを書くとき
patterns.md	一般的なパターン、ベストプラクティス	実装の参考
gotchas.md	落とし穴、制限事項、デバッグ	問題のトラブルシューティング

./references/<concept>/ にある複数の領域にまたがる概念では、REFERENCE.md が参照の開始点です。

読む順序

1. 選択した API サーフェスの REFERENCE.md から読み始めます
2. 次に、タスクに関連するファイルを読みます：
   • エージェントコードの作成 -> api.md
   • 一般的なパターン -> patterns.md
   • ツールの作成 -> tools/REFERENCE.md
   • プラグイン／フックの追加 -> plugins/REFERENCE.md
   • LLM プロバイダーの設定 -> providers/REFERENCE.md
   • ストリーミングイベント -> events/REFERENCE.md
   • 本番環境へのデプロイ -> production/REFERENCE.md
   • エージェントのスケジュール設定 -> scheduling/REFERENCE.md
   • マルチエージェントのオーケストレーション -> multi-agent/REFERENCE.md
   • デバッグ -> gotchas.md

使用例へのパス

./references/agent/REFERENCE.md           # Start here for lightweight agents
./references/clinecore/REFERENCE.md       # Start here for full runtime
./references/agent/api.md                 # Agent class, config, methods
./references/tools/REFERENCE.md           # Creating and using tools
./references/plugins/REFERENCE.md         # Plugin system
./references/providers/REFERENCE.md       # LLM provider configuration

クイック判断ツリー

「どの API サーフェスを使えばよいですか？」

Which API?
+-- I want a simple, in-memory agent with custom tools
|   +-- agent/ (Agent class from @cline/agents, re-exported by @cline/sdk)
+-- I need session persistence, built-in tools, config discovery
|   +-- clinecore/ (ClineCore from @cline/core)
+-- I want built-in file/shell/search/web tools
|   +-- clinecore/ (has built-in tools; Agent does not)
+-- I want scheduled or recurring agents
|   +-- clinecore/ (automation API)
+-- I need multi-process or multi-client session sharing
|   +-- clinecore/ (hub-backed runtime)
+-- I'm building a browser-compatible agent
|   +-- agent/ (no Node.js dependencies)

「ツールを作成する必要があります」

Tools?
+-- Define a custom tool with schema -> tools/REFERENCE.md
+-- Use built-in tools (read_files, search_codebase, run_commands, etc.) -> tools/REFERENCE.md (built-in section)
+-- Control tool approval/policies -> tools/REFERENCE.md (policies section)
+-- Tool that ends the agent loop -> tools/REFERENCE.md (completion tools)
+-- Package tools as a reusable plugin -> plugins/REFERENCE.md

「イベントを処理する必要があります」

Events?
+-- Stream text/reasoning in real time -> events/REFERENCE.md
+-- Track token usage and costs -> events/REFERENCE.md
+-- Watch tool calls -> events/REFERENCE.md
+-- Detect completion/errors -> events/REFERENCE.md
+-- Hook into lifecycle stages -> plugins/REFERENCE.md

「モデルプロバイダーを設定する必要があります」

Providers?
+-- Anthropic (Claude) -> providers/REFERENCE.md
+-- OpenAI (GPT) -> providers/REFERENCE.md
+-- Google (Gemini/Vertex) -> providers/REFERENCE.md
+-- AWS Bedrock -> providers/REFERENCE.md
+-- Mistral -> providers/REFERENCE.md
+-- OpenAI-compatible (vLLM, Together, etc.) -> providers/REFERENCE.md
+-- Custom/self-hosted provider -> providers/REFERENCE.md

「プラグインまたはフックが必要です」

Plugins?
+-- Package tools + hooks together -> plugins/REFERENCE.md
+-- Observe tool calls (logging, metrics) -> plugins/REFERENCE.md
+-- Intercept lifecycle events -> plugins/REFERENCE.md
+-- Add system prompt rules -> plugins/REFERENCE.md
+-- Expose an MCP server's tools -> plugins/REFERENCE.md (MCP servers)
+-- Bundle reusable skills (SKILL.md, auto slash commands) -> plugins/REFERENCE.md (bundled skills)
+-- Distribute via npm/git -> plugins/REFERENCE.md

「マルチエージェントの連携が必要です」

Multi-agent?
+-- Run one-off delegated sub-agents -> multi-agent/REFERENCE.md (sub-agents)
+-- Predefined named sub-agents from files -> multi-agent/REFERENCE.md (configured agents)
+-- Persistent cross-session teams -> multi-agent/REFERENCE.md (teams)
+-- Parent-child delegation -> multi-agent/REFERENCE.md (sub-agents)
+-- Peer-to-peer task board -> multi-agent/REFERENCE.md (teams)

「スケジュール設定または自動化が必要です」

Scheduling?
+-- Recurring cron jobs -> scheduling/REFERENCE.md
+-- One-off scheduled tasks -> scheduling/REFERENCE.md
+-- Event-driven triggers -> scheduling/REFERENCE.md
+-- CLI schedule management -> scheduling/REFERENCE.md

「本番環境に移行する必要があります」

Production?
+-- Error handling and status checks -> production/REFERENCE.md
+-- Cost control and token limits -> production/REFERENCE.md
+-- Observability (OpenTelemetry) -> production/REFERENCE.md
+-- Security and sandboxing -> production/REFERENCE.md
+-- Deployment patterns -> production/REFERENCE.md

トラブルシューティング索引

• エージェントループが停止しない -> tools/REFERENCE.md（完了ツール）
• ツールエラーによってエージェントがクラッシュする -> agent/gotchas.md または clinecore/gotchas.md
• プロバイダーの認証に失敗する -> providers/REFERENCE.md
• セッションが永続化されない -> clinecore/gotchas.md
• トークン使用量が多すぎる -> production/REFERENCE.md（コスト管理）
• Hub の接続に関する問題 -> clinecore/gotchas.md
• プラグインが読み込まれない -> plugins/REFERENCE.md
• イベントが発火しない -> events/REFERENCE.md

製品索引

API サーフェス

API	エントリーファイル	説明
Agent	./references/agent/REFERENCE.md	軽量なインメモリー型エージェントループ
ClineCore	./references/clinecore/REFERENCE.md	セッション、永続化、組み込みツールを備えたフルランタイム

横断的な概念

概念	エントリーファイル	説明
ツール	./references/tools/REFERENCE.md	組み込みツールとカスタムツールの作成
プラグイン	./references/plugins/REFERENCE.md	フック、MCP サーバー、バンドルされたスキルを備えた拡張システム
イベント	./references/events/REFERENCE.md	リアルタイムのストリーミングイベント
プロバイダー	./references/providers/REFERENCE.md	LLM プロバイダーの設定
本番環境	./references/production/REFERENCE.md	デプロイ、セキュリティ、可観測性
スケジュール設定	./references/scheduling/REFERENCE.md	Cron ジョブと自動化
マルチエージェント	./references/multi-agent/REFERENCE.md	チーム、サブエージェント、設定済みエージェントプロファイル

パッケージ一覧

パッケージ	用途
@cline/sdk	@cline/core のユーザー向けエイリアスです。最初にインストールしてください
@cline/core	セッション、永続化、組み込みツール、設定、ハブ、選択された再エクスポート
@cline/agents	ブラウザー互換の AgentRuntime クラスと低レベルファクトリー
@cline/llms	LLM プロバイダーゲートウェイ
@cline/shared	型、ツールヘルパー、フックエンジン

リソース

リポジトリ：https://github.com/cline/cline SDK ソース：https://github.com/cline/cline/tree/main/sdk ドキュメント：https://docs.cline.bot/sdk/overview Discord：https://discord.gg/cline