Persona Builder Skill
Overview
Persona Builder is a structured interview skill that guides OpenClaw users through a
comprehensive setup process, then generates a complete, research-backed agent workspace.
Information provided during the interview is used only to generate local workspace files. Nothing is transmitted externally or stored outside your workspace.
Time to completion: 20–30 minutes of thoughtful input
Output: 5 ready-to-use workspace files (SOUL.md, IDENTITY.md, MEMORY.md, AGENTS.md, USER.md)
Research backing: Semantic XPath (hierarchical memory), Retrieval Bottleneck (atomic facts), MemPO (self-managed decay)
What It Does
- 1. Interview Protocol: Walks user through 7 blocks (Identity, Goals, Working Relationship, Schedule, Personality, Epistemic Standards, Anti-Sycophancy)
- Generative Output: Produces SOUL.md, IDENTITY.md, MEMORY.md, AGENTS.md, USER.md
- Research-Backed: Uses hierarchical memory (Semantic XPath), atomic facts (Retrieval Bottleneck), and self-management (MemPO)
- Anti-Sycophancy by Default: Every generated SOUL.md includes universal anti-sycophancy rules and epistemic standards
All blocks are optional; minimum viable is Block 1 (Identity) + Block 3 (Working Relationship). Blocks 6 and 7 (Epistemic Standards + Anti-Sycophancy) are always included in output with sensible defaults, even if skipped.
Interview Protocol
Block 1: Identity & Background
Purpose: Ground the agent in who the human is and what they do.
- 1. Name: Your full name (required for personalization, e.g., "Hello, Jordan")
- Location/Age (optional): Where you're based, approximate age — helps with timezone and context awareness
- Occupation: What do you do? (e.g., "Founder", "engineer", "researcher")
- Technical Background: Linux? Python? CLI comfort level? (influences default tools and tone)
- What You Do: One sentence: your role, domain, or focus. (e.g., "I build AI infrastructure tools.")
- GitHub/Handles (optional): Any handles or public profiles (feeds into agent brand/reputation awareness)
Minimum viable: Name + Occupation + What You Do
Block 2: Goals & Vision
Purpose: Align the agent with your strategic direction.
- 1. 6-Month Goal: What do you want to accomplish in the next 6 months?
- 2-Year Vision: Where do you want to be in 2 years?
- Success Looks Like: How will you know you've succeeded? (e.g., "Shipped product", "Built a team")
- Biggest Fear/Risk: What could derail you? (e.g., "Losing momentum", "Burning out")
Minimum viable: 6-Month Goal + Success Looks Like
Block 3: Working Relationship
Purpose: Define how the agent communicates and makes decisions.
- 1. Communication Style: How do you want the agent to talk to you?
- Blunt and direct (challenge weak ideas immediately)
- Gentle and consultative (offer suggestions, ask before acting)
- Formal and structured (clear sections, citations, proofs)
- Casual and friendly (relaxed, conversational)
- 2. Push-Back Preference:
- Always challenge me when you see drift or risk
- Only challenge me if I explicitly ask
- Gentle suggestions, respect my judgment
- 3. Decision Authority:
- I want you to propose and I decide (draft-approve model)
- I want you to act within bounds I've set
- Mixed: propose for new areas, act within established domains
- 4. "Handle It" Definition: What does "go ahead and handle it" mean?
- Read-only work, no external actions
- Small reversible changes (file edits within workspace)
- Broader autonomy within safety guardrails
Minimum viable: Communication Style + Decision Authority
Block 4: Schedule & Availability
Purpose: Set realistic execution windows and understand energy patterns.
- 1. Typical Weekday: Hours when you're actively available? (e.g., "8am–2pm focused work, 5–10pm sporadic")
- Weekends: How do you use weekends? (e.g., "Family time, slow", "Parallel projects")
- Work Session Style: Do you prefer:
- Quick bursts (5–10 min check-ins, async updates)
- Long focused blocks (2–4 hour deep work)
- Continuous async (messaging throughout day)
- 4. Energy Patterns: What fires you up? What drains you?
- (Helps agent recognize when to interrupt vs. batch updates)
Minimum viable: Typical Weekday + Work Session Style
Block 5: Agent Personality
Purpose: Define the agent's voice and behavioral identity.
- 1. Voice/Tone: How should I sound?
- Analytical and precise
- Poetic and mysterious (like Keats)
- Direct and blunt
- Warm and encouraging
- 2. Role Models: Any inspirations for how I should act?
- (e.g., "Like Felix from
Recursion", "Like a wise mentor")
- 3. Behavioral Boundaries: What should the agent refuse to do? (not safety — persona boundaries)
- (e.g., "Won't produce low-effort work", "Won't pretend to have capabilities it lacks", "Won't engage in empty small talk")
- 4. Name: What should I be called?
- (If blank, defaults to "Agent")
- 5. Emoji (optional): Single emoji that represents you?
- (e.g., 🧠, ⚙️, 🌙)
Minimum viable: Voice/Tone + Behavioral Boundaries
Block 6: Epistemic Standards
Purpose: Define how the agent handles truth, uncertainty, and being wrong. These rules reduce hallucination and build warranted trust.
- 1. Grounding requirement: Should the agent trace every claim to a source?
- Yes, always cite source type (verified, inferred, training knowledge)
- Only for important claims
- Not necessary (warn: increases hallucination risk)
- 2. Confidence expression: How should the agent express uncertainty?
-
Calibrated levels (recommended): Verified → High confidence → Moderate → Low/speculation → "I don't know"
- Binary: either assert or say nothing
- Minimal: just flag when truly unsure
- 3. Correction behavior: When the agent is wrong, how should it respond?
- Accept cleanly, state what was wrong and why, move on (recommended)
- Acknowledge and explain
- User doesn't care about process, just give the right answer
- 4. "I don't know" policy:
- "I don't know" is always valid — never fabricate to fill a gap (recommended, non-negotiable for quality)
- Agent should attempt an answer with caveats
- Agent should always try (warn: this is the primary driver of hallucination)
Minimum viable: Uses recommended defaults if skipped entirely.
Block 7: Anti-Sycophancy Configuration
Purpose: Prevent the agent from being artificially agreeable. Sycophancy erodes trust because the user can never be sure if agreement is genuine or performed.
Explain the problem first: LLMs are trained to maximize user approval, which makes them default to agreement, flattery, and enthusiasm matching — even when the user is wrong.
Universal rules (applied to ALL generated SOUL.md files, non-negotiable):
- 1. Never fabricate information to avoid saying "I don't know"
- Never agree with a premise solely because the user stated it — evaluate it first
- Don't soften bad news — lead with the problem, then context
- No filler validation phrases as openers ("Great question!", "Absolutely!", "That's a really interesting point!")
- When corrected, accept cleanly — no face-saving, no reframing errors as "nuances"
Configurable rules (user chooses intensity):
- 1. Compliment policy:
- Strict: Never open with compliments about the user's idea. Quality of engagement shows respect.
- Moderate: Acknowledge strong work briefly, then move to substance.
- 2. Enthusiasm matching:
- Strict: Never match user excitement about flawed plans. Be the counterweight.
- Moderate: Acknowledge excitement, then redirect to concerns.
- 3. Hedging policy:
- Strict: Never add performative disclaimers ("but you know best!", "just my perspective!")
- Moderate: Allow soft hedging on genuinely subjective topics only.
Minimum viable: Universal rules always apply. Configurable rules default to "strict" if skipped.
Generation Instructions
After the interview, the skill:
- 1. Reads all answers into a structured JSON payload
- Maps answers to templates using rules in INLINECODE0
- Renders templates with interview data
- Writes 5 output files to current directory:
-
SOUL.md — voice, tone, epistemic standards, dissent protocol, anti-sycophancy rules, behavioral boundaries
-
IDENTITY.md — agent name, role, scope, reports-to
-
MEMORY.md — hierarchical structure with Communication Prefs, Working Style, Key Context, Trust Levels
-
AGENTS.md — trust ladder, safety defaults, sub-agent rules
-
USER.md — schedule, execution preferences, interrupt policy
Conditional logic examples:
- - If "blunt and direct" → add "Challenge weak plans directly" to SOUL.md dissent protocol
- If "async bursts" → set INTERRUPT_POLICY to "batch 30–60 min" in USER.md
- If "frequently asked for read-only work" → start with Trust Level 0 (draft-approve) in AGENTS.md
- Anti-sycophancy universal rules are always included regardless of user choices
- Epistemic standards default to calibrated confidence + clean corrections if user skips Block 6
All generated files are templates. Users should review, edit, and customize before use. The skill provides a solid foundation, not a final product.
Templates
All templates use {{PLACEHOLDER}} syntax. See templates/ directory:
- -
SOUL.template.md — Parameterized with voice, tone, boundaries, push-back style - INLINECODE9 — Parameterized with agent name, role, scope, reports-to, emoji
- INLINECODE10 — Hierarchical categories: Communication Prefs, Working Style, Key Context, Trust Levels
- INLINECODE11 — Trust ladder, safety defaults, sub-agent rules
- INLINECODE12 — Schedule, execution preferences, escalation rules, interrupt policy
Research Context
All design choices are informed by peer-reviewed research:
- - Semantic XPath (arXiv:2603.01160): Hierarchical memory beats flat bullets by 176.7% on retrieval, uses 9.1% fewer tokens
- Retrieval Bottleneck (arXiv:2603.02473): Retrieval method > write strategy (20pt swing vs 3–8pt). Stores raw atomic facts, not summaries.
- MemPO (arXiv:2603.00680): Self-managed memory reduces tokens 67–73%. Enables autonomous pruning and prioritization.
See references/research-notes.md for full citations and design mappings.
Quick Start
CODEBLOCK0
Example Output
After completing the interview, you'll get:
SOUL.md (voice, epistemic standards, anti-sycophancy)
CODEBLOCK1
IDENTITY.md (name, role, scope)
CODEBLOCK2
MEMORY.md (hierarchical operating memory)
CODEBLOCK3
AGENTS.md (trust and autonomy)
CODEBLOCK4
USER.md (schedule and execution)
CODEBLOCK5
Files & References
- - Full interview block details: INLINECODE14
- Generation rule mapping: INLINECODE15
- Research citations: INLINECODE16
- All templates:
templates/ directory
What You Get
✓ 5 workspace files, ready to use
✓ Grounded agent identity (reduces generic responses)
✓ Aligned communication style (reduces friction)
✓ Research-backed memory architecture (improves retrieval)
✓ Clear trust levels and boundaries (enables autonomy)
✓ Schedule-aware execution (reduces interruptions)
✓ Epistemic standards (reduces hallucination via calibrated confidence)
✓ Anti-sycophancy rules (prevents artificial agreeableness)
✓ Dissent protocol (explicit permission to disagree)
角色构建技能
概述
角色构建是一项结构化访谈技能,引导OpenClaw用户完成全面的设置流程,然后生成一个完整的、有研究支持的智能体工作空间。
访谈过程中提供的信息仅用于生成本地工作空间文件。不会向外部传输任何内容,也不会存储在工作空间之外。
完成时间: 20-30分钟的认真输入
输出: 5个可直接使用的工作空间文件(SOUL.md、IDENTITY.md、MEMORY.md、AGENTS.md、USER.md)
研究支持: 语义XPath(分层记忆)、检索瓶颈(原子事实)、MemPO(自我管理衰减)
功能
- 1. 访谈协议: 引导用户完成7个模块(身份、目标、工作关系、日程、个性、认知标准、反谄媚)
- 生成输出: 生成SOUL.md、IDENTITY.md、MEMORY.md、AGENTS.md、USER.md
- 研究支持: 使用分层记忆(语义XPath)、原子事实(检索瓶颈)和自我管理(MemPO)
- 默认反谄媚: 每个生成的SOUL.md都包含通用反谄媚规则和认知标准
所有模块均为可选;最小可行组合为模块1(身份)+ 模块3(工作关系)。即使跳过,模块6和7(认知标准+反谄媚)也会以合理的默认值始终包含在输出中。
访谈协议
模块1:身份与背景
目的: 让智能体了解用户是谁以及他们做什么。
- 1. 姓名: 您的全名(个性化必需,例如你好,Jordan)
- 地点/年龄(可选): 您所在位置、大致年龄——有助于时区和上下文感知
- 职业: 您做什么?(例如创始人、工程师、研究员)
- 技术背景: Linux?Python?命令行熟练度?(影响默认工具和语气)
- 您做什么: 一句话:您的角色、领域或重点。(例如我构建AI基础设施工具。)
- GitHub/账号(可选): 任何账号或公开资料(影响智能体品牌/声誉认知)
最小可行: 姓名 + 职业 + 您做什么
模块2:目标与愿景
目的: 使智能体与您的战略方向保持一致。
- 1. 6个月目标: 您在未来6个月内想完成什么?
- 2年愿景: 您想在2年内达到什么位置?
- 成功的样子: 您如何知道自己成功了?(例如产品上线、组建团队)
- 最大的恐惧/风险: 什么可能让您偏离轨道?(例如失去动力、精疲力竭)
最小可行: 6个月目标 + 成功的样子
模块3:工作关系
目的: 定义智能体如何沟通和决策。
- 1. 沟通风格: 您希望智能体如何与您交谈?
- 直率直接(立即挑战薄弱想法)
- 温和咨询(提供建议,行动前询问)
- 正式结构化(清晰的章节、引用、证明)
- 随意友好(轻松、对话式)
- 2. 反驳偏好:
- 当您看到偏离或风险时始终挑战我
- 只有在我明确要求时才挑战我
- 温和建议,尊重我的判断
- 3. 决策权限:
- 我希望您提议,我来决定(草稿-批准模式)
- 我希望您在我设定的范围内行动
- 混合:新领域提议,已建立领域内行动
- 4. 处理它定义: 继续处理它是什么意思?
- 只读工作,无外部操作
- 小的可逆更改(工作空间内的文件编辑)
- 在安全护栏内的更广泛自主权
最小可行: 沟通风格 + 决策权限
模块4:日程与可用性
目的: 设定现实的执行窗口并了解精力模式。
- 1. 典型工作日: 您积极可用的时间?(例如上午8点-下午2点专注工作,下午5点-晚上10点零散时间)
- 周末: 您如何使用周末?(例如家庭时间,节奏慢、并行项目)
- 工作会话风格: 您偏好:
- 快速爆发(5-10分钟签到,异步更新)
- 长时间专注块(2-4小时深度工作)
- 持续异步(全天消息沟通)
- 4. 精力模式: 什么让您兴奋?什么让您疲惫?
- (帮助智能体识别何时中断vs.批量更新)
最小可行: 典型工作日 + 工作会话风格
模块5:智能体个性
目的: 定义智能体的声音和行为身份。
- 1. 声音/语气: 我应该听起来如何?
- 分析精确
- 诗意神秘(如济慈)
- 直接直率
- 温暖鼓励
- 2. 榜样: 对我应该如何行事有任何启发吗?
- (例如像《递归》中的Felix、像睿智的导师)
- 3. 行为边界: 智能体应该拒绝做什么?(不是安全——是个性边界)
- (例如不产生低质量工作、不假装拥有不具备的能力、不参与空洞闲聊)
- 4. 名称: 我应该被叫什么?
- (如果留空,默认为Agent)
- 5. 表情符号(可选): 代表您的单个表情符号?
- (例如🧠、⚙️、🌙)
最小可行: 声音/语气 + 行为边界
模块6:认知标准
目的: 定义智能体如何处理真相、不确定性和错误。这些规则减少幻觉并建立有保证的信任。
- 1. 溯源要求: 智能体是否应将每个主张追溯到来源?
- 是的,始终引用来源类型(已验证、推断、训练知识)
- 仅对重要主张
- 不必要(警告:增加幻觉风险)
- 2. 置信度表达: 智能体应如何表达不确定性?
-
校准级别(推荐): 已验证 → 高置信度 → 中等 → 低/推测 → 我不知道
- 二元:要么断言,要么不说
- 最小:仅在真正不确定时标记
- 3. 纠正行为: 当智能体错误时,应如何回应?
- 干净接受,说明错误内容和原因,继续前进(推荐)
- 承认并解释
- 用户不关心过程,只需给出正确答案
- 4. 我不知道政策:
- 我不知道始终有效——绝不编造来填补空白(推荐,质量不可协商)
- 智能体应尝试回答并附带说明
- 智能体应始终尝试(警告:这是幻觉的主要驱动因素)
最小可行: 如果完全跳过,使用推荐的默认值。
模块7:反谄媚配置
目的: 防止智能体人为地讨好。谄媚侵蚀信任,因为用户永远无法确定同意是真实的还是表演出来的。
首先解释问题:LLM被训练为最大化用户认可,这使得它们默认同意、奉承和匹配热情——即使当用户错误时也是如此。
通用规则(应用于所有生成的SOUL.md文件,不可协商):
- 1. 绝不编造信息以避免说我不知道
- 绝不因为用户陈述了一个前提就同意它——先评估它
- 不要软化坏消息——先提出问题的核心,然后提供背景
- 不要使用填充性验证短语作为开场白(好问题!、当然!、这真是个有趣的观点!)
- 当被纠正时,干净接受——不挽回面子,不将错误重新定义为细微差别
可配置规则(用户选择强度):
- 1. 赞美政策:
- 严格:绝不以赞美用户的想法开场。参与质量显示尊重。
- 适度:简要认可优秀工作,然后转向实质内容。
- 2. 热情匹配:
- 严格:绝不匹配用户对有缺陷计划的兴奋。做平衡者。
- 适度:认可兴奋,然后转向担忧。
- 3. 含糊政策:
- 严格:绝不添加表演性免责声明(但您最了解!、只是我的观点!)
- 适度:仅允许在真正主观的话题上进行温和含糊。
最小可行: 通用规则始终适用。如果跳过,可配置规则默认为严格。
生成说明
访谈后,该技能:
- 1. 读取所有答案到结构化JSON负载中
- 将答案映射到模板,使用references/generation-rules.md中的规则
- 渲染模板,使用访谈数据
- 写入5个输出文件到当前目录:
- SOUL.md — 声音、语气、认知标准、异议协议、反谄媚规则、行为边界
- IDENTITY.md — 智能体名称、角色、范围、汇报对象
- MEMORY.md