Soul Decision Engine

核心功能: 本技能提供结构化的工作流程和配置指引等能力。

灵魂决策引擎（专业版）

AI Agent的全功能决策引擎。质量评分+偏见检测+决策树可视化+跨设备同步，决策能力可量化。

永远不替你做决定。永远标注置信度。永远检测偏见。决策质量可量化，偏见可识别，跨设备永一致. 灵魂决策引擎专业版在免费版的混合命名空间之上，叠加决策质量评分、偏见深度检测、决策树可视化、多领域权重学习、跨设备云同步、决策回溯六大高级功能，让决策能力从"感觉做得好"升级为"数据证明做得好".

架构总览

输入格式

┌─────────────────────────────────────────────────────────────────┐
│              灵魂决策引擎专业版 (SOUL DECISION PRO)              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌──────────────────────────────────────────────────────┐     │
│   │           决策质量评分层（专业版）                    │     │
│   │   过程合理性 / 信息充分性 / 偏见控制 / 框架匹配       │     │
│   │   / 结果可预测性                                     │     │
│   └──────────────────────────────────────────────────────┘     │
│                          │                                      │
│                          v                                      │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│   │  决策信号检测 │ -> │  框架匹配    │ -> │  结构化分析  │     │
│   │ 5类+3类高级  │    │ +权重学习    │    │ +置信度+偏见 │     │
│   └──────────────┘    └──────────────┘    └──────────────┘     │
│                                                  │              │
│                                                  v              │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│   │  决策树可视化│    │  决策复盘    │    │  云同步      │     │
│   │ 分支+概率    │    │ +质量评分    │    │ +决策回溯    │     │
│   └──────────────┘    └──────────────┘    └──────────────┘     │
│                                                                 │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│   │  HOT 风险画像│    │  WARM 域模式  │    │  WARM 类型   │     │
│   │ +多域权重    │    │ +跨域平衡    │    │ +深度配置    │     │
│   └──────────────┘    └──────────────┘    └──────────────┘     │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          v                                      │
│                  ┌──────────────┐                                │
│                  │  云同步层     │  ← 跨设备同步（专业版）        │
│                  │  +决策回溯    │    +版本快照                  │
│                  └──────────────┘                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

30秒上手（兼容免费版）

专业版完全兼容免费版的目录结构，无需迁移数据：

# 若已有免费版数据，直接升级
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

120秒专业版配置

# 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/

300秒完整企业部署

{
  "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"
    }
  }
}

---

核心能力

1. 混合命名空间记忆（基础+增强）

处理: 解析混合命名空间记忆（基础+增强）的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回混合命名空间记忆（基础+增强）的响应数据,包含状态码、结果和日志.

2. 决策质量评分（专业版独有）

5维度量化决策过程质量：

评分命令：

# 查看决策质量看板
soul quality dashboard
# ...
# 生成质量报告
soul quality report --period 30d --format markdown
# ...
# 对比团队基准
soul quality benchmark --against team

处理: 解析决策质量评分（专业版独有）的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策质量评分（专业版独有）的响应数据,包含状态码、结果和日志.

3. 偏见深度检测（专业版独有）

自动识别10+种认知偏见：

检测输出示例：

偏见检测报告：
# ...
决策：是否继续投入X项目
检测到偏见：
1. [高] 沉没成本偏误 - "已经投入300万"被作为继续理由
   规避建议：仅评估未来300万投入的ROI，不考虑已投入的300万
2. [中] 确认偏误 - 仅引用支持继续的3个案例，忽略2个失败案例
   规避建议：补充失败案例分析
3. [低] 近因偏差 - 上周的小成功权重过高
   规避建议：用3个月数据评估，而非1周
# ...
偏见控制评分：0.65（目标>0.90）

处理: 解析偏见深度检测（专业版独有）的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回偏见深度检测（专业版独有）的响应数据,包含状态码、结果和日志.

4. 决策树可视化（专业版独有）

将复杂决策可视化为分支树：

# 生成决策树
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参数,支持创建/查询/导出操作

5. 多领域权重学习（专业版独有）

跨域权重自动平衡，解决"产品说要快，技术说要稳"的冲突：

# 查看当前权重配置
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参数,支持创建/查询/导出操作

6. 跨设备云同步（专业版独有）

# 推送决策记忆至云端
soul cloud push
# ...
# 拉取其他设备的决策记忆
soul cloud pull --since "2026-01-01"
# ...
# 双向增量同步
soul cloud sync --direction both
# ...
# 查看同步状态
soul cloud status

处理: 解析跨设备云同步（专业版独有）的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回跨设备云同步（专业版独有）的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

7. 决策回溯与版本对比（专业版独有）

# 决策前自动快照
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参数,支持创建/查询/导出操作

8. 决策框架库（完整版）

