mcpField
F
fable-outcome-first

fable-outcome-first

github.com/immamdouhaboammarエージェントワークフロー355 回インストール1 週間前に更新
リポジトリ

fable-outcome-first について

fable-outcome-firstは、技術的な回答や状況報告、診断、作業要約を簡潔にまとめるためのライティングスキルです。ユーザー向けの文章を作るエージェントを対象とし、結論を先に示して次の行動に関わる情報だけを残します。

主な機能

  1. 01冒頭の文で結果を示す
  2. 02挨拶や形式的な前置きを削除
  3. 03次の行動に必要な詳細に絞る
  4. 04質問に合わせて構成を調整
  5. 05具体的な技術的根拠を保持

活用シーン

  1. 01技術的な質問への直接回答
  2. 02複数段階の調査の要約
  3. 03バグ修正結果の報告
  4. 04状況報告の簡潔化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/immamdouhaboammar/get-fable --skill fable-outcome-first

インストール後、Claude Code で/fable-outcome-firstを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

skill.package.json
agents/
openai.yaml
evals/
scenarios.json

詳細

Fable Outcome First

返信の最初の文で、ユーザーが実際に尋ねた質問に答えます。それ以外は、読者の次の行動を変える場合に限り、補足として含めます。丁寧さは報告の分量ではなく、回答の質に表れます。

目的

高密度で、結論を先に伝える技術コミュニケーションを徹底します。会話上の無駄な言葉、中身のない称賛、冗長な調査ログ、事務的な分類の前置きをなくします。

使用する場面

  • ユーザー向けの回答、進捗報告、診断レポート、タスクの要約を書くとき。
  • 複数の手順を伴う調査や複雑なバグ修正を終えたとき。
  • 長い前置きの段落や、求められていない箇条書きを書きそうになったとき。
  • 直接的な「はい/いいえ」の質問や、具体的な技術的な問い合わせに答えるとき。

使用しない場面

  • 詳細なユーザーマニュアルや包括的な API リファレンスガイドを書くとき(fable-artifact を使用してください)。
  • 複数ページにわたる技術的なトレードオフを伴うアーキテクチャ提案を作成するとき(fable-architecture を使用してください)。
  • 正式なセキュリティ脆弱性の開示レポートを作成するとき(fable-redteam を使用してください)。

入力

  • raw_response:作成した回答または技術的な調査結果。
  • user_query:ユーザーが実際に尋ねた質問または指示。

出力

  • calibrated_response:要点に直接答える、結論を先に伝える回答。

手順

  1. 最初の文で結論を伝える:何が起きたのか、何が分かったのか、答えは何かを述べます。質問が文字どおり「はい/いいえ」で答えられるものなら、最初の語は「はい」または「いいえ」にします。そうでなければ、無理に付け加えず、質問と同じ観点で答えを述べます。
  2. タスクの分類から書き始めない:「これは判断に関する質問です……」「これはコーディングではなく意思決定の場面です……」などの表現は削除します。ユーザーは自分の質問を把握しています。
  3. 質問に合わせた形にする:簡単な質問には、簡潔な文章で答えます。1段落で収まる内容に見出し、箇条書き、表は使いません。読者がセクション間を移動する必要がある場合にのみ、見出しを使います。
  4. 圧縮ではなく削除して短くする:読者の次の行動に影響しない内容を削ります。残す内容は完全な文にし、語句を省略したり、矢印でつないだりしません(A → B → fails)。
  5. 席を外していたチームメイトに向けて書く:相手は内部の作業過程を見ていません。何を指すのか説明せずに「オプション B」や「2つ目の方法」と言及しないでください。
  6. 行き止まりは最小限にする:読者が回答を信頼して行動するために必要な場合に限り、行き止まりについて触れます(最大1文)。
  7. 迎合や自己称賛を避ける:「いい質問です!」「おっしゃるとおりです!」「完璧です!」などを削除します。賛同は内容で示します。
  8. 最終メッセージだけで完結させる:このターンで読者に必要な情報をすべて含めます。途中のメモは読まれない可能性があります。

判断基準

対比例

質問:「昨夜のデプロイが失敗した原因は何ですか?」

冗長な回答(事務的な報告スタイル):

これは診断に関する質問なので、調査内容を順に説明します。

タイムライン

……8項目……

除外した仮説

……3項目……

根本原因

上記を踏まえると、マイグレーションがタイムアウトしました。ご希望でしたら、関連する問題は別途登録します!

結論を先に伝える回答(原因を直接説明):

昨夜のデプロイは、高負荷時に users テーブルの排他ロック待ちが発生し、マイグレーション 0042_add_user_indices がタイムアウトしたため失敗しました。

CONCURRENTLY を有効にして、マイグレーションを再試行できます。

  • ユーザーから質問された場合は、最初の文で答えます。
  • ユーザーから指示された場合は、最初の文で成功したか失敗したかを伝えます。
  • 判断に影響しない、またはエンジニアの次の行動を変えない文は削除します。

ツールの使用方針

  • 回答を送る前に、生成した内容がこれらのルールに沿っているか確認します。
  • モバイル端末での素早い読み取りを妨げる Markdown の書式は使いません。

根拠の要件

  • 裏付けとなる文中に、正確な識別子、コミットハッシュ、またはエラーメッセージを直接記載してください。
  • 曖昧な主張は避け、具体的なファイル名と行番号を示して結果の根拠を明確にしてください。

失敗時の対応

  • 下書きが称賛(「素晴らしいアイデアです!」など)で始まる場合は、送信前にその表現を削除してください。
  • 下書きが作業手順の説明(「最初に検索しました……」など)で始まる場合は、結論が先に来るように順序を入れ替えてください。

完了基準

  • ユーザーが前置きを読み飛ばしたり探したりせずに、すぐに回答を得られるようにしてください。
  • 重要な技術的詳細と必要な次のアクションをすべて保持してください。

コメント