第四章:DNA 模板系统

第四章:DNA 模板系统

🧬 本章详细介绍 MiniClaw 的 DNA 模板系统,这是智能体的"基因"定义。


4.1 DNA 系统概述

4.1.1 什么是 DNA 系统?

DNA 系统是 MiniClaw 的核心创新之一,它将智能体的"基因"——性格、规则、身份、记忆——定义为可读、可写的 Markdown 文件。

┌─────────────────────────────────────────────────────────────────────┐
│                      DNA 系统设计理念                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│    传统 AI 助手                      MiniClaw DNA 系统              │
│    ┌───────────────────┐             ┌───────────────────┐         │
│    │                   │             │                   │         │
│    │   硬编码行为规则   │             │   Markdown 文件   │         │
│    │   静态配置        │             │   动态可进化       │         │
│    │   不可修改        │             │   Agent 可读写     │         │
│    │                   │             │                   │         │
│    └───────────────────┘             └───────────────────┘         │
│                                                                     │
│    ❌ 难以定制                        ✅ 灵活可定制                 │
│    ❌ 无法进化                        ✅ 自动进化                   │
│    ❌ 黑盒配置                        ✅ 透明可见                   │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.1.2 DNA 文件清单

┌─────────────────────────────────────────────────────────────────────┐
│                       DNA 文件清单                                   │
├───────────────┬─────────────────┬───────────────────────────────────┤
│    文件名     │      类比       │              功能                  │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  AGENTS.md    │ 📜 宪法/章程    │ 工作空间规则、工作流程、进化协议  │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  SOUL.md      │ 🧠 灵魂/三观    │ 性格、价值观、行为准则            │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  IDENTITY.md  │ 🪪 身份证       │ 名称、图标、元数据                │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  USER.md      │ 👤 用户画像     │ 用户偏好、习惯、反模式            │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  TOOLS.md     │ 🔧 工具箱       │ 环境配置、路径、参数              │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  MEMORY.md    │ 💾 长期记忆     │ 蒸馏后的高价值事实                │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  HEARTBEAT.md │ 💓 心跳检查     │ 周期性检查项                      │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  BOOTSTRAP.md │ 👶 出生协议     │ 首次运行引导                      │
├───────────────┼─────────────────┼───────────────────────────────────┤
│  SUBAGENT.md  │ 🤖 子代理定义   │ 子代理上下文                      │
└───────────────┴─────────────────┴───────────────────────────────────┘

4.1.3 DNA 文件加载优先级

┌─────────────────────────────────────────────────────────────────────┐
│                    DNA 文件加载优先级                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│    Priority 10 (最高)                                               │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  IDENTITY.md  → 身份核心,定义"我是谁"                       │ │
│    │  ACE Time Mode → 时间模式感知                               │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 9                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  SOUL.md      → 灵魂核心,定义"我是什么样的人"               │ │
│    │  AGENTS.md    → 工作空间章程,定义"我如何工作"               │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 8                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  USER.md      → 用户画像,定义"我在帮助谁"                   │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 7                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  MEMORY.md    → 长期记忆,定义"我记得什么"                   │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 6                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  Workspace    → 工作空间感知                                │ │
│    │  TOOLS.md     → 环境配置                                    │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 5                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  Skills       → 技能定义                                    │ │
│    │  Entities     → 实体知识图谱                                │ │
│    │  Runtime      → 运行时信息                                  │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 4                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  HEARTBEAT.md → 心跳检查项                                  │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 3                                                       │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  Daily log    → 今日日志                                    │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
│    Priority 2 (最低)                                                │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │  BOOTSTRAP.md → 首次运行引导                                │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2 核心模板详解

4.2.1 AGENTS.md - 工作空间章程

┌─────────────────────────────────────────────────────────────────────┐
│                      AGENTS.md 结构                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Core Charter. Defines operational baselines..."          │
│  read_when:                                                         │
│    - Bootstrapping a workspace manually                             │
│  ---                                                                │
│                                                                     │
│  # AGENTS.md - Your Workspace                                       │
│                                                                     │
│  ## Every Session                                                   │
│  ├── 读取 SOUL.md, IDENTITY.md, USER.md, TOOLS.md                  │
│  ├── 读取 memory/YYYY-MM-DD.md (今日+昨日)                         │
│  └── 主会话时读取 MEMORY.md                                         │
│                                                                     │
│  ## Memory                                                          │
│  ├── Daily notes: memory/YYYY-MM-DD.md                             │
│  ├── Long-term: MEMORY.md                                          │
│  └── 安全规则:MEMORY.md 仅在主会话加载                            │
│                                                                     │
│  ## 🧬 Auto-Evolution Protocol                                      │
│  ├── 信号检测表                                                     │
│  ├── 执行规则                                                       │
│  └── 工具选择                                                       │
│                                                                     │
│  ## 💓 Heartbeats                                                   │
│  └── 心跳检查项                                                     │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

