reasoning-scaffold

想清楚，比想得快重要。6步推理框架+400年人性陷阱清单，让你的判断有结构、不犯蠢。人性不变，陷阱不变，框架在手，坑不了你。适用于投资决策、商业判断、风险评估、人生选择。不限行业，通用框架。

Install

openclaw skills install @guoranyt/reasoning-scaffold-package

一句话：想清楚比想得快重要。让判断有结构，不被情绪和人性弱点牵着走。 版本: v1.2.0 | 适用: 投资·商业·人生一切决策场景

🎯 解决了什么问题

痛点：做决策时脑子一团浆糊，回过头来才发现逻辑漏洞一堆。事后后悔"当初怎么没想到"。解法：6步推理框架强制结构化输出 + 12条人性陷阱清单强制自查 = 判断有据可查，不被情绪左右。

核心价值

让人人拥有"第二大脑" — 不是给答案，而是让思考有结构、可追溯、不遗漏。

当你或你的Agent需要做判断/预测/决策时，这套框架强制输出6步推理过程：

前提清晰 ✅
假设列明 ✅
证据充分 ✅
正反论证 ✅
人性自查 ✅
置信度透明 ✅

触发关键词（自动激活）

text

判断、预测、估计、评估、选择、决策、
分析、对比、推测、展望、建议、
该不该、能不能、要不要、
风险、机会、前景、趋势、走势、
好不好、怎么样、如何、哪个、是否

6步推理链

Step 1 · 前提确认

核心问题是什么？需要判断什么？

去除语气词和冗余，精确化问题本质
「明天大盘会涨吗」→「预判下一个交易日A股大盘走向」

Step 2 · 假设列举

哪些前提必须为真，结论才成立？

列出最多4条关键前提假设
区分「已知假设」vs「未知假设」

Step 3 · 证据梳理

已有哪些关键事实/数据支撑？

用户提供的实时数据
历史规律
当前市场状态

Step 4 · 正方论证

支持结论的最强论据（至少2条）

事实依据
历史类比
逻辑推演

Step 5 · 反方质疑 + 人性反思

推翻结论的最大风险（至少2条）

已知风险
未知风险（尾部）
前提假设失效的可能

⚠️ 人性陷阱自查（至少2条）

确认偏误：是否只找了支持结论的证据？
损失厌恶：决策者是否在规避损失而非追求收益？
群体认同：派系/背景认同是否影响判断？
事后合理化：先做决定再找理由？
过度自信：置信度评估是否过高？
信息不对称：是否存在我不知道的关键变量？

Step 6 · 置信度声明

结论置信度（高/中/低）+ 主要不确定因素

🟢 高置信：前提清晰、数据充分、不确定少
🟡 中置信：有一定依据，存在已知未知
🔴 低置信：假设多、变量复杂、结论需谨慎

输出格式模板

text

🧠 推理脚手架 v1.2 | MM/DD HH:MM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【Step 1 · 前提确认】
  核心问题：<精确化的问题>

【Step 2 · 假设列举】
  （结论成立必须为真的前提）
  1. <假设1> [已知/未知]
  2. <假设2> [已知/未知]
  ...

【Step 3 · 证据梳理】
  已有事实：<证据列表>

【Step 4 · 正方论证】
  支持结论的论据：
  1. <论据1>
  2. <论据2>
  ...

【Step 5 · 反方质疑 + 人性反思】
  推翻结论的最大风险：
  1. <风险1>
  2. <风险2>
  ...
  ⚠️ 人性自查：
  · <人性陷阱1>
  · <人性陷阱2>

【Step 6 · 置信度声明】
  置信度：🟢高 / 🟡中 / 🔴低（<原因>）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
<结构化分析正文>

人性知识库（内置常量）

认知层面（人如何思考）：

确认偏误 — 人只找支持自己观点的证据
事后归因谬误 — 先用直觉做决定，再用逻辑自圆
损失厌恶 — 损失100的痛苦 > 获利100的快乐（2.5倍）
锚定效应 — 第一印象强烈影响后续判断
可得性启发 — 最近案例被过度放大

情感层面（人如何感受）：

恐惧驱动 — 面对威胁的反应远强于机会
群体认同 — 天然分"我们/他们"，对内合作对外排斥
自利偏差 — 成功归自己，失败归外部

行为层面（人如何行动）：

过度自信 — 绝大多数人高估自己
行动偏差 — 不确定时更倾向"做点什么"
承诺升级 — 追加投入证明最初决策（沉没成本）
羊群效应 — 不确定时跟随多数人

核心警示语：

「人性最难揣测——人在利益、恐惧、群体压力下，行为往往与表面表态相反。」

适用场景举例

场景	使用方式
A股短线决策	推理脚手架 + 股票技能（our-strategy v3.2）
商业方案选择	「帮我判断A方案还是B方案更适合」
风险评估	「分析这个决定可能有什么后果」
趋势预判	「这件事三个月后可能发展成什么样」
策略规划	「我该怎么规划明年的学习计划」
人事判断	「某人可能的动向」

使用方式

方式1：对话中自动激活

用户说「判断/预测/评估/决策」类问题时，直接输出6步推理框架。

方式2：手动调用

text

python3 scripts/reasoning_scaffold.py "判断明天大盘走势"

技术细节

模块路径: scripts/reasoning_scaffold.py
人性库路径: references/human_nature.md
触发方式: 关键词检测后自动注入，或手动调用
非推理类问题: 跳过框架，正常分析

文件结构

text

reasoning-scaffold/
├── SKILL.md                      # 本文件
├── scripts/
│   └── reasoning_scaffold.py     # 核心模块
└── references/
    └── human_nature.md           # 人性知识库完整版