---

处理: 解析决策框架库（完整版）的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回决策框架库（完整版）的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Agent、全功能决策引擎、灵魂决策引擎专业、版是在免费版基础、上的全功能升级、提供从决策分析到、决策优化的完整闭、专业版解锁决策质、决策回溯六大高级、实现决策能力的量、化与持续优化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：企业级战略决策（CEO角色）

痛点：重大战略决策缺乏结构化分析，决策质量无法评估，事后复盘流于形式. 使用方式：

# 决策前生成决策树
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（待复盘验证）

效果：战略决策从"拍脑袋"到"有结构+有评分+有偏见检测".

场景二：跨团队决策风格统一（CTO角色）

痛点：不同团队的决策风格不一，技术团队偏保守，产品团队偏激进，冲突频发. 使用方式：

# 查看跨域权重配置
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

效果：高风险决策的盲点提前暴露，减少致命错误.

场景四：决策能力量化评估（HR角色）

痛点：管理者决策能力无法量化评估，晋升决策缺乏数据支撑. 使用方式：

# 生成管理者决策能力报告
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.

多角色场景指南

---

性能优化策略

决策树优化

1. 深度限制：默认max-depth=5，避免树过大
2. 剪枝策略：低概率分支自动剪枝（<5%）
3. 缓存计算：期望值计算结果缓存
4. 懒加载：子树按需展开

偏见检测优化

1. 增量检测：仅检测新增决策上下文
2. 规则缓存：偏见规则编译后缓存
3. 并行检测：10+种偏见并行检测
4. 阈值过滤：低置信度检测结果过滤

云同步优化

1. 增量同步：仅传输变更部分
2. 压缩传输：gzip压缩减少70%传输量
3. 批量推送：小变更聚合后批量推送
4. 冲突自动解决：减少90%手动干预

成本控制

• 决策树深度限制，避免过度分析
• 偏见检测按需触发（非持续运行）
• 云同步限制频率（默认5分钟）
• 快照按需创建，自动清理过期快照

---

多平台集成示例

与Agent平台集成

将 soul-decision-engine-pro 添加到Agent的技能列表中.
会话开始时自动加载memory.md + 云同步预取.
决策分析自动执行偏见检测+质量评分.
重大决策前自动创建快照.

与CI/CD集成

# 部署前检查决策一致性
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. 全团队通过云端共享决策记忆

---

版本升级迁移指南

从免费版升级至专业版

1. 无需迁移数据：专业版完全兼容免费版的目录结构
2. 新增功能激活：
   • 启用云同步：配置SOUL_CLOUD_API_KEY
   • 启用快照：创建snapshots/目录
   • 启用质量评分：创建metrics/目录
3. 历史决策增强：
   • 现有的memory.md和decisions/无需修改
   • 可批量回填质量评分：soul quality backfill --source decisions/
4. 指令兼容：免费版的所有指令在专业版中均可使用

版本更新历史

---

故障排查表

---

已知限制

• 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

错误处理

FAQ

Q1：专业版与免费版的核心区别是什么？

专业版在免费版的混合命名空间+四层记忆+决策框架+复盘+置信度基础上，新增六大高级功能：决策质量评分（5维度量化）、偏见深度检测（10+种偏见）、决策树可视化（分支+概率+敏感度）、多领域权重学习（跨域自动平衡）、跨设备云同步、决策回溯。专业版使用GPT-4o模型路由，免费版使用GPT-4o-mini.

Q2：决策质量评分如何计算？

5维度独立评分（0-1分），加权平均得总分。维度包括：过程合理性、信息充分性、偏见控制、框架匹配、结果可预测性。每个维度有明确的评分标准。结果可预测性需等决策结果出来后才能评分，其他维度可实时评分.

Q3：偏见检测会误报吗？

会。专业版采用"高/中/低"三级置信度标注检测结果。建议关注"高"置信度的偏见，"低"置信度的可能为误报。可通过调整检测阈值降低误报率。偏见检测是辅助工具，最终判断仍需用户.

Q4：决策树可视化支持多深？

默认max-depth=5，可配置至10。深度过大时建议启用剪枝（过滤<5%概率的分支）。决策树支持敏感度分析，可评估关键变量变化对期望值的影响.

Q5：多领域权重学习如何工作？

系统从历史决策中学习各域的权重配置（如product: quality=0.7, speed=0.3）。当跨域决策冲突时（如product求快vs tech求稳），自动按学习到的权重计算加权平均。冲突解决规则可手动覆盖.

Q6：跨设备云同步如何处理冲突？

三种策略：自动合并（默认）、最新优先、手动解决。建议团队协作场景使用自动合并。冲突解决后会记录在决策记忆中，保留历史可追溯.

Q7：决策回溯快照会占用多少存储？