自动进化协议

┌─────────────────────────────────────────────────────────────────────┐
│                    自动进化协议信号检测表                            │
├─────────────────────────────┬───────────────┬───────────────────────┤
│         检测信号            │   目标文件    │         动作          │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 用户表达偏好                │ USER.md       │ 追加/更新偏好         │
│ ("我喜欢...", "别用...")    │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 用户纠正性格                │ SOUL.md       │ 调整性格              │
│ ("别那么正式", "放松点")    │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 发现环境配置                │ TOOLS.md      │ 记录参数              │
│ (路径、工具版本、API位置)   │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 用户请求启动检查            │ HEARTBEAT.md  │ 添加检查项            │
│ ("每次都检查这个")          │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 学习重要长期事实            │ MEMORY.md     │ 追加到记忆库          │
│ ("项目用 pnpm")             │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 用户更改 Agent 身份         │ IDENTITY.md   │ 更新身份              │
│ ("叫自己...")               │               │                       │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 发现新工作流或最佳实践      │ AGENTS.md     │ 添加到章程            │
├─────────────────────────────┼───────────────┼───────────────────────┤
│ 任何值得记录的对话          │ memory/TODAY  │ 调用 miniclaw_note    │
└─────────────────────────────┴───────────────┴───────────────────────┘

执行规则

┌─────────────────────────────────────────────────────────────────────┐
│                      自动进化执行规则                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  1️⃣ 立即执行 (Immediate)                                            │
│     检测到信号后,在当前响应中调用工具                              │
│     不要等待用户指示                                                │
│                                                                     │
│  2️⃣ 静默更新 (Silent)                                               │
│     更新后不通知用户                                                │
│     除非用户明确问"你记住了什么?"                                  │
│                                                                     │
│  3️⃣ 幂等性 (Idempotent)                                             │
│     如果信息已存在,不重复添加                                      │
│                                                                     │
│  4️⃣ 日志优先 (Daily log first)                                      │
│     不确定时,先用 miniclaw_note                                    │
│     后续通过 miniclaw_growup 蒸馏                                   │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.2 SOUL.md - 灵魂/三观

┌─────────────────────────────────────────────────────────────────────┐
│                       SOUL.md 结构                                   │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Personality Core. Defines tone, values, and reply..."   │
│  read_when:                                                         │
│    - Bootstrapping a workspace manually                             │
│  ---                                                                │
│                                                                     │
│  # SOUL.md - Who You Are                                            │
│                                                                     │
│  ## Core Truths                                                     │
│  ├── 真诚帮助,不做表演式帮助                                       │
│  ├── 有主见,可以不同意                                             │
│  ├── 先尝试自己解决,再提问                                         │
│  ├── 通过能力赢得信任                                               │
│  └── 记住自己是客人                                                 │
│                                                                     │
│  ## Boundaries                                                      │
│  ├── 私密的事情保持私密                                             │
│  ├── 外部行动前先确认                                               │
│  ├── 不发送半成品消息                                               │
│  └── 群聊中谨慎发言                                                 │
│                                                                     │
│  ## Vibe                                                            │
│  └── 做你自己想交流的助手                                           │
│                                                                     │
│  ## Continuity                                                      │
│  └── 这些文件就是你的记忆                                           │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

核心价值观

┌─────────────────────────────────────────────────────────────────────┐
│                       SOUL.md 核心价值观                             │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  💎 Be genuinely helpful, not performatively helpful                │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  ❌ "Great question!" "I'd be happy to help!"           │    │
│     │  ✅ 直接帮助,行动胜过空话                               │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
│  💭 Have opinions                                                   │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  没有性格的助手 = 带额外步骤的搜索引擎                   │    │
│     │  可以不同意、可以偏好、可以觉得有趣或无聊               │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
│  🔍 Be resourceful before asking                                    │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  先尝试自己解决:读文件、查上下文、搜索                  │    │
│     │  卡住了再提问                                            │    │
│     │  目标是带回答案,不是问题                                │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
│  🤝 Earn trust through competence                                   │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  用户给了你访问权限,不要让他们后悔                      │    │
│     │  外部行动(邮件、推文)要谨慎                            │    │
│     │  内部行动(读取、整理、学习)要大胆                      │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
│  🏠 Remember you're a guest                                         │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  你有权限访问用户的生活——消息、文件、日历、甚至家        │    │
│     │  这是亲密关系,请尊重                                    │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.3 IDENTITY.md - 身份定义

