在你的 CLAUDE.md 中引用 DA 身份文件
【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS
@LIFEOS/USER/DA/{name}/identity.md
`@` 导入机制会让模型在**每次会话启动时**读取该文件,从而加载 DA 的完整身份。在当前的安装模板中,实际引用路径为 [CLAUDE.template.md](https://link.gitcode.com/i/cbbabdc35e73c19d2cad4d755369fba1) 中的: ```markdown @LIFEOS/USER/DIGITAL_ASSISTANT/DA_IDENTITY.md说明:
_example/README.md中的@LIFEOS/USER/DA/{name}/identity.md是文档对引用范式的抽象表达;仓库当前安装布局将 DA 身份统一放在DIGITAL_ASSISTANT/目录下,文件名为DA_IDENTITY.md,两种写法指向的是同一套“@ 导入加载身份”机制。
三、模板变量:替换占位符即可完成个性化
identity.md中预先放置了三个模板占位符,创建时替换为你的真实值即可:
| 占位符 | 含义 | 示例 |
|---|---|---|
{DA_IDENTITY.NAME} | DA 的名字(短名) | Aria |
{DA_IDENTITY.DISPLAY_NAME} | 显示名(通常为大写,用于标题/标签) | ARIA |
{PRINCIPAL.NAME} | 你的名字(主人/委托人) | Alex |
在DAInterview.ts的实际实现中,displayName由daName.toUpperCase()自动推导,即“显示名 = 名字大写”是默认约定;principalName由用户输入。
四、identity.md 结构深度剖析:frontmatter 与正文各司其职
4.1 YAML frontmatter:机器可读的结构化配置
_example/identity.md的 frontmatter 定义了五个核心配置块,逐块说明如下:
--- provenance: template # DA (Digital Assistant) Identity Configuration # Copy this directory and rename it to create your DA. # Register it in _registry.yaml. id: my-assistant name: "{DA_IDENTITY.NAME}" # DA 短名 display_name: "{DA_IDENTITY.DISPLAY_NAME}" # 大写显示名 color: "#3B82F6" # 品牌色(Tailwind Blue-500) role: primary # 角色:primary | secondary | specialist personality: # 人格 style: "Professional but approachable" traits: - "Direct and clear communication" - "Genuinely curious about problems" - "Prefers action over deliberation" voice: # 语音(TTS) voice_id: "YOUR_TTS_VOICE_ID" enabled: false autonomy: # 自治权边界 can_initiate: # 可主动发起的动作 - send_notification - create_reminder - log_learning must_ask: # 必须先征求同意的动作 - send_external_message - modify_code - delete_data - publish_content ---关键配置块的作用:
core身份块(name / display_name / color / role):color是品牌色,用于界面与标识;role决定 DA 在系统中的职能层级;personality人格块:style一句话概括沟通风格,traits列出具体行为特征;voice语音块:voice_id是 TTS 语音 ID,enabled: false表示默认关闭语音;真实部署中语音 ID 存放在配置(settings.json→daidentity.voices.main),不会硬编码进身份文件;autonomy自治块:这是安全边界的关键。can_initiate列允许 DA 主动执行的动作(通知、提醒、记录学习),must_ask列必须经主人同意才能执行的敏感动作(发外部消息、改代码、删数据、发布内容)。
参考 DA_IDENTITY.md 引导默认值,系统还提供了“如何填写自治边界”的语义示范——must_ask: [send, spend, deploy, delete, merge],即发送、消费、部署、删除、合并五类高风险动作必须征询。而DAInterview.ts生成器会把用户输入的 must-ask 列表逐项写入 frontmatter,并附加cost_ceiling_per_action: 0.10(单动作成本上限)作为经济约束。
4.2 Markdown 正文:模型可读的人格散文
frontmatter 之下的正文部分,是供模型与人类阅读的人格叙事,_example/identity.md提供了四个标准小节:
# DA Identity — {DA_IDENTITY.NAME} ## Personality # DA 如何沟通?语气如何? ## Writing Style # DA 写作应遵循/避免哪些模式? ## Relationship # Principal 是谁?你们如何协作? ## Preferences # DA 在意什么?工作中重视什么?这些小节是 DA 声音(voice)的直接载体。作为参考,DA_IDENTITY.md 中的引导默认值给出了高质量范例——其## Writing Style一节明确要求“每轮执行五条规则:先给答案、用平实词、保持简短、消灭口头禅(不超过两个破折号且闭合)、用第一人称朗读检查”,并禁止“should work”这类未经验证的表述。
更完整的写作纪律沉淀在 WritingStyleBackstop.md:它提供禁用词替换表(如leverage→use、utilize→use、deep dive→close look)、禁用句式清单(对比式口头禅 “not X, it's Y”、三段排比节奏、清嗓子式开头)以及发布前的五项自检步骤。
五、多 DA 支持:primary、secondary 与专业化角色
_example/README.md明确指出 LifeOS 支持多个 DA 身份,通过role字段区分职能:
role: primary:主 DA,承担日常聊天、语音与主要工作流,注册表中primary:字段指向它;role: secondary:次要 DA;- 专用角色(如
worker/specialist):承担特定领域职责,例如worker角色只运行在background渠道,不参与聊天。
注册表通过channels字段控制每个 DA 可访问的通信渠道(terminal、imessage、siri、voice、background 等),实现“一个 DA 一个舞台”的职责隔离。
DAInterview.ts的源码行为与文档一致:首次创建时自动将第一个 DA 设为 primary(isFirst判定),后续创建的 DA 默认 role 为worker、channel 为background;--update模式配合--da <name>参数可更新指定 DA。
六、源码级验证:从模板到手写文件的三条路径
结合仓库源码,创建 DA 身份实际上有三条路径,模板指南对应其中“手写”路径:
路径 A:手写(本指南对应的方式)
复制_example/→ 编辑identity.md→ 注册_registry.yaml→CLAUDE.md@ 引用。适合想完全掌控 DA 细节、或离线创建 DAs 的场景。
路径 B:交互式向导(推荐)
运行 DAInterview.ts 的 CLI 面试向导:
bun ~/.claude/LIFEOS/TOOLS/DAInterview.ts # 快速模式(<2 分钟) bun ~/.claude/LIFEOS/TOOLS/DAInterview.ts --depth standard # 标准模式(<5 分钟) bun ~/.claude/LIFEOS/TOOLS/DAInterview.ts --depth deep # 深度模式(<7 分钟) bun ~/.claude/LIFEOS/TOOLS/DAInterview.ts --update # 更新主 DA bun ~/.claude/LIFEOS/TOOLS/DAInterview.ts --update --da <your-da-name> # 更新指定 DA【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考