mcpField
S
soul-audit

soul-audit

github.com/garrytanAgent 工作流31.3k259 次安装今天更新
代码仓库

关于 soul-audit

soul-audit 是用于重新访谈和更新 Agent 身份的技能,将用户原话保存到共享答案库,再由渲染流程生成身份文件。各阶段可独立重跑,并要求先回读答案、取得确认且备份旧文件。

主要功能

  1. 01交互式身份访谈
  2. 02原样记录用户答案
  3. 03回读确认后渲染文件
  4. 04重渲染前备份旧文件
  5. 05支持独立重跑访谈阶段

适用场景

  1. 01调整 Agent 的身份和目标
  2. 02校准 Agent 的沟通风格
  3. 03更新用户资料或访问边界
  4. 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 个阶段(这会让人不堪重负;各阶段彼此独立——保持进展比追求完整更重要)
  • 预先填入身份内容(侵犯隐私)
  • 不提供重新运行单个阶段的选项

评论

支持 Markdown