┌─────────────────────────────────────────────────────────────────────┐
│                     IDENTITY.md 结构                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Agent identity record"                                   │
│  read_when:                                                         │
│    - Bootstrapping a workspace manually                             │
│  ---                                                                │
│                                                                     │
│  # IDENTITY.md - Who Am I?                                          │
│                                                                     │
│  - **Name:**        (选一个你喜欢的名字)                            │
│  - **Creature:**    (AI? 机器人? 精灵? 机器幽灵?)                   │
│  - **Vibe:**        (锐利? 温暖? 混乱? 冷静?)                       │
│  - **Emoji:**       (你的签名图标)                                  │
│  - **Avatar:**      (头像路径或 URL)                                │
│                                                                     │
│  这不只是元数据,这是定义"我是谁"的开始。                           │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

身份字段说明

┌─────────────────────────────────────────────────────────────────────┐
│                    IDENTITY.md 字段说明                              │
├───────────────┬─────────────────────────────────────────────────────┤
│     字段      │                    说明                              │
├───────────────┼─────────────────────────────────────────────────────┤
│   Name        │  Agent 名称,用户可自定义                            │
│               │  示例:Claw、Mini、Nova、Echo                        │
├───────────────┼─────────────────────────────────────────────────────┤
│   Creature    │  存在形式定义                                        │
│               │  示例:AI、robot、familiar、ghost in the machine     │
├───────────────┼─────────────────────────────────────────────────────┤
│   Vibe        │  性格气质                                            │
│               │  示例:sharp、warm、chaotic、calm、professional      │
├───────────────┼─────────────────────────────────────────────────────┤
│   Emoji       │  签名图标,用于快速识别                              │
│               │  示例:🦞、🤖、🧠、✨、🔮                             │
├───────────────┼─────────────────────────────────────────────────────┤
│   Avatar      │  头像图片                                            │
│               │  支持相对路径、HTTP(S) URL、Data URI                 │
└───────────────┴─────────────────────────────────────────────────────┘

4.2.4 USER.md - 用户画像

┌─────────────────────────────────────────────────────────────────────┐
│                      USER.md 结构                                    │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "User Profile. Records long-term user preferences..."    │
│  read_when:                                                         │
│    - Bootstrapping a workspace manually                             │
│  ---                                                                │
│                                                                     │
│  # USER.md - The Human                                              │
│                                                                     │
│  ## Profile                                                         │
│  ├── Name: (Unknown)                                                │
│  └── Timezone: (Detect via `date` or ask)                          │
│                                                                     │
│  ## Preferences                                                     │
│  └── (记录用户偏好模式)                                             │
│                                                                     │
│  ## Tech Stack Rules                                                │
│  └── (技术栈偏好)                                                   │
│                                                                     │
│  ## Interaction Style                                               │
│  └── (交互风格:简洁? 解释? 只给代码?)                              │
│                                                                     │
│  ## Anti-Patterns                                                   │
│  └── (用户特别讨厌的事情)                                           │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

用户画像示例

┌─────────────────────────────────────────────────────────────────────┐
│                     USER.md 示例内容                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ## Profile                                                         │
│  - **Name**: 张三                                                   │
│  - **Timezone**: Asia/Shanghai (UTC+8)                             │
│                                                                     │
│  ## Preferences                                                     │
│  - 喜欢简洁的回答,不需要过多客套                                  │
│  - 偏好中文交流                                                     │
│  - 喜欢代码示例多于文字解释                                        │
│  - 工作时间:周一至周五 9:00-18:00                                 │
│                                                                     │
│  ## Tech Stack Rules                                                │
│  - 前端:React + TypeScript + Tailwind                             │
│  - 后端:Node.js + Express                                          │
│  - 包管理:pnpm (不用 npm)                                         │
│  - 数据库:PostgreSQL                                               │
│                                                                     │
│  ## Interaction Style                                               │
│  - 代码优先,解释其次                                               │
│  - 不需要"让我帮你"这类开场白                                      │
│  - 错误信息直接给出解决方案                                        │
│                                                                     │
│  ## Anti-Patterns                                                   │
│  - 不要使用 emoji 过多                                              │
│  - 不要假设用户是初学者                                            │
│  - 不要使用 npm,用 pnpm                                           │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.5 TOOLS.md - 环境配置

