关于 soul-audit
soul-audit 是用于重新访谈和更新 Agent 身份的技能,将用户原话保存到共享答案库,再由渲染流程生成身份文件。各阶段可独立重跑,并要求先回读答案、取得确认且备份旧文件。
主要功能
- 01交互式身份访谈
- 02原样记录用户答案
- 03回读确认后渲染文件
- 04重渲染前备份旧文件
- 05支持独立重跑访谈阶段
适用场景
- 01调整 Agent 的身份和目标
- 02校准 Agent 的沟通风格
- 03更新用户资料或访问边界
- 04调整定期检查安排
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ garrytan/ gbrain --skill soul-audit安装后在 Claude Code 中输入/soul-audit确认已加载。
详细介绍
Soul Audit — Agent 身份构建器(重新运行 / 深入完善表层)
在引导初始化完成后的任意时间,通过互动访谈更新 Agent 的身份。此技能不会从头生成文件,也不会自行撰写身份介绍:它会将用户的回答记录到共享答案库,然后由引导初始化渲染引擎生成文件。这样无论答案由哪个入口(首次启动引导初始化、此技能或未来的重新审核)收集,都始终只有一个真实来源——state/interview.json。
重要: 内容来自用户自己的回答,并按原样记录。 绝不要编造、润饰或默认填写身份答案。渲染门会以结构化方式拒绝执行,直到必需答案齐全,并已读回给用户且由用户确认。
约定
此技能保证:
- 通过
gbrain bootstrap interview --set KEY "value"将回答写入共享答案库 (每个答案逐字记录为一个键;--skip KEY会记录为明确拒答)。 - 任何渲染操作之前都会执行读回流程:通过
--show显示完整答案集, 将其复述给用户,然后使用--status打印的哈希值运行--confirm <hash>。 如果用户从未看过该答案集,确认操作会按设计失败。 - 文件会通过唯一的渲染路径重新渲染:
gbrain bootstrap render --only SOUL.md --force(每个文件重复执行)。--force会先将旧文件备份到.gbrain-bootstrap-backups/<ts>/下——不会在没有可恢复副本的情况下覆盖任何文件。 - 每个阶段彼此独立,且可重复运行;更新一个答案并重新渲染一个文件,就是一次完整且有效的运行。
命令循环
gbrain bootstrap interview --show # what the bank holds now (start here)
gbrain bootstrap interview --set KEY "..." # record one updated answer, verbatim
gbrain bootstrap interview --skip KEY # explicit decline for an optional key
gbrain bootstrap interview --status # gate + read-back hash
gbrain bootstrap interview --confirm <hash> # after reading answers back to the user
gbrain bootstrap render --only SOUL.md --force
渲染目标:SOUL.md、USER.md、ACCESS_POLICY.md、HEARTBEAT.md、
AGENTS.md(重新渲染受已更改键影响的文件)。在 OpenClaw 工作区中,
HEARTBEAT.md 目标会写入 SCHEDULES.md,因为 OpenClaw 2026.10.6+ 会移除工作区中的
HEARTBEAT.md;渲染操作会检测工作区,也可以传入 --host openclaw。
阶段(各阶段彼此独立,均可重复运行)
阶段 1:身份访谈
提问:“对你而言,这个 Agent 是什么?研究伙伴?行政助理?思考伙伴?还是兼而有之?”
键:AGENT_NAME、AGENT_PURPOSE、SOUL_RELATIONSHIP。渲染:SOUL.md。
阶段 2:风格校准
展示 3–4 个沟通风格示例:
- 正式:“我已针对当前情况准备了一份全面分析……”
- 直接:“事情是这样的。有三点很重要。”
- 技术:“根本原因在于连接池。解决方法如下。”
- 随意:“嗯,简单来说就是 X 出问题了。很好修。”
询问用户觉得哪种风格合适;同时询问有没有哪种回复让他们皱眉,以及原因。
键:
VOICE_REGISTER、SOUL_WINCE、SOUL_MODE_DEFAULT。渲染:SOUL.md。
阶段 3:使命规划
提问:“你最重要的 3–5 个目标是什么?你想实现什么?”
键:AGENT_TOP_JOBS、SOUL_GOOD_OUTPUT、SOUL_WORLDVIEW。渲染:SOUL.md、
AGENTS.md。
阶段 4:用户资料
提问:“介绍一下你自己。你做什么工作?正在忙什么?你生活中的重要人物有哪些?”
键:PRINCIPAL_NAME、PRINCIPAL_CONTEXT、PRINCIPAL_TIMEZONE。渲染:
USER.md。
阶段 5:边界
提问:“谁应该能访问你的大脑?有没有人只能查看部分内容,而非全部?有没有人应该完全无法访问?”
键:ACCESS_TIERS(并检查常设披露部分)。渲染:ACCESS_POLICY.md。
阶段 6:运作节奏
提问:“Agent 应该多久跟进一次?需要早间简报吗?需要每日总结吗?
你希望安排哪些周期性任务?”
键:HEARTBEAT_CADENCE、QUIET_HOURS。渲染:HEARTBEAT.md(OpenClaw 上为 SCHEDULES.md)。
任务默认处于禁用状态——手动试运行后再逐个启用(相关流程写在
渲染生成的文件中)。
如果答案库尚不存在(即工作区从未运行过引导初始化),请先运行
gbrain bootstrap interview --init;该命令会打印完整的问题列表。
输出格式
准确报告发生的变更:哪些键已更新、哪些文件已重新渲染,以及备份保存在哪里。示例:“Soul 审计:已更新 VOICE_REGISTER + SOUL_WINCE,已重新渲染 SOUL.md(备份位于 .gbrain-bootstrap-backups/...)。 可随时重新运行任意阶段。”
失败时的处理方式
对于任何 gbrain 错误 code、退出代码、[AGENT] 块或 notice 块,请遵循Agent 操作员协议。此技能的具体要求:
- 如果
gbrain bootstrap interview --confirm <hash>失败:该哈希必须来自用户实际看过的回读内容。重新运行gbrain bootstrap interview --status,向用户回读答案,并且只有在用户同意后才能确认。 - 如果由于缺少必填答案而拒绝渲染:向用户询问这些答案;绝不能自行填写身份相关答案。
反面模式
- 自行撰写身份相关文案,而不是将用户的话记录到答案库中(这些文件只能由渲染引擎编写)
- 直接手动编辑 SOUL.md/USER.md——下次渲染时会被覆盖;应编辑答案,然后重新渲染
- 确认用户从未看过的回读哈希
- 将审计设为强制步骤,或一次性询问全部 6 个阶段(这会让人不堪重负;各阶段彼此独立——保持进展比追求完整更重要)
- 预先填入身份内容(侵犯隐私)
- 不提供重新运行单个阶段的选项