Install
openclaw skills install @thcjp/soul-decision-engine-proopenclaw skills install @thcjp/soul-decision-engine-pro核心功能: 本技能提供结构化的工作流程和配置指引等能力。
AI Agent的全功能决策引擎。质量评分+偏见检测+决策树可视化+跨设备同步,决策能力可量化。
永远不替你做决定。永远标注置信度。永远检测偏见。决策质量可量化,偏见可识别,跨设备永一致. 灵魂决策引擎专业版在免费版的混合命名空间之上,叠加决策质量评分、偏见深度检测、决策树可视化、多领域权重学习、跨设备云同步、决策回溯六大高级功能,让决策能力从"感觉做得好"升级为"数据证明做得好".
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Soul Decision Engine处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
┌─────────────────────────────────────────────────────────────────┐
│ 灵魂决策引擎专业版 (SOUL DECISION PRO) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 决策质量评分层(专业版) │ │
│ │ 过程合理性 / 信息充分性 / 偏见控制 / 框架匹配 │ │
│ │ / 结果可预测性 │ │
│ └──────────────────────────────────────────────────────┘ │
│ │ │
│ v │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 决策信号检测 │ -> │ 框架匹配 │ -> │ 结构化分析 │ │
│ │ 5类+3类高级 │ │ +权重学习 │ │ +置信度+偏见 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │
│ v │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 决策树可视化│ │ 决策复盘 │ │ 云同步 │ │
│ │ 分支+概率 │ │ +质量评分 │ │ +决策回溯 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ HOT 风险画像│ │ WARM 域模式 │ │ WARM 类型 │ │
│ │ +多域权重 │ │ +跨域平衡 │ │ +深度配置 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ v │
│ ┌──────────────┐ │
│ │ 云同步层 │ ← 跨设备同步(专业版) │
│ │ +决策回溯 │ +版本快照 │
│ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
专业版完全兼容免费版的目录结构,无需迁移数据:
# 若已有免费版数据,直接升级
ls ~/soul-decision/memory.md 2>/dev/null && echo "检测到免费版数据,将自动升级"
# ...
# 若无免费版数据,初始化
mkdir -p ~/soul-decision/{domains,types,decisions,archive,snapshots,metrics}
cat > ~/soul-decision/memory.md << 'EOF'
# 决策热内存(HOT)- 专业版
# ...
**响应解析**: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.
# ...
#
## 风险画像
[暂无 - 通过对话学习]
# ...
## 框架偏好
[暂无 - 通过对话学习]
# ...
## 多域权重
[暂无 - 跨域权重自动平衡]
# ...
---
*最后更新:专业版初始化*
EOF
# 1. 配置跨设备云同步
export SOUL_CLOUD_API_KEY="参数值"
cat > ~/soul-decision/.cloud-config.json << 'EOF'
{
"syncInterval": 300,
"conflictResolution": "merge",
"direction": "both",
"incremental": true
}
EOF
# ...
# 2. 启用决策回溯快照
mkdir -p ~/soul-decision/snapshots
snapshot-config.json << 'EOF'
{
"autoSnapshot": true,
"triggerOnDecision": true,
"retention": 180,
"diffView": true
}
EOF
# ...
# 3. 初始化决策质量评分
cat > ~/soul-decision/metrics/quality-dashboard.json << 'EOF'
{
"dimensions": ["process", "information", "bias_control", "framework_fit", "predictability"],
"baseline": null,
"target": {
"process": 0.85,
"information": 0.80,
"bias_control": 0.90,
"framework_fit": 0.85,
"predictability": 0.75
}
}
EOF
# ...
# 验证配置
ls -la ~/soul-decision/
{
"soulDecision": {
"edition": "pro",
"qualityScoring": {
"enabled": true,
"dimensions": ["process", "information", "bias_control", "framework_fit", "predictability"],
"realTime": true,
"benchmark": "team"
},
"biasDetection": {
"enabled": true,
"biases": ["sunk_cost", "anchoring", "confirmation", "availability", "overconfidence", "framing", "loss_aversion", "recency", "survivorship", "halo_effect"],
"depth": "deep",
"alertOn": "high"
},
"decisionTree": {
"enabled": true,
"maxDepth": 5,
"probabilityAnnotation": true,
"sensitivityAnalysis": true
},
"multiDomainWeight": {
"enabled": true,
"autoBalance": true,
"conflictResolution": "weighted"
},
"cloudSync": {
"enabled": true,
"teamSharing": true,
"encryptAtRest": true
},
"snapshots": {
"enabled": true,
"triggerOnDecision": true,
"retentionDays": 180
},
"model": {
"routing": "gpt-4o",
"fallback": "gpt-4o-mini"
}
}
}
| 维度 | 免费版能力 | 专业版增强 |
|---|---|---|
| 域模式 | 4域(product/tech/business/personal) | +自定义域+跨域权重学习 |
| 类型模式 | 3类型(strategic/tactical/operational) | +自定义类型+深度配置 |
| 决策记录 | 一决策一文件 | +质量评分+偏见检测+决策树 |
| 归档 | 90天归档 | +版本快照+差异对比 |
处理: 解析混合命名空间记忆(基础+增强)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回混合命名空间记忆(基础+增强)的响应数据,包含状态码、结果和日志.
5维度量化决策过程质量:
| 维度 | 评估内容 | 评分标准 | 目标值 |
|---|---|---|---|
| 过程合理性 | 是否用了正确的框架 | 0-1分 | >0.85 |
| 信息充分性 | 关键信息是否齐全 | 0-1分 | >0.80 |
| 偏见控制 | 认知偏见是否被识别与规避 | 0-1分 | >0.90 |
| 框架匹配 | 框架是否适合决策类型 | 0-1分 | >0.85 |
| 结果可预测性 | 预测与实际结果一致性 | 0-1分 | >0.75 |
评分命令:
# 查看决策质量看板
soul quality dashboard
# ...
# 生成质量报告
soul quality report --period 30d --format markdown
# ...
# 对比团队基准
soul quality benchmark --against team
处理: 解析决策质量评分(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策质量评分(专业版独有)的响应数据,包含状态码、结果和日志.
自动识别10+种认知偏见:
| 偏见类型 | 检测信号 | 规避建议 |
|---|---|---|
| 沉没成本 | "已经投入这么多了" | 评估未来成本,不考虑已投入 |
| 锚定效应 | 领先个数字影响过大 | 多角度独立估值 |
| 确认偏误 | 只找支持证据 | 主动寻找反证 |
| 可得性偏差 | 近期事件权重过高 | 用历史数据校准 |
| 过度自信 | 置信度与准确度不匹配 | 用Base Rate校准 |
| 框架效应 | 表述方式影响选择 | 用多种表述重新框架 |
| 损失厌恶 | 损失感>收益感 | 用期望值而非感受 |
| 近因偏差 | 最近发生的事权重高 | 拉长时间窗口 |
| 幸存者偏差 | 只看成功案例 | 研究失败案例 |
| 光环效应 | 单一优点覆盖全局 | 分维度独立评估 |
检测输出示例:
偏见检测报告:
# ...
决策:是否继续投入X项目
检测到偏见:
1. [高] 沉没成本偏误 - "已经投入300万"被作为继续理由
规避建议:仅评估未来300万投入的ROI,不考虑已投入的300万
2. [中] 确认偏误 - 仅引用支持继续的3个案例,忽略2个失败案例
规避建议:补充失败案例分析
3. [低] 近因偏差 - 上周的小成功权重过高
规避建议:用3个月数据评估,而非1周
# ...
偏见控制评分:0.65(目标>0.90)
处理: 解析偏见深度检测(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回偏见深度检测(专业版独有)的响应数据,包含状态码、结果和日志.
将复杂决策可视化为分支树:
# 生成决策树
soul tree build --decision "是否进入新市场"
# ...
# 输出决策树(Markdown格式)
soul tree render --format markdown --max-depth 5
# ...
# 敏感度分析
soul tree sensitivity --variable "市场规模" --range "100万-500万"
决策树示例:
是否进入新市场?
├── 进入(概率0.6)
│ ├── 大成功(概率0.3)→ 收益+500万
│ ├── 小成功(概率0.5)→ 收益+100万
│ └── 失败(概率0.2)→ 损失-200万
│ 期望值:+140万
├── 不进入(概率0.4)
│ ├── 竞争对手进入(概率0.7)→ 相对损失-80万
│ └── 竞争对手不进入(概率0.3)→ 无变化
│ 期望值:-56万
# ...
敏感度分析:
- 若大成功概率降至0.2,进入期望值=+70万(仍优于不进入)
- 若失败损失增至-400万,进入期望值=+10万(接近临界)
处理: 解析决策树可视化(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策树可视化(专业版独有)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作跨域权重自动平衡,解决"产品说要快,技术说要稳"的冲突:
# 查看当前权重配置
soul weight show
# ...
# 输出:
# 域权重配置:
# - product: quality=0.7, speed=0.3
# - tech: quality=0.6, stability=0.4
# - business: speed=0.6, quality=0.4
#
# 跨域冲突解决:
# 当product(quality=0.7)与tech(stability=0.4)冲突时
# 自动权重:product 0.55, tech 0.45(基于历史决策学习)
# ...
# 更新权重(基于新决策)
soul weight update --domain product --factor quality --value 0.8
处理: 解析多领域权重学习(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回多领域权重学习(专业版独有)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 推送决策记忆至云端
soul cloud push
# ...
# 拉取其他设备的决策记忆
soul cloud pull --since "2026-01-01"
# ...
# 双向增量同步
soul cloud sync --direction both
# ...
# 查看同步状态
soul cloud status
处理: 解析跨设备云同步(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回跨设备云同步(专业版独有)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 决策前自动快照
soul snapshot create --label "新市场进入决策前"
# ...
# 查看决策演变
soul snapshot diff --from "2025-07-01" --to "2026-01-01" --category decisions
# ...
# 回滚决策记忆(谨慎)
soul snapshot restore --id snap_20260115 --confirm
处理: 解析决策回溯与版本对比(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策回溯与版本对比(专业版独有)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作| 框架 | 免费版 | 专业版增强 |
|---|---|---|
| 利弊分析 | 基础对比 | +加权+风险标注 |
| 决策矩阵 | 多选项评分 | +敏感度分析 |
| 风险评估 | 基础风险矩阵 | +概率树+蒙特卡洛 |
| 时间权衡 | 速度vs质量 | +时间衰减+机会成本 |
| 利益相关方 | 基础利益矩阵 | +博弈论+纳什均衡 |
| 遗憾最小化 | 基础遗憾分析 | +时间跨度+ regrets权重 |
| 奥兹曼迪斯 | - | +10年回看(专业版独有) |
| Pre-mortem | - | +失败预演(专业版独有) |
处理: 解析决策框架库(完整版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策框架库(完整版)的响应数据,包含状态码、结果和日志. 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:Agent、全功能决策引擎、灵魂决策引擎专业、版是在免费版基础、上的全功能升级、提供从决策分析到、决策优化的完整闭、专业版解锁决策质、决策回溯六大高级、实现决策能力的量、化与持续优化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
痛点:重大战略决策缺乏结构化分析,决策质量无法评估,事后复盘流于形式. 使用方式:
# 决策前生成决策树
soul tree build --decision "是否收购公司X" --max-depth 5
# ...
# 决策中检测偏见
soul bias detect --context "收购决策" --depth deep
# ...
# 输出:
# 检测到偏见:
# 1. [高] 锚定效应 - 收购价以X公司报价为锚
# 2. [中] 过度自信 - 协同效应预测过于乐观
# 3. [低] 确认偏误 - 仅引用成功收购案例
# ...
# 决策后质量评分
soul quality score --decision "收购X" --dimensions all
# ...
# 输出:
# 决策质量评分:0.78(目标>0.85)
# - 过程合理性:0.85(框架匹配良好)
# - 信息充分性:0.70(财务尽调不完整)
# - 偏见控制:0.65(检测到2项高偏见)
# - 框架匹配:0.85(决策树+风险评估)
# - 结果可预测性:0.85(待复盘验证)
效果:战略决策从"拍脑袋"到"有结构+有评分+有偏见检测".
痛点:不同团队的决策风格不一,技术团队偏保守,产品团队偏激进,冲突频发. 使用方式:
# 查看跨域权重配置
soul weight show
# ...
# 输出:
# - tech: stability=0.7, speed=0.3
# - product: speed=0.6, quality=0.4
# 冲突点:技术求稳,产品求快
# ...
# 设置跨域冲突解决规则
soul weight resolve --rule "when tech.stability > 0.7 AND product.speed > 0.5, use weighted_average with tech=0.6, product=0.4"
# ...
# 团队共享决策记忆
soul cloud sync --scope team --direction both
效果:跨团队决策冲突从"吵架"到"有规则",决策效率提升约40%.
痛点:创业过程中充满高风险不可逆决策,认知偏见容易导致致命错误. 使用方式:
# Pre-mortem分析(专业版独有)
soul framework pre-mortem --decision "All-in投入产品X"
# ...
# 输出:
# Pre-mortem:假设1年后产品X失败了,可能原因:
# 1. 市场需求被高估(过度自信)
# 2. 竞争对手反应比预期快(可得性偏差)
# 3. 技术难度被低估(锚定效应)
# 建议:为每个失败原因设计早期预警指标
# ...
# 偏见深度检测
soul bias detect --depth deep --alert-on high
效果:高风险决策的盲点提前暴露,减少致命错误.
痛点:管理者决策能力无法量化评估,晋升决策缺乏数据支撑. 使用方式:
# 生成管理者决策能力报告
soul quality report --user manager-a --period 90d --format markdown
# ...
# 输出:
# 决策能力报告:管理者A(90天)
#
# 决策数量:23
# 平均质量评分:0.82(团队平均0.75)
# 强项:框架匹配(0.90)
# 弱项:偏见控制(0.68,检测到5次高偏见)
#
# 建议:参加偏见规避培训
效果:决策能力从"感觉不错"量化为"0.82分",晋升有据.
痛点:同时在多个客户项目间切换,各项目的决策记忆不一致,容易混淆. 使用方式:
# 项目A的决策记忆
soul cloud pull --project client-a
# ...
# 切换到项目B
soul cloud pull --project client-b
# ...
# 决策记忆严格隔离,跨项目查询需opt-in
soul search "类似的市场进入决策" --scope all-projects --opt-in
效果:多客户项目决策记忆零混淆,切换成本从10分钟降至0.
| 角色 | 典型场景 | 推荐功能组合 | 核心价值 |
|---|---|---|---|
| CEO | 战略决策 | 决策树+偏见检测+质量评分 | 决策有结构有评分 |
| CTO | 跨团队统一 | 多域权重+云同步 | 冲突有规则 |
| 创业者 | 高风险决策 | Pre-mortem+偏见深度检测 | 盲点提前暴露 |
| HR | 决策能力评估 | 质量评分+基准对比 | 量化评估 |
| 独立顾问 | 多客户同步 | 云同步+项目隔离 | 零混淆 |
| 产品经理 | 需求优先级 | 决策矩阵+敏感度分析 | 权衡有据 |
| 投资经理 | 投资决策 | 风险评估+蒙特卡洛 | 风险量化 |
将 soul-decision-engine-pro 添加到Agent的技能列表中.
会话开始时自动加载memory.md + 云同步预取.
决策分析自动执行偏见检测+质量评分.
重大决策前自动创建快照.
# 部署前检查决策一致性
soul cloud pull --before-deploy
# ...
# 部署后记录决策
soul log --type deployment --decision "v2.1.0部署至生产" --quality 0.85
# ...
# 定期生成决策质量报告
soul quality report --period 30d --output reports/decision-quality.md
1. 团队会议决策自动记录
2. 决策前自动生成决策树
3. 决策中自动检测偏见
4. 决策后自动评分
5. 全团队通过云端共享决策记忆
SOUL_CLOUD_API_KEYsnapshots/目录metrics/目录soul quality backfill --source decisions/| 版本 | 日期 | 变更内容 |
|---|---|---|
| 1.0.0 | 2026-01 | 初版发布,含质量评分+偏见检测+决策树+多域权重+云同步+回溯 |
| 问题 | 可能原因 | 解决方案 | 优先级 |
|---|---|---|---|
| 云同步失败 | 网络问题或API Key过期 | 检查网络;验证SOUL_CLOUD_API_KEY | 高 |
| 偏见检测误报 | 规则过于敏感 | 调整检测阈值;优化规则 | 中 |
| 决策树过大 | 深度未限制 | 设置max-depth=5;启用剪枝 | 中 |
| 质量评分不准 | 评分维度权重不合理 | 调整维度权重;校准基准 | 中 |
| 多域权重冲突 | 自动平衡失效 | 手动设置冲突解决规则 | 高 |
| 快照占用过大 | 保留期过长 | 调整retention至90天 | 低 |
| 跨设备决策不一致 | 同步延迟或冲突 | 检查同步状态;配置冲突解决 | 高 |
| 决策树敏感度分析慢 | 变量范围过大 | 限制变量范围;采样分析 | 低 |
| 偏见检测遗漏 | 规则库不全 | 更新偏见规则库 | 中 |
| 质量评分波动大 | 样本量不足 | 累积更多决策样本 | 低 |
| 项目切换缓慢 | 索引未缓存 | 重建项目索引 | 中 |
| 序号 | 错误场景 | 原因 | 处理方式 | 优先级 |
|---|---|---|---|---|
| 1 | 输入参数缺失 | 用户未提供必要参数 | 提示用户提供所需参数后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 | P0 |
| 2 | 执行超时 | 处理时间过长 | 检查输入数据量,分批处理 | P1 |
| 3 | 输出格式错误 | 结果不符合预期格式 | 检查output_format参数配置 | P1 |
专业版在免费版的混合命名空间+四层记忆+决策框架+复盘+置信度基础上,新增六大高级功能:决策质量评分(5维度量化)、偏见深度检测(10+种偏见)、决策树可视化(分支+概率+敏感度)、多领域权重学习(跨域自动平衡)、跨设备云同步、决策回溯。专业版使用GPT-4o模型路由,免费版使用GPT-4o-mini.
5维度独立评分(0-1分),加权平均得总分。维度包括:过程合理性、信息充分性、偏见控制、框架匹配、结果可预测性。每个维度有明确的评分标准。结果可预测性需等决策结果出来后才能评分,其他维度可实时评分.
会。专业版采用"高/中/低"三级置信度标注检测结果。建议关注"高"置信度的偏见,"低"置信度的可能为误报。可通过调整检测阈值降低误报率。偏见检测是辅助工具,最终判断仍需用户.
默认max-depth=5,可配置至10。深度过大时建议启用剪枝(过滤<5%概率的分支)。决策树支持敏感度分析,可评估关键变量变化对期望值的影响.
系统从历史决策中学习各域的权重配置(如product: quality=0.7, speed=0.3)。当跨域决策冲突时(如product求快vs tech求稳),自动按学习到的权重计算加权平均。冲突解决规则可手动覆盖.
三种策略:自动合并(默认)、最新优先、手动解决。建议团队协作场景使用自动合并。冲突解决后会记录在决策记忆中,保留历史可追溯.
快照采用增量存储,单个快照通常<10KB,180天保留期约占用<2MB。可配置retention调整保留天数。建议重大决策前手动创建快照.
免费版支持4个固定域(product/tech/business/personal)。专业版支持自定义域,无数量限制。建议域数不超过10个,避免管理复杂度.
Pre-mortem假设决策已失败,倒推可能的原因。例如"假设1年后产品X失败了,可能原因是什么?"。这帮助识别决策盲点,为每个可能失败原因设计早期预警指标。Pre-mortem是专业版独有框架.
可以。使用soul quality export --format csv/json/markdown导出评分数据。支持按时间范围、维度、用户过滤。导出数据可用于管理层汇报或外部分析.
可以。专业版完全兼容免费版的目录结构,可无缝切换。从专业版降级到免费版时,质量评分、偏见检测、决策树功能将停止,但决策记忆数据保留可用。建议降级前导出质量评分和快照作为备份.
专业版提供多层安全保障:
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| Git | 工具 | 必需 | 系统自带或从git-scm.com安装 |
| Python 3.8+ | 运行时 | 必需 | 从python.org安装 |
| soul-cli | 脚本 | 专业版必需 | 随本技能提供 |
| 云同步服务 | API | 专业版必需 | 配置SOUL_CLOUD_API_KEY |
~/.soul-decision/credentials/目录(已gitignore)本技能基于原始开源作品改进,保留原始版权声明:
本改进作品在原始作品基础上进行了深度差异化改造,包括但不限于:
本专业版相比免费版新增以下能力:
此外,专业版还提供:
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 混合命名空间+四层记忆+决策框架+复盘+置信度+主动检测+风险画像学习+5种角色场景 | 个人试用、轻量决策需求 |
| 收费专业版 | ¥49.9/月 | 全功能(质量评分+偏见检测+决策树+多域权重+云同步+回溯+高级框架)+7种角色指南+性能优化+优先支持 | 团队/企业、高风险决策、决策能力量化 |
专业版通过SkillHub SkillPay发布.
输出:返回执行结果,包含操作状态和输出数据
用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功