关于 reason
Reason 是用于涉及判断或不确定性的 Agent 工作的临时、无状态咨询技能。它审视范围明确的主张或决策并给出简短结论,实施与验收仍由所属任务负责。
主要功能
- 01无状态且不生成工件
- 02针对重要判断设置检查点
- 03提供 decide、challenge 和 ask 分支
- 04检验假设与反方观点
- 05给出简短结论但不作批准
适用场景
- 01选择方案前审视提议
- 02失败或方向改变后重新评估
- 03汇报结果前发现证据缺口
- 04指出阻碍进展且需用户决定的问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ akshay-diwadkar/ first-four-hours --skill reason安装后在 Claude Code 中输入/reason确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/ask.mdchallenge.mdcheckpoint-trace.mddecide.mddelegation-protocol.mdresults.md详细介绍
Reason
临时、无状态且不产生制品:Reason 从不改变任何状态,不赋予自身任何变更权限或领域权限,并且只输出咨询结果,不提供评分、置信度或投票。所属任务负责保留制品、验收、完成情况和实施决策。
检查点
是否适用取决于开放式判断、不确定性和后果,而非任务大小或文件数量。凡是需要选择方案、权衡证据或利弊,或声称取得了无法通过机械检查判定的结果的工作,都必须在确定方案前、发生失败或方向变更后,以及呈现结果前咨询 Reason。工作所依赖的工具、探查、身份检查或封存一旦失败,就视为失败。考虑过咨询,或确认过未经测试的内容,都不算咨询;置信度或一个看似合理的行动都不能成为例外,因为负责人看不到自己的盲点。没有剩余判断事项的工作,例如照章编辑、常规技术修复或按已完整确定的计划执行,无需经过检查点;若计划存在矛盾,则交还规划负责人处理。
每次咨询都只进行一轮有界审查,范围与后果相称:当前目标、提案或结果;其权限和证据;以及它可能改变的行动。对于非琐碎决策,说明最有力的反对理由,检查盲点,并核实每一项关键假设。咨询以一至两行的可见结果结束,指出所审查的主张或决策、所测试的风险,以及以下一种处置:重大异议、缺少证据、需要用户输入或无重大问题;不得凭空制造批评,也不得保留这行结果。Reason 会说明应重新考虑什么以及原因;负责人负责权衡,并修补有依据的问题。不得递归、组建小组或建立自动调用链。每次咨询都要阅读 结果,了解什么属于非琐碎事项、结果行和结果应放在哪里,以及开放式处置需要什么。负责人应根据检查点追踪报告检查点。
分支
根据判断,选择负责该问题的最小分支;分支内部可以重新分类。进入分支时请阅读对应参考,其中规定了面向用户的结果格式。
- decide:目标、证据、冲突、原因、选项、假设或失败尚未解决,因此没有可辩护的下一步:decide 详情。
- challenge:已有具体提案或结果:challenge 详情,其中说明何时应向新的挑战者简要说明情况。
- ask:进展取决于一项重要且由用户决定的事实、选择、偏好、政策、许可、风险承受度、范围、权限或操作规则,而这些内容无法通过证据和有界探索推导出来:ask 详情。
任何结果都不代表批准,也不能证明正确性。