mcpField
E
explain-outcome

explain-outcome

github.com/lwlee2608エージェントワークフロー180 回インストール1 日前に更新
リポジトリ

explain-outcome について

Explain Outcome は、結果を「何が起きたか」「何を意味するか」「次に何をするか」の順に報告するライティングスキルです。事実と推測を分け、具体的な行動または対応不要であることを示します。

主な機能

  1. 013部構成の結果フォーマット
  2. 02事実と推測の区別
  3. 03未確認の解釈の明示
  4. 04次の行動の提示
  5. 05簡単な結果には一文で回答

活用シーン

  1. 01テストやコマンドの結果の要約
  2. 02結果の説明で事実と推測を混同しない報告
  3. 03不確実性を明確に伝える報告
  4. 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の割引ロジックが壊れているためです。おそらく早期リターンが原因です。必要であれば修正できます。

コメント