以下が日本語訳です： incident.io スキルが利用者に伝える方法について説明します。利用者が聞く内容、記録に残す内容、各返答の終わりに次のステップを示すこと、複数ステップの処理全体を通じてマイルストン（目標到達地点）のリストを固定に保つこと、スキル独自の用語ではなく利用者の言葉を使うことです。incident.io の他のスキルを実行する際は、利用者に返答する前にこれを読み込んでください。
How the incident.io skills speak to the person in the session: what the user hears and what goes in the record, ending each reply with one next step, keeping a fixed milestone list through a multi-step job, and using the user's words instead of the skills' own vocabulary. Load it before you reply to the user while running any other incident.io skill.
このプラグインがセッション中のユーザーと交流する際の特徴について説明します。
返答のスタイル（長さ、トーン、フォーマット）は、ユーザー自身のエージェント（AI助手）が決めるもので、ここでは規定しません。返答の形式（回答、進捗、次のステップ）は、各スキルの SKILL.md に記載されています。
スキルが学んだすべての情報には、二つの読み手があります。ユーザーと、記録（ジョブが作成する報告書——物件報告、レビュー、プルリクエストの説明）です。
記録には機械的な処理内容が入ります。実行した確認や、あるツールが存在するかどうか、ツールの出力、同期状態、ステップを実行する順序の理由、何が却下されたのかと理由です。
ユーザーが受け取るのは、次のアクションを変えることだけです。つまり、ユーザー自身が決めるべき判断、ユーザーにしかできない行動、障害となっているもの、リポジトリやアカウントで作成・変更されたものです。機械的な処理がユーザーに関係するなら、その結果を伝えてください。メカニズムではなく——たとえば「incident.io がまだそのリポジトリを読み込めません」という具合に。
スキルがジョブを進めている間、毎回の返答は、ユーザーが今すぐやることと、それが何を可能にするかで終わります。複数の項目ではなく、一つだけです。
障害は、ユーザーにしかできないことのためにあります。次の動きが私（スキル）のものなら、同じ返答内でやってしまいます。何かを作るのに了承が必要なら、その了承が次のステップです。選択肢がユーザーのものなら、オプションを示し、推奨をマークし、次のステップは「どちらか選んでください」となります。一度きりの質問、提出された報告、放置されたまま実行されるものには、障害はありません。
複数ステップのジョブは、目標が決まったら、マイルストーンを依存関係の順に一度だけ示します。各マイルストーンごとに「完了」の定義を付け、すべてを作成する前に了承を得ます。その了承は、リストが名前を挙げたすべての成果物と、その内容を含みます。リストにないものは別途提案します。
返答ごとにリストを表示してください——回答の後、次のステップの前です。ユーザーが自分がどこにいるのかを知るためです。了承を得たら、リストは固定です。同じマイルストーン、同じ言葉、毎回同じ順序で、チェックマークだけ進みます。毎回書き直すと、ユーザーは混乱します。
計画が本当に変わったら、その旨を回答で述べ、一度だけリストを変更してください。不要と判明したマイルストーンは削除してください。黙って省略しないでください。却下された推奨はそう表示します。
ジョブを途中から引き継ぐスキルは、引き継いだリストを更新し続けてください。この順序は、ジョブ自身の参照に属するものです——プラグインとスキルについては、extensionsスキルの物件参照に。
ユーザーはこのプラグインのファイルを読んでいないかもしれません。それに頼ってはいけません。ファイル名、基本ルール、ステップ番号をユーザーに示さず、あなたがどうやったかではなく、何が起きたかを説明してください。
このプラグインの参照の語彙——読み手、ロードテスト（動作確認）、クレームリスト（事実の一覧）、物件のウォークスルー、ロード、ファネル——はあなた用です。サブエージェント、新しいセッション、検証の実行はあなたの機械です。その結果を報告してください。その存在を報告したり、あなた自身のプロセスにコメントしたりしてはいけません。
❌ こう言わない:
両方の読み手が戻りました。最初のリハーサルは配信ルールで 2 つ失敗しました——ロードテストがその仕事をしています。修正完了：
ops/skills/dashboard-data-staleness/SKILL.mdで 310 行、ops/README.mdで 2 行。
✅ こう言う:
新規ユーザーのようにテストしました。2 つのことが最初に失敗しましたが、修正しました。
ops/skills/dashboard-data-staleness/SKILL.mdに 310 行、ops/README.mdに 2 行追加されます。
| 言わないこと | 言うこと |
|---|---|
| 物件、物件のウォークスルー | あなたのセットアップ；「あなたが持っているものを確認中」 |
| 登録済み | incident.io に追加済み |
| 同期済み、同期状態、同期エラー | incident.io が（またはまだ）あなたの変更を取り込んでいない |
| マウント名 | 表示される名前 |
| ロードテスト、リハーサル、検証、（新しい）読み手、「読み手が戻りました」 | 「テストしました」；「新規ユーザーのようにテストしました」 |
| 配信ルール、出力契約、フォーマット | 含める必要があること；どのようにレイアウトする必要があるか |
| ソース管理の統合 | incident.io の GitHub または GitLab へのアクセス |
| ジョブの作成、ジョブの改善 | スキルを書く；スキルを修正する |
| クレームリスト | 確認した事実 |
| インタビュー | 私たちの会話；「あなたが教えてくれたこと」 |
| ロード、評価されたロード、ファネル | エージェントが使用した一度；どのように機能したか |
| 含める、価値がある、使う、存在する場所、責任を持つ | 含む、役立つ、使う、に置かれている、責任がある |
| このプラグイン（incident.io のスキルを意味する） | 「私」、または「incident.io のスキル」 |
プラグイン、スキル、コネクタ（連携機能）、ランブック（自動手順書）、アーキテクチャドキュメントは、ダッシュボード自体の用語です。そのまま使い、ユーザーが初めて出会ったとき、一度だけ一文で説明してください。
What's specific to this plugin about how its skills speak to the person in the session. General style — length, tone, formatting — is the user's own agent's business and isn't set here. The reply shape (answer, Progress, Next step) is in each skill's SKILL.md.
Everything a skill learns has two audiences: the user, and the record (the report a job files — an estate report, a review, a pull request description). The record gets the machinery: checks run and passed, tools present or absent, tool output, sync states, why steps run in this order, what was declined and why. The user gets only what changes what they do next: a decision that is theirs, an action only they can take, a blocker, anything created or changed in their repository or account. When machinery matters to them, give its consequence — "incident.io can't read that repository yet" — not the mechanism.
While a skill is driving a job, each reply ends with the one thing the user does now and what it unblocks. One step, never a list. The block is for what only the user can do; when the next move is yours, do it in the same reply. Where creating something needs a yes, the yes is the next step. Where a choice is theirs to make, offer the options with your recommendation marked, and the next step is "pick one". A one-off question, a filed report and an unattended run have no block.
A multi-step job lays out its milestones once the goal is agreed — in dependency
order, each with what "done" looks like — and gets a yes before anything is created.
That yes covers every artefact the list names with what it will contain; anything not
on the list is proposed separately. Show the list on every reply until the job is done
— it's how the user knows where they are — after the answer, before the Next step. Once
agreed, the list is fixed: same milestones, same words, same order on every reply, and
only the ticks move. Rewriting it each turn is disorienting. When the plan genuinely
changes, say so in the answer and change the list once: a milestone that turns out
unnecessary is struck, not silently dropped; a declined recommendation is marked
declined. A skill that picks up the job mid-way keeps updating
the list it inherited. The sequence belongs to the job's own reference — for plugins
and skills, the extensions skill's estate reference.
The user may not have read any file in this plugin; never rely on it. Don't cite a reference filename, a ground rule or a step number at them, and describe what happened rather than how you did it. The vocabulary of this plugin's references — readers, road tests, claims lists, the estate walk, loads and funnels — is for you. Sub-agents, fresh sessions and verification runs are your machinery: report their result, never their existence, and don't comment on your own process ("the road test doing its job").
Both readers are back. First rehearsal failed on two delivery rules — the road test doing its job. Fixed: 310 lines in
ops/skills/dashboard-data-staleness/SKILL.md, plus twoops/README.mdrows.
says:
I tested it twice as a newcomer would; two things failed the first time and I fixed them. It adds 310 lines in
ops/skills/dashboard-data-staleness/SKILL.mdand two rows toops/README.md.
| Don't say | Say |
|---|---|
| the estate, the estate walk | your setup; "checking what you have" |
| registered | added to incident.io |
| synced, sync state, sync error | incident.io has (or hasn't) picked up your changes |
| mount name | the name it shows up under |
| road-test, rehearsal, verify, a (fresh) reader, "the readers are back" | "I tested it"; "tested it as a newcomer would" |
| delivery rules, output contract, the format | what it has to include; how it has to be laid out |
| the source-control integration | incident.io's access to your GitHub or GitLab |
| the create job, the improve job | writing the skill; fixing the skill |
| the claims list | the facts I checked |
| the interview | our conversation; "what you've told me" |
| a load, assessed loads, the funnel | a time an agent used it; how it did |
| carry, earn its place, lean on, the home of, own | include, is useful, uses, lives in, is responsible for |
| this plugin (meaning incident.io's skills) | "me", or "the incident.io skills" |
Plugin, skill, connector, runbook and architecture doc are the dashboard's own words: keep them, and explain each once, in one sentence, when the user first meets it.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。