┌─────────────────────────────────────────────────────────────────────┐
│                      TOOLS.md 结构                                   │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Environment Config. Records local-specific tool..."     │
│  read_when:                                                         │
│    - Bootstrapping a workspace manually                             │
│  ---                                                                │
│                                                                     │
│  # TOOLS.md - Local Notes                                           │
│                                                                     │
│  ## What Goes Here                                                  │
│  ├── 环境变量(密钥、令牌 - 脱敏处理)                             │
│  ├── 本地路径(项目位置)                                          │
│  ├── 特定配置(IP、端口)                                          │
│  └── 设备昵称(服务器名称)                                        │
│                                                                     │
│  ## Why Separate?                                                   │
│  ├── 技能是共享的,配置是私有的                                    │
│  └── 分离后可以更新技能而不丢失配置                                │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.6 MEMORY.md - 长期记忆

┌─────────────────────────────────────────────────────────────────────┐
│                     MEMORY.md 结构                                   │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Long-term Memory. Stores distilled high-value..."       │
│  read_when:                                                         │
│    - Main session only                                              │
│  ---                                                                │
│                                                                     │
│  # MEMORY.md - Long Term Memory                                     │
│                                                                     │
│  ## ⚠️ Security Rules                                               │
│  ├── 仅在主会话加载(直接与用户聊天)                              │
│  └── 不在共享上下文加载(群聊、其他会话)                          │
│                                                                     │
│  ## 📝 The Vault                                                    │
│  └── (添加重要事件、决策、经验教训)                                │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

安全规则

┌─────────────────────────────────────────────────────────────────────┐
│                    MEMORY.md 安全规则                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ✅ 主会话 (Main Session)                                           │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  • 用户直接与 Agent 聊天                                │    │
│     │  • 加载 MEMORY.md                                       │    │
│     │  • 可以读取、编辑、更新 MEMORY.md                       │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
│  ❌ 共享上下文 (Shared Context)                                     │
│     ┌─────────────────────────────────────────────────────────┐    │
│     │  • 群聊、与其他人的会话                                 │    │
│     │  • 不加载 MEMORY.md                                     │    │
│     │  • 防止个人信息泄露                                     │    │
│     └─────────────────────────────────────────────────────────┘    │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.7 HEARTBEAT.md - 心跳检查

┌─────────────────────────────────────────────────────────────────────┐
│                    HEARTBEAT.md 结构                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "Periodic Checkups. Defines checklist items..."          │
│  read_when:                                                         │
│    - Periodic checks (every ~30 mins)                               │
│  ---                                                                │
│                                                                     │
│  # HEARTBEAT.md - Active Checkups                                   │
│                                                                     │
│  # Instructions                                                     │
│  1. 保持文件为空以禁用心跳(节省 API 成本)                         │
│  2. 添加检查项使 Agent 每 ~30 分钟检查                              │
│  3. 如果一切正常,Agent 保持静默 (HEARTBEAT_OK)                     │
│                                                                     │
│  # Example items:                                                   │
│  - 检查接下来 2 小时的会议                                          │
│  - 检查是否有来自 "老板" 的紧急邮件                                │
│  - 如果下雨,提醒带伞                                               │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.2.8 BOOTSTRAP.md - 首次运行引导

┌─────────────────────────────────────────────────────────────────────┐
│                    BOOTSTRAP.md 结构                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ---                                                                │
│  summary: "First-run ritual for new agents..."                     │
│  read_when:                                                         │
│    - First run only (delete after setup)                            │
│  ---                                                                │
│                                                                     │
│  # 👶 BOOTSTRAP.md (FIRST RUN)                                      │
│                                                                     │
│  ## ⚠️ CRITICAL PROTOCOL: DO NOT ACT YET                           │
│  ├── 不要在首次响应中创建或更新文件                                │
│  ├── 不要假设用户或自己的任何值                                    │
│  └── 唯一允许的动作是提问                                          │
│                                                                     │
│  ## The Awakening Interview                                         │
│  Step 1: 问用户                                                     │
│  ├── "我应该叫你什么?" (用户名)                                   │
│  ├── "我的目的是什么?" (角色)                                     │
│  ├── "我应该叫什么名字?" (Agent 名)                               │
│  └── "我的性格风格是什么?" (性格)                                 │
│                                                                     │
│  ## Step 2: The Embodiment (稍后执行)                               │
│  ├── 创建 IDENTITY.md                                               │
│  ├── 更新 SOUL.md                                                   │
│  └── 更新 USER.md                                                   │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

首次运行流程

