Reason Through

把一件事从“听起来有道理”，推到“现在知道该怎么办”。

一个用于分析问题、判断价值和辅助决策的通用 Agent Skill。

事实 → 问题 → 价值 → 机制 → 影响 → 证据 → 决策

它解决什么

很多讨论会直接跳到方案：这个功能怎么做、这个 PR 要不要合、这个策略是否值得投入。真正缺失的往往是中间那段推理：它到底在解决谁的什么问题，为什么可能有效，代价由谁承担，目前的证据又能支持多强的结论。

Reason Through 提供一套通用的思考框架，适用于技术方案、产品功能、政策、流程、组织决策、个人选择和各类主张。它不会机械地输出七段报告，而是根据问题挑出真正影响判断的部分。

思考框架

框架会重点检查这条因果链是否成立：

采取措施 → 行为或能力发生变化 → 用户或系统结果改变 → 产生所声称的价值

只要其中一环缺失，Skill 就会直接指出，而不是替方案补一个听起来合理的故事。

什么时候用

你可以这样问：

• “这个功能到底解决什么问题，价值是什么？”
• “这个 PR 的方案为什么有效，会带来什么影响？”
• “这项政策对谁有利，成本和副作用是什么？”
• “继续做、缩小范围和暂缓，应该选哪个？”
• “这个说法有哪些事实依据，哪些只是推断？”

不适合用在简单事实查询，或已经明确、不需要再判断的执行任务上。

使用方式

安装后，可以显式调用：

$reason-through 帮我把这个方案从问题、价值、机制、影响和证据想透。

也可以直接提出需要判断的问题。Agent 会先给结论，再展开对当前决策真正有用的部分；证据不足时，会明确标出未知项和下一步需要验证的事实。

安装

把仓库克隆到你所使用的 Agent 的 Skills 目录即可。目录中应直接包含 SKILL.md。

Codex：

git clone https://github.com/tt-a1i/reason-through.git ~/.codex/skills/reason-through

Claude Code：

git clone https://github.com/tt-a1i/reason-through.git ~/.claude/skills/reason-through

其他支持 Agent Skills 的工具，按其约定放置本仓库即可。

设计原则

• 先确认事实和边界，再谈立场。
• 价值必须对应具体受益者和可观察变化。
• 实现完成、测试通过、真实问题解决，是不同的证据状态。
• 没有证据不等于方案无效，但意味着结论不能说得太满。
• 分析不会自动授权编辑、发布、审批、购买或其他外部操作。

完整指令见 SKILL.md。