explain-outcome について
Explain Outcome は、結果を「何が起きたか」「何を意味するか」「次に何をするか」の順に報告するライティングスキルです。事実と推測を分け、具体的な行動または対応不要であることを示します。
主な機能
- 013部構成の結果フォーマット
- 02事実と推測の区別
- 03未確認の解釈の明示
- 04次の行動の提示
- 05簡単な結果には一文で回答
活用シーン
- 01テストやコマンドの結果の要約
- 02結果の説明で事実と推測を混同しない報告
- 03不確実性を明確に伝える報告
- 04判断不要の小さなタスクを短く完了報告
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lwlee2608/ agent-skills --skill explain-outcomeインストール後、Claude Code で/explain-outcomeを入力して読み込まれたか確認します。
詳細
結果の説明
結果を次の順序で3つに分けて報告してください。目的はただ一つです。人が一度読めば理解できるようにします。
ASD-STE100簡易テクニカル英語で書いてください。短い文は長い文より読みやすくなります。受動態より能動態のほうがわかりやすくなります。一つの意味には一つの単語を使うほうが、毎回類義語を使うよりわかりやすくなります。専門用語より平易な言葉のほうがわかりやすくなります。
形式
**What happened**
<the facts: what ran, what it returned, what changed>
**What it means**
<the cause, the effect, and what is not known yet>
**What's next**
<the action the agent will do, or the decision the user must make>
事実は「起きたこと」に記載します。推測は「意味すること」に記載し、「可能性が高い」または「未確認」と明記します。「次の対応」には、「私が〜します」または「あなたが決める必要があります」という行動を記載します。対応が不要な場合は、「何もありません。完了です。」と書きます。判断が不要な小さな結果の場合は、1文で返答します。
例
ユーザー:「テストを実行してください。」
良い例:
**What happened**
`make test` failed. 1 of 42 tests failed:
FAIL: TestOrderTotal_Discount (order_test.go:88)
expected 90.00, got 100.00
**What it means**
The discount is not in the order total. The likely cause is an early return in `applyDiscount` (order.go:41). This is not confirmed. No other test failed.
**What's next**
- I will read `applyDiscount` to confirm the cause, then fix it.
- You must decide: does a 0% discount call `applyDiscount`, or skip it?
悪い例 — 事実と推測を1文にまとめ、明言せずに尋ねています:
テストは失敗しました。order.goの割引ロジックが壊れているためです。おそらく早期リターンが原因です。必要であれば修正できます。
コメント
Markdown 対応