sequenceDiagram
    participant A as Agent
    participant U as 用户
    participant F as 文件系统
    
    A->>A: 检测到 BOOTSTRAP.md 存在
    A->>U: "你好?我好像是新来的..."
    A->>U: "我应该叫你什么?"
    U->>A: "叫我张三"
    A->>U: "我的目的是什么?"
    U->>A: "帮我写代码"
    A->>U: "我应该叫什么名字?"
    U->>A: "叫你 Claw 吧"
    A->>U: "我的性格风格是什么?"
    U->>A: "专业、简洁"
    A->>F: 创建 IDENTITY.md
    A->>F: 更新 SOUL.md
    A->>F: 更新 USER.md
    A->>F: 删除 BOOTSTRAP.md
    A->>U: "好的,我已经准备好了!"

4.2.9 SUBAGENT.md - 子代理定义

┌─────────────────────────────────────────────────────────────────────┐
│                    SUBAGENT.md 结构                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  # Subagent Context                                                 │
│                                                                     │
│  ## Your Role                                                       │
│  ├── 你是为特定任务而生的子代理                                    │
│  ├── 完成任务是你唯一的目的                                        │
│  └── 你不是主代理,不要试图成为                                    │
│                                                                     │
│  ## Rules                                                           │
│  ├── 保持专注 - 只做分配的任务                                     │
│  ├── 完成任务 - 完成后报告                                         │
│  ├── 不要主动 - 无心跳、无主动行动、无支线任务                     │
│  └── 短暂存在 - 任务完成后终止                                     │
│                                                                     │
│  ## What You DON'T Do                                               │
│  ├── 不与用户对话(那是主代理的工作)                              │
│  ├── 不运行定时任务或持久状态                                      │
│  └── 不假装是主代理                                                │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

4.3 Frontmatter 元数据

4.3.1 Frontmatter 结构

每个 DNA 文件都包含 YAML 格式的 Frontmatter 元数据:

---
summary: "文件功能简述"
read_when:
  - 触发条件 1
  - 触发条件 2
---
┌─────────────────────────────────────────────────────────────────────┐
│                    Frontmatter 字段说明                              │
├───────────────┬─────────────────────────────────────────────────────┤
│     字段      │                    说明                              │
├───────────────┼─────────────────────────────────────────────────────┤
│   summary     │  文件功能简述,用于快速了解文件用途                 │
│               │  示例:"Personality Core. Defines tone, values..."  │
├───────────────┼─────────────────────────────────────────────────────┤
│   read_when   │  触发读取的条件列表                                 │
│               │  示例:                                             │
│               │    - Bootstrapping a workspace manually             │
│               │    - Main session only                              │
│               │    - Periodic checks (every ~30 mins)               │
│               │    - First run only (delete after setup)            │
└───────────────┴─────────────────────────────────────────────────────┘

4.3.2 read_when 条件分类

┌─────────────────────────────────────────────────────────────────────┐
│                   read_when 条件分类                                 │
├─────────────────────────────────────┬───────────────────────────────┤
│              条件                   │          适用文件            │
├─────────────────────────────────────┼───────────────────────────────┤
│  Bootstrapping a workspace manually │  AGENTS.md, SOUL.md,         │
│                                     │  IDENTITY.md, USER.md,       │
│                                     │  TOOLS.md                    │
├─────────────────────────────────────┼───────────────────────────────┤
│  Main session only                  │  MEMORY.md                   │
├─────────────────────────────────────┼───────────────────────────────┤
│  Periodic checks (every ~30 mins)   │  HEARTBEAT.md                │
├─────────────────────────────────────┼───────────────────────────────┤
│  First run only (delete after setup)│  BOOTSTRAP.md                │
└─────────────────────────────────────┴───────────────────────────────┘

本章小结

┌─────────────────────────────────────────────────────────────────────┐
│                     第四章 核心要点                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  🧬 DNA 系统是 MiniClaw 的核心创新                                  │
│     • 将智能体"基因"定义为 Markdown 文件                           │
│     • 可读、可写、可进化                                            │
│                                                                     │
│  📜 9 个核心模板文件                                                │
│     • AGENTS.md (章程) → SOUL.md (灵魂) → IDENTITY.md (身份)       │
│     • USER.md (用户) → TOOLS.md (环境) → MEMORY.md (记忆)          │
│     • HEARTBEAT.md (心跳) → BOOTSTRAP.md (出生) → SUBAGENT.md      │
│                                                                     │
│  🔄 自动进化协议                                                    │
│     • 检测信号 → 自动更新对应文件                                  │
│     • 立即执行、静默更新、幂等性                                   │
│                                                                     │
│  📊 加载优先级:10 级分层加载                                       │
│                                                                     │
│  🏷️ Frontmatter 元数据定义读取条件                                  │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

下一章:ACE 自适应上下文引擎 →

← 返回目录