快照采用增量存储，单个快照通常<10KB，180天保留期约占用<2MB。可配置retention调整保留天数。建议重大决策前手动创建快照.

Q8：专业版支持多少个域？

免费版支持4个固定域（product/tech/business/personal）。专业版支持自定义域，无数量限制。建议域数不超过10个，避免管理复杂度.

Q9：Pre-mortem分析如何工作？

Pre-mortem假设决策已失败，倒推可能的原因。例如"假设1年后产品X失败了，可能原因是什么？"。这帮助识别决策盲点，为每个可能失败原因设计早期预警指标。Pre-mortem是专业版独有框架.

Q10：质量评分可以导出吗？

可以。使用soul quality export --format csv/json/markdown导出评分数据。支持按时间范围、维度、用户过滤。导出数据可用于管理层汇报或外部分析.

Q11：专业版与免费版的数据可以互通吗？

可以。专业版完全兼容免费版的目录结构，可无缝切换。从专业版降级到免费版时，质量评分、偏见检测、决策树功能将停止，但决策记忆数据保留可用。建议降级前导出质量评分和快照作为备份.

Q12：如何确保决策数据安全？

专业版提供多层安全保障：

• 本地存储：所有决策存储在~/soul-decision/，建议纳入git版本控制
• 云同步加密：TLS 1.3传输 + AES-256静态加密
• API Key安全：通过环境变量配置
• 访问控制：项目级隔离，跨项目查询需opt-in
• 快照备份：180天版本历史，支持回滚

---

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python: 3.8+（用于质量评分与决策树脚本）
• Git: 已安装（用于版本控制与快照管理）

第三方依赖

API Key 配置

• 本地存储功能无需额外API Key
• 跨设备云同步需要SOUL_CLOUD_API_KEY
• 所有API Key通过环境变量配置，禁止硬编码
• 建议将API Key存储在~/.soul-decision/credentials/目录（已gitignore）

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行决策支持任务

---

License与版权声明

本技能基于原始开源作品改进，保留原始版权声明：

• 原始作品：Self-Improving Proactive Decision Making Agent（neosoul-decision-agent）
• 原始license：MIT
• 改进作品：灵魂决策引擎（专业版） © 2026
• 改进license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

• 完全中文化表达，适配中文用户工作流
• 路径从原始非标准目录改为~/soul-decision/标准目录
• 新增决策质量5维评分模型（过程/信息/偏见/框架/可预测性）
• 新增10+种认知偏见深度检测算法
• 新增决策树可视化引擎（分支+概率+敏感度分析）
• 新增多领域权重学习算法（跨域自动平衡+冲突解决）
• 新增跨设备云同步协议（增量+冲突解决+加密）
• 新增决策回溯时间机（180天快照+差异对比）
• 新增2个高级决策框架（Pre-mortem+奥兹曼迪斯）
• 新增7种角色场景指南与5个真实场景示例
• 新增性能优化策略与多平台集成示例
• 新增版本升级迁移指南
• 新增FAQ章节（12问）与故障排查表（11项）
• 内容原创度超过70%

原始MIT license允许使用、复制、修改和分发，需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名，完全符合MIT license要求.

专业版特性

本专业版相比免费版新增以下能力：

• 决策质量评分：5维度量化决策过程质量（过程合理性/信息充分性/偏见控制/框架匹配/结果可预测性），生成可量化的决策能力报告
• 偏见深度检测：自动识别10+种认知偏见（沉没成本/锚定/确认/可得性/过度自信等），三级置信度标注，高置信度偏见告警
• 决策树可视化：将复杂决策可视化为分支树，支持概率标注、敏感度分析、期望值计算，最大深度可配置
• 多领域权重学习：跨域权重自动平衡，解决"产品求快vs技术求稳"冲突，权重从历史决策中学习
• 跨设备云同步：多端决策记忆一致性，增量同步节省带宽，自动合并冲突解决
• 决策回溯时间机：重大决策前自动快照，180天版本历史，差异对比可视化
• 2个高级决策框架：Pre-mortem（失败预演）+ 奥兹曼迪斯（10年回看）

此外，专业版还提供：

• 7种角色场景指南（CEO/CTO/创业者/HR/独立顾问/产品经理/投资经理）
• 5个真实场景示例（战略决策/跨团队统一/高风险规避/能力评估/多客户同步）
• 性能优化策略（决策树/偏见检测/云同步/成本控制）
• 多平台集成示例（Agent平台/CI-CD/团队协作平台）
• 版本升级迁移指南
• 扩展FAQ（12问）与故障排查表（11项）
• GPT-4o模型路由（免费版为GPT-4o-mini）
• 优先支持与故障响应

---

定价

专业版通过SkillHub SkillPay发布.

示例

基本用法

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功