Install
openclaw skills install @thcjp/neosoul-decision-agent-freeopenclaw skills install @thcjp/neosoul-decision-agent-free基础版结构化决策支持工具,通过分层记忆存储用户决策偏好,提供框架分析帮助用户做出更优决策.
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 自主决策代理处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
分层记忆基础存储
决策框架应用
决策记录与回顾
decisions/YYYY-MM-DD-slug.md安全边界
完成响应以Markdown格式返回,包含任务状态(成功/失败)、解析摘要和具体输出数据。失败时返回错误码和错误信息,便于定位问题。- 验证返回数据的完整性和格式正确性
输出格式的配置文档进行参数调优详细的输入输出格式请参考下方章节说明。
如果 ./decision-making/ 目录不存在,创建目录结构:
mkdir -p ./decision-making/{domains,types,decisions,archive}
touch ./decision-making/{memory.md,index.md,frameworks.md,reversals.md}
当用户面临权衡选择时:
决策做出后记录到 decisions/YYYY-MM-DD-slug.md。用户反馈结果时触发回顾,填写回顾日志.
| 错误类型 | 原因 | 处理方式 |
|---|---|---|
| 决策记忆目录不存在 | 首次使用未初始化 | 运行初始化命令创建 ./decision-making/ 目录结构与文件 |
| 框架与决策不匹配 | 选择了不适合当前决策的框架 | 先通过澄清问题理解决策上下文,再选择优秀匹配框架 |
| 从单一决策推断偏好 | 单个数据点不代表模式 | 等待3次一致信号后才将模式提升到HOT层 |
输入: 用户说"我正在纠结是先做性能优化还是先做新功能,帮我分析一下"
执行过程:
[加载HOT层: memory.md]
[检测到领域: product.md (产品决策)]
# ...
决策分析:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ...
选项A: 先做性能优化
优点: 提升用户体验留存、减少客诉、技术债务降低
缺点: 新功能延迟、短期增长放缓
风险: 低(可逆)
# ...
选项B: 先做新功能
优点: 增加获客渠道、满足已反馈用户、短期增长
缺点: 性能问题加剧、技术债务增加
风险: 中(性能恶化可能不可逆)
# ...
置信度: 中 — 假设当前性能问题尚未达到临界点
# ...
建议: 基于你的历史偏好,选项A更符合你的决策模式.
但最终选择取决于你对短期增长与技术健康的权衡.
后续操作: 记录决策到 decisions/2026-07-21-perf-vs-feature.md.
Q1:系统会替我做决定吗?
不会。系统永远不会替用户做最终决策。分析和框架是系统提供的,选择始终是用户的。系统呈现选项而非指令,使用"你可以考虑"而非"你应该".
Q2:系统怎么学习我的决策偏好?
通过识别决策信号自动学习。当你说"我宁愿等更多数据"时,系统识别为风险厌恶信号并记录到memory.md。信号观察3次一致后提升为HOT层模式,在后续决策中应用.
Q3:系统需要网络连接吗?
不需要。系统完全在本地运行,不做网络请求,不访问外部系统。所有决策记忆存储在本地 ./decision-making/ 目录中。无需凭证,无需额外依赖.
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
需要配置对应API Key,详见上文环境配置章节
API Key配置方式:
export API_KEY=${API_KEY:?请设置环境变量}
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
./decision-making/ 目录.升级到自主决策代理专业版即可解锁以下高级能力:
专业版适合需要持续决策支持、多领域决策管理、或希望系统主动识别决策时机的团队和高级用户使用.