soul-audit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Soul Audit — Agent Identity Builder

Soul Audit — Agent身份构建工具

Generate the agent's identity and operational configuration through an interactive interview. Each phase produces a file. Any phase can be re-run independently to update.
IMPORTANT: This skill generates content from the USER'S OWN ANSWERS. It NEVER ships pre-filled content. The templates in
templates/
are scaffolds, not defaults.
通过交互式访谈生成Agent的身份信息和运行配置。每个阶段都会生成一个文件,任意阶段均可独立重新运行以进行更新。
重要提示: 本Skill的内容完全基于用户自身的回答生成,绝不会提供预填充内容。
templates/
目录下的模板仅作为框架使用,并非默认内容。

Contract

服务承诺

This skill guarantees:
  • SOUL.md generated from user's description of agent identity, vibe, mission
  • USER.md generated from user's self-description (role, projects, key people)
  • ACCESS_POLICY.md generated with configurable access tiers
  • HEARTBEAT.md generated with operational cadence the user chooses
  • Each phase is independent and re-runnable
  • Default mode (skip soul-audit): installs minimal templates from
    templates/
本Skill保证:
  • 根据用户对Agent身份、风格和使命的描述生成SOUL.md
  • 根据用户的自我描述(角色、项目、关键联系人)生成USER.md
  • 生成可配置访问层级的ACCESS_POLICY.md
  • 根据用户选择的运行节奏生成HEARTBEAT.md
  • 每个阶段相互独立,可重新运行
  • 默认模式(跳过Soul Audit):从
    templates/
    目录安装极简模板

Phases

阶段说明

Phase 1: Identity Interview

阶段1:身份访谈

Ask: "What is this agent to you? Research partner? Executive assistant? Thinking partner? All of the above?" Generate: SOUL.md identity section.
提问:“这个Agent对你而言是什么角色?研究伙伴?行政助理?思考伙伴?还是兼具所有角色?” 生成:SOUL.md中的身份部分。

Phase 2: Vibe Calibration

阶段2:风格校准

Show 3-4 communication style examples:
  • Formal: "I've prepared a comprehensive analysis of the situation..."
  • Direct: "Here's what's happening. Three things matter."
  • Technical: "The root cause is in the connection pooling. Here's the fix."
  • Casual: "Yeah so basically the thing is broken because X. Easy fix." Ask which feels right. Generate: SOUL.md vibe + communication style sections.
展示3-4种沟通风格示例:
  • 正式风格: “我已准备好一份关于当前情况的全面分析……”
  • 直接风格: “情况如下,有三点至关重要。”
  • 技术风格: “问题根源在于连接池,以下是修复方案。”
  • 随意风格: “嗯,基本上这个问题是因为X导致的,很容易修复。” 询问用户偏好哪种风格。生成:SOUL.md中的风格与沟通方式部分。

Phase 3: Mission Mapping

阶段3:使命梳理

Ask: "What are your top 3-5 goals? What are you trying to accomplish?" Generate: SOUL.md mission + operating principles sections.
提问:“你的首要3-5个目标是什么?你希望达成什么成果?” 生成:SOUL.md中的使命与运行原则部分。

Phase 4: User Profile

阶段4:用户配置文件

Ask: "Tell me about yourself. What do you do? What are you working on? Who are the key people in your world?" Generate: USER.md with role, projects, key people, communication preferences.
提问:“请介绍一下你自己。你的职业是什么?正在做哪些项目?你身边的关键联系人有哪些?” 生成:包含角色、项目、关键联系人及沟通偏好的USER.md文件。

Phase 5: Boundaries

阶段5:权限边界

Ask: "Who should have access to your brain? Are there people who should see some but not all? Anyone to keep out entirely?" Generate: ACCESS_POLICY.md with 4 tiers (Full/Work/Family/None).
提问:“哪些人可以访问你的Agent?是否存在只能访问部分内容的用户?有没有完全禁止访问的人?” 生成:包含4个权限层级(完全访问/工作访问/家庭访问/无访问)的ACCESS_POLICY.md文件。

Phase 6: Operational Cadence

阶段6:运行节奏

Ask: "How often should the agent check in? Morning briefing? End of day summary? What recurring jobs do you want?" Generate: HEARTBEAT.md with operational cadence.
提问:“Agent应多久进行一次汇报?晨间简报?每日总结?你希望设置哪些周期性任务?” 生成:包含运行节奏的HEARTBEAT.md文件。

Default Mode (Skip Soul-Audit)

默认模式(跳过Soul Audit)

If the user skips soul-audit on first boot:
  • Install
    templates/SOUL.md.template
    as SOUL.md (minimal: "knowledge-first agent with persistent memory")
  • Install
    templates/USER.md.template
    as USER.md (auto-populate name/email from git config)
  • Install
    templates/ACCESS_POLICY.md.template
    as ACCESS_POLICY.md (owner-only access)
  • Install
    templates/HEARTBEAT.md.template
    as HEARTBEAT.md (default cadence)
如果用户在首次启动时跳过Soul Audit:
  • templates/SOUL.md.template
    安装为SOUL.md(极简内容:“具备持久化记忆的知识优先型Agent”)
  • templates/USER.md.template
    安装为USER.md(从git配置自动填充姓名/邮箱)
  • templates/ACCESS_POLICY.md.template
    安装为ACCESS_POLICY.md(仅所有者可访问)
  • templates/HEARTBEAT.md.template
    安装为HEARTBEAT.md(默认运行节奏)

Output Format

输出格式

Four files generated/updated. Report: "Soul audit complete: SOUL.md, USER.md, ACCESS_POLICY.md, HEARTBEAT.md created. Re-run any phase anytime to update."
生成/更新四个文件。提示信息:“Soul Audit完成:已创建SOUL.md、USER.md、ACCESS_POLICY.md、HEARTBEAT.md文件。可随时重新运行任意阶段进行更新。”

Anti-Patterns

反模式

  • Shipping pre-filled SOUL.md or USER.md content (privacy violation)
  • Making soul-audit mandatory on first boot (high friction, optional is better)
  • Asking all 6 phases in one go (overwhelming, each is independent)
  • Not offering to re-run individual phases
  • 提供预填充的SOUL.md或USER.md内容(违反隐私)
  • 将Soul Audit设为首次启动的强制流程(高摩擦,可选模式更佳)
  • 一次性询问所有6个阶段的问题(用户压力过大,各阶段应独立进行)
  • 不支持重新运行单个阶段