在你的 CLAUDE.md 中引用 DA 身份文件
2026/9/15 1:12:28 网站建设 项目流程

在你的 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的实际实现中,displayNamedaName.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.jsondaidentity.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:它提供禁用词替换表(如leverageuseutilizeusedeep diveclose 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.yamlCLAUDE.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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询