mcpField
E
explain-outcome

explain-outcome

github.com/lwlee2608Agent 工作流180 次安装1 天前更新
代码仓库

关于 explain-outcome

Explain Outcome 是一种按“发生了什么、意味着什么、接下来做什么”三部分汇报结果的写作技能。它区分事实与明确标注的推测,并说明具体行动或无需行动。

主要功能

  1. 01三部分结果格式
  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确认已加载。

详细介绍

说明结果

按以下顺序分成三部分报告结果。目标只有一个:让人读一遍就明白。

使用 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>

事实写在“发生了什么”下面。猜测写在“这意味着什么”下面,并标注“可能”或“尚未确认”。“接下来做什么”写一项行动:“我会……”或“你必须决定……”。如果不需要采取行动,写“无需行动。完成。”如果结果很小且无需决策,则用一句话回复。

示例

用户:“运行测试。”

正确:

**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?

错误——把事实和猜测写在同一句话中,还在询问而不是陈述:

测试失败,因为 order.go 中的折扣逻辑有问题,可能是提前返回导致的。如果你愿意,我可以修复。

评论

支持 Markdown