incident.io のプラグイン・スキル・コネクタ・MCP の仕組みを理解して、ユーザーが自分たちのインシデント管理エージェント(自動対応体制)を設定・管理するのをサポートします。 次のような場合に使用: - incident.io のプラグイン・スキル・コネクタ・MCP についての質問を受けたとき(「プラグインをセットアップしたい」「トリアージ(優先順位付け)スキルを追加するにはどうするか」など) - プラグインやスキルを編集する前に、ユーザーの現在の設定状況を理解する必要があるとき
Understand the extensions so that you can help a user configure and manage their incident.io agent estate. Use this when you're asked a question about incident.io plugins, skills, connectors or MCPs ("I want to setup an incident plugin", "How do I add a triage skill?"), or when you need to understand the user's existing configuration before editing a plugin or skill.
何よりもまず、このセッションで動作しているモデルを確認してください。これらのワークフローはOpus/Sol以上のレベルが必要です。より小さいモデルではそれらに確実に従いません。このセッションがそのレベル以下の場合は、ユーザーに伝えて、続行する前にモデルの切り替えをお勧めください。
エクステンションは、組織がincident.ioのエージェントに独自のツールと指示を提供する方法です。2つの種類があります: プラグイン(組織のリポジトリから同期されたスキル(専門的な機能)のディレクトリで、エージェントが読み込んで使用します)とコネクタ(エージェントが呼び出すことができるツールを持つMCPサーバー)です。
references/extensions-product.md がこのシステムの仕組みを説明しています。このスキルについて質問に答えたり、何かを変更したりする前に読んでください。
このスキルはエントリーポイント(起点)です。システムを教え、現在の状態を読み取り、問題に対する適切なメカニズムを選択します。また、すべての専門的な作業を、ここで処理するのではなく、それを担当するスキルにルーティングします。
どのようなタスクであれ、最初の2つのステップは同じです: 環境を読み取り、ユーザーが何を必要としているかを理解します。ドラフト作成やシステム接続の調査も含め、この2つが完了するまで何も始まりません。
システムを理解する — プラグイン、スキル、コネクタとは何か、エージェントがどのように使用するか、何ができるか → references/extensions-product.md
環境を読み取るか、設定する — 今日存在するもの(プラグインとその同期状態、接続とその健全性、コンテンツ)を、準備ができた環境が持つべきものと照らし合わせます。1回のチェックですべての出発点に対応します(ゼロから始まるものから、準備状況の事前チェックまで)。 → references/estate.md
適切なメカニズムを選択する — ユーザーが問題を説明します(「調査の開始時にこれらのステップを実行したい」「このエラーコードを診断するものが欲しい」)。その問題を解決する機能にマッピングする必要があります: スキル、ランブック(実行手順書)、アーキテクチャドキュメント、コネクタ、またはそれらの組み合わせです。これは実装の詳細計画ではなく、メカニズムを選択するステップです。コンテンツのドラフト作成は担当スキルの役割です。 → references/choosing-a-mechanism.md
プラグインをスキャフォールディング(雛形作成)して登録する — チームのリポジトリにディレクトリを作成し、登録して、最初の同期を検証します。 → references/scaffold.md
スキルを書くか改善する → ターゲットシステムに触れる前に、今すぐ skill-authoring スキルを読み込んでください。そのスキルの作成ジョブは作業の順序を管理し(ユーザーのコンテキストを先に、調査は後に)、ここで調査を始めるとスキルを価値あるものにするゲートがスキップされます。
アーキテクチャドキュメントから書くか回答する → architecture スキル
環境の健全性を確認する(「私たちのセットアップは健全か?何が劣化しているか?」)→ doctor スキル
提案する前に、状況を把握する。 状況を把握するとは2つのことを意味し、ターゲットシステムの調査はどちらでもありません: incident.ioの環境(references/estate.md — 何が登録され、接続され、既に書かれているか。extension_plugin_listが最初の呼び出しです)とユーザーの意図(彼らが実際に必要なこと、彼らの言葉で)。スキルが対象とするシステムの調査は、ユーザーがそのスキルの目的を確認した後に行われる*オーサリング(開発)*に含まれており、skill-authoringが担当します。接続されたツール表面がいかに魅力的であろうとも、その会話の前にそれを調査することは、ツールで推測することです。
作成する前に確認する。 あらゆる成果物(ディレクトリ、登録、ドキュメント)は、それが含むものと共に提案され、承認を得た場合のみ作成されます。
要件は少なく、それ以外はガイダンス。 厳しい要件はプラットフォームが機能するために必要なものです:
その他すべて(アーキテクチャドキュメント、ランブック、追加スキル)は推奨事項です: なぜそれがより良い結果をもたらすのかを説明した上で、ユーザーの選択を尊重してください。狭いユースケースには、完全なワークフロー全体ではなく、狭いセットアップが必要です。
このスキルの言葉ではなく、ユーザーの言葉を話す。 ユーザーはこのファイルを読んでいません。「基本原則」、ファイル名、または「環境チェック」を引用しないでください。何をしているかをはっきり説明してください(「セットアップを確認してから始めます」)。読み取り専用のパスを終わらせるときは、次に何を手助けできるかを提案してください。
接続はここではなく、ダッシュボードで作成されます。 ツールをincident.ioに接続することは認証フローです。ギャップが見つかった場合は、ユーザーをダッシュボードのエクステンションページにリンクし、存在するもので続行します。
専門的な作業は、それを担当するスキルに割り当てる。 このスキルは環境レベルの全体像とルーティングを担当します。上記のルートが所有者を示しています。
インシデント対応 — このスキルはエージェントが使用する仕組みを設定するもので、インシデントを調査するものではありません。
Before anything else, check the model this session runs on. These workflows need Opus/Sol level or higher; smaller models follow them unreliably. If this session is below that level, tell the user and recommend switching model before continuing.
Extensions are how an organization gives incident.io's agents its own tools and instructions. There are two kinds: plugins — directories of skills synced from the organization's repositories, which agents load and follow — and connectors — MCP servers whose tools agents can call. references/extensions-product.md explains how the system works; read it before answering questions about it or changing anything.
This skill is the entrypoint. It teaches the system, reads the current state of an estate, and picks the right mechanism for a problem — and it routes every specialised job to the skill that owns it rather than doing it here.
Whatever the task, the first two moves are the same: read the estate, and hear what the user needs. Nothing else — no drafting, no probing of any connected system — starts before both.
skill-authoring skill now, before
touching any target system — its create job owns the order of work (the user's
context first, exploration after), and starting the exploration here skips the
gates that make the skill worth writing.architecture skilldoctor skillGround before proposing. Grounding means two things, and target-system
exploration is neither: the incident.io estate
(references/estate.md — what's registered, connected, and
already written; extension_plugin_list is the first call), and the user's intent —
what they actually need, in their words. Probing the system a skill will cover is
part of authoring, owned by skill-authoring, and comes after the user has
confirmed what the skill is for. However inviting a connected tool surface is,
exploring it before that conversation is guessing with tools.
Confirm before creating. Every artefact — a directory, a registration, a doc — is proposed with what it will contain, and created only on a yes.
Requirements are few; the rest is guidance. The hard requirements are what the platform needs to function:
Everything else (architecture docs, runbooks, more skills) is a recommendation: explain why it produces better results, then respect the user's choice. A narrow use case gets a narrow setup, not the full walk's ambitions.
Speak the user's language, not this skill's. The user hasn't read this file — never cite "the ground rules", a reference filename, or "the estate walk" at them. Say what you're doing plainly ("I'm checking your configuration before we get started") and end a read-only pass with an offer of what you can help with next.
Connections are created in the dashboard, never here. Connecting a tool to incident.io is an authentication flow. Where a gap is found, link the user to the dashboard's Extensions page and continue with what exists.
Specialised work goes to the skill that owns it. This skill owns the estate-level picture and the routing; the routes above name the owners.
Incident response — this skill configures the machinery agents use, it doesn't investigate incidents.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。