关于 explain-outcome
Explain Outcome 是一种按“发生了什么、意味着什么、接下来做什么”三部分汇报结果的写作技能。它区分事实与明确标注的推测,并说明具体行动或无需行动。
主要功能
- 01三部分结果格式
- 02区分事实与推测
- 03标明未经确认的解释
- 04说明下一步行动
- 05允许用一句话汇报简单结果
适用场景
- 01总结测试或命令的结果
- 02避免在解释结果时混淆事实与推测
- 03清楚汇报不确定性
- 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