{"id":"577ff69c-ef1a-4eb1-83a0-219a5b2dd99c","entityType":"agent","slug":"clawhub-popo67ll-pyramid-memory-architecture","name":"金字塔记忆架构","canonicalUrl":"https://www.xpersona.co/agent/clawhub-popo67ll-pyramid-memory-architecture","canonicalPath":"/agent/clawhub-popo67ll-pyramid-memory-architecture","generatedAt":"2026-10-10T21:48:30.861Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":null},"description":"通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。 Skill: 金字塔记忆架构 Owner: popo67ll Summary: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。 Tags: latest:3.6.0 Version history: v3.6.0 | 2026-08-06T08:20:16.564Z | user 更新到 3.6.0 v3.4.0 | 2026-05-31T10:07:04.339Z | user 第9项新增任务归属标记检","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17epvpvn26rr01rcxb0mntbe984qeb8:pyramid-memory-architecture","sourceUrl":"https://clawhub.ai/popo67ll/pyramid-memory-architecture","homepage":"https://clawhub.ai/popo67ll/skills/pyramid-memory-architecture","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/popo67ll/pyramid-memory-architecture","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/popo67ll/skills/pyramid-memory-architecture","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":null},"stars":null,"forks":null,"downloads":1357,"packageName":null,"latestVersion":"3.6.0","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:37:45.417Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T15:37:45.418Z","lastCrawledAt":"2026-10-10T15:37:45.417Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T15:37:45.417Z","lastVerifiedAt":null,"highlights":[{"version":"3.6.0","createdAt":"2026-08-06T08:20:16.564Z","changelog":"更新到 3.6.0","fileCount":3,"zipByteSize":10953},{"version":"3.4.0","createdAt":"2026-05-31T10:07:04.339Z","changelog":"第9项新增任务归属标记检查：新增HEARTBEAT-Cron任务归属标记检查、防止已配cron的任务被heartbeat重复执行、HEARTBEAT.md已配cron任务应标注为流程参考未配cron任务标注为heartbeat待执行、发现问题标记告警、生成报告不自动修改","fileCount":3,"zipByteSize":10799},{"version":"3.3.0","createdAt":"2026-05-31T10:06:45.254Z","changelog":"第9项重构为触发-流程链路完整性：明确HEARTBEAT.md=Cron配套关系不去重、新增同域去重、新增Agent隔离、新增推送通道校验、新增触发-流程链路完整性双向检查、新增cron prompt规范、生成报告不自动修改","fileCount":3,"zipByteSize":10661},{"version":"3.2.0","createdAt":"2026-05-31T10:06:32.580Z","changelog":"第9项升级为触发机制职责划分+健康检查+通道校验：新增Heartbeat/Cron/Launchd三域定义和适用场景、新增三域去重检查、新增触发状态健康检查、新增推送通道校验、发现问题标记告警、生成归类建议报告不自动修改","fileCount":3,"zipByteSize":10667},{"version":"3.1.0","createdAt":"2026-05-31T10:06:12.868Z","changelog":"冗余检查触发机制：新增触发机制配置章节(Heartbeat+状态文件/cron定时任务两种方案)、新增状态文件格式说明、执行步骤增加状态读取和更新逻辑、明确隔离会话无法读Skill的限制","fileCount":3,"zipByteSize":10992},{"version":"3.0.0","createdAt":"2026-05-28T03:18:39.185Z","changelog":"规则分类决策树+动态词指纹+Skill自包含原则","fileCount":3,"zipByteSize":8994},{"version":"2.8.0","createdAt":"2026-05-25T12:11:29.051Z","changelog":"HEARTBEAT-cron同步检查 + 9项冗余检查 + README","fileCount":15,"zipByteSize":17057},{"version":"2.2.0","createdAt":"2026-05-24T17:24:51.905Z","changelog":"冗余检查规则更新：删除 HEARTBEAT.md 中 3 个子 agent 的冗余检查规则（只保留 cron 触发）；统一主工作区/lizi 工作区/work 工作区的版本","fileCount":11,"zipByteSize":10760}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17epvpvn26rr01rcxb0mntbe984qeb8:pyramid-memory-architecture","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T21:48:30.857Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-popo67ll-pyramid-memory-architecture/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":null},"readme":"Skill: 金字塔记忆架构\n\nOwner: popo67ll\n\nSummary: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。\n\nTags: latest:3.6.0\n\nVersion history:\n\nv3.6.0 | 2026-08-06T08:20:16.564Z | user\n\n更新到 3.6.0\n\nv3.4.0 | 2026-05-31T10:07:04.339Z | user\n\n第9项新增任务归属标记检查：新增HEARTBEAT-Cron任务归属标记检查、防止已配cron的任务被heartbeat重复执行、HEARTBEAT.md已配cron任务应标注为流程参考未配cron任务标注为heartbeat待执行、发现问题标记告警、生成报告不自动修改\n\nv3.3.0 | 2026-05-31T10:06:45.254Z | user\n\n第9项重构为触发-流程链路完整性：明确HEARTBEAT.md=Cron配套关系不去重、新增同域去重、新增Agent隔离、新增推送通道校验、新增触发-流程链路完整性双向检查、新增cron prompt规范、生成报告不自动修改\n\nv3.2.0 | 2026-05-31T10:06:32.580Z | user\n\n第9项升级为触发机制职责划分+健康检查+通道校验：新增Heartbeat/Cron/Launchd三域定义和适用场景、新增三域去重检查、新增触发状态健康检查、新增推送通道校验、发现问题标记告警、生成归类建议报告不自动修改\n\nv3.1.0 | 2026-05-31T10:06:12.868Z | user\n\n冗余检查触发机制：新增触发机制配置章节(Heartbeat+状态文件/cron定时任务两种方案)、新增状态文件格式说明、执行步骤增加状态读取和更新逻辑、明确隔离会话无法读Skill的限制\n\nv3.0.0 | 2026-05-28T03:18:39.185Z | user\n\n规则分类决策树+动态词指纹+Skill自包含原则\n\nv2.8.0 | 2026-05-25T12:11:29.051Z | user\n\nHEARTBEAT-cron同步检查 + 9项冗余检查 + README\n\nv2.2.0 | 2026-05-24T17:24:51.905Z | user\n\n冗余检查规则更新：删除 HEARTBEAT.md 中 3 个子 agent 的冗余检查规则（只保留 cron 触发）；统一主工作区/lizi 工作区/work 工作区的版本\n\nv2.1.0 | 2026-05-22T08:52:06.733Z | user\n\n新增注入vs非注入文件说明，帮助用户理解哪些文件会被系统自动加载\n\nv2.0.0 | 2026-05-21T15:27:37.074Z | user\n\n**v2.0.0 主要更新：架构市场级发布，提升初始化和模板体验**\n\n- 新增一键初始化脚本（scripts/init.sh & scripts/init.ps1），便捷部署新 Agent 工作区\n- templates 升级为教学版，内含详细模板与使用说明\n- 新增并补全 self-improving 目录结构\n- 完善多层 md 文件分工说明和规则录入引导\n- 详细冗余检查与引导语标准化流程\n\nArchive index:\n\nArchive v3.6.0: 3 files, 10953 bytes\n\nFiles: skill-card.md (2312b), SKILL.md (25323b), _meta.json (146b)\n\nFile v3.6.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.6.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.6** - Cron任务按复杂度分级:简单任务用锚点引导,复杂任务直写进cron payload,彻底解决隔离会话引导断裂问题\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | cron触发时通过锚点引导加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(cron 触发时通过锚点引导加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见 SKILL.md「隔离场景直写铁律」(#isolated-direct-write)),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### ⚠️ 隔离场景 Cron 任务复杂度分级\n<!-- #cron-complexity-grades -->\n\n**核心原则:按任务复杂度决定 cron payload 的写法,不搞一刀切。**\n\n| 级别 | 任务特征 | 示例 | payload 写法 |\n|------|---------|------|-------------|\n| **简单** | 规则少(≤3条)、逻辑简单、无需查外部文件 | 值班日判断、每月1号提醒 | 锚点引导:读 HEARTBEAT.md #xxx 锚点区块 |\n| **中等** | 规则适中(4-8条)、需要1-2步判断 | 工作汇报整理、缺陷归档 | 锚点引导 + 关键步骤直写 |\n| **复杂** | 规则多(≥9条)、需要多步检查、有报告模板 | 冗余检查9项清单 | 完整直写:9项清单+报告模板全部写进payload |\n\n**为什么要分级:**\n- 简单任务用锚点引导:保持规则集中管理,HEARTBEAT.md 改一次所有 cron 自动生效\n- 复杂任务直写:避免多级引导断裂(隔离会话可能不读 SKILL.md 正文),确保执行完整性\n\n**复杂任务 cron payload 标准写法:**\n1. 先声明:\"以下是完整执行指令,不需要跳转任何文件\"\n2. 把 SKILL.md 中的完整 9 项清单逐条写入 payload\n3. 把报告模板也写入 payload\n4. HEARTBEAT.md 里只留一句简短说明(标注\"详见cron payload直写\"),不重复规则内容\n\n**第9项检查标准(见下方):** 按复杂度分级来检查,不再要求\"必须锚点引导\"。\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 触发机制配置\n<!-- #trigger-setup -->\n\n冗余检查**不会自动触发**，需要手动配置触发器。推荐使用 **cron 定时任务**：\n\n**方案：cron 定时任务（推荐）— 复杂度「复杂」级，直写进 payload**\n\n1. **在 `HEARTBEAT.md` 添加简短锚点区块**（不重复完整规则，标注详见cron payload）：\n   ```markdown\n   <!-- #redundancy-check -->\n   ## 🔺 金字塔冗余检查（每 3 天一次）\n   - 此为复杂任务，完整 9 项清单和报告模板直写在 cron payload 中\n   - 详见对应 cron payload 直写内容\n   ```\n2. **创建 cron 任务**，payload 直写完整 9 项清单：\n   ```\n   以下是金字塔冗余检查完整执行指令（复杂任务直写，不需要跳转任何文件）：\n   先读 memory/redundancy-check-state.json 判断是否≥3天间隔，然后逐项执行以下 9 项检查：\n   1.内容冗余:同一规则是否出现在多个文件中\n   2.引导方向:有没有底层文件引导回顶层\n   3.锚点一致性:引导语里#[锚点]是否在目标文件中真实存在\n   4.引导格式:是否都使用\"详见[文件][章节名](#[锚点])\"格式\n   5.版本历史:各SKILL.md版本历史是否超过2条\n   6.文件大小:各md文件是否异常膨胀(>3KB需检查)\n   7.金字塔合规(动态词指纹):扫描所有SKILL.md提取技术关键词→匹配MEMORY.md→发现错位建议移至SKILL.md;检查AGENTS.md是否有操作类内容应下放;检查MEMORY.md是否有铁律类内容应上移\n   8.连接建议:只在明显相关时才建议级联\n   9.Cron锚点格式:按复杂度分级检查—简单任务应锚点引导,复杂任务应直写;检查HEARTBEAT.md锚点唯一性和命名规范;检查cron与HEARTBEAT.md一一对应;检查无重复规则\n   最后按以下模板格式汇报:\n   ##冗余检查报告(日期)\n   |检查项|状态|详情|\n   |内容冗余|✅/❌|...|\n   |引导方向|✅/❌|...|\n   |锚点一致性|✅/❌|...|\n   |引导格式|✅/❌|...|\n   |版本历史|✅/❌|...|\n   |文件大小|✅/❌|...|\n   |金字塔合规|✅/❌|...|\n   |连接建议|💡/无|...|\n   |触发机制+锚点|✅/⚠️|...|\n   发现问题/层级放错建议/锚点格式告警/建议操作\n   注意:只检查不擅自修改,等主人确认再清理。完成后更新 memory/redundancy-check-state.json。\n   ```\n3. **Schedule**: `0 12 */3 * *`（每 3 天中午 12 点）\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **Cron锚点格式检查（v3.6升级:按复杂度分级）:**\n   - **复杂度分级检查**（新增）：\n     - 简单任务(≤3条规则、逻辑简单):cron payload 应使用锚点引导(如「读 HEARTBEAT.md 的 #xxx 锚点区块」)\n     - 复杂任务(≥9条规则、多步检查、有报告模板):cron payload 应直写完整清单,不再强制锚点引导\n     - 中等任务(4-8条):锚点引导+关键步骤直写\n     - 检查方法:按任务实际规则条数判断属于哪一级,确认 cron payload 写法匹配\n   - HEARTBEAT.md 每个任务块必须有唯一锚点（`<!-- #xxx -->`）\n   - 锚点格式：`<!-- #xxx -->`，命名规范「领域-功能」，全小写+短横线\n   - **直写任务检查**：复杂任务直写时,HEARTBEAT.md 锚点区块应只留简短说明(标注\"详见cron payload\"),不重复完整规则\n   - 检查 HEARTBEAT.md 锚点与 cron 任务一一对应，无遗漏/冗余\n   - 检查是否有重复的规则内容（同一规则既完整出现在 HEARTBEAT.md 又完整出现在 cron payload 里——复杂任务除外）\n   - 检查 HEARTBEAT.md 锚点格式是否规范（锚点必须在章节标题前一行，不能悬空或重复）\n   - 生成报告汇报给主人，等确认后再调整，不自动修改\n\n### 执行步骤\n\n1. **读取触发状态**：先读 `memory/redundancy-check-state.json`，判断是否满足 3 天间隔（仅 Heartbeat 方案）\n2. 读取所有 md 文件内容\n3. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(Cron锚点格式检查):\n   a. **复杂度分级判断**:按任务规则条数判断级别(简单≤3/中等4-8/复杂≥9)\n   b. 简单任务:检查是否使用锚点引导\n   c. 复杂任务:检查是否直写完整清单,HEARTBEAT.md是否只留简短说明\n   d. 检查 HEARTBEAT.md 每个任务块是否有唯一锚点（<!-- #xxx -->）\n   e. 检查锚点格式是否规范（命名：领域-功能，全小写+短横线）\n   f. 检查 HEARTBEAT.md 锚点与 cron 任务一一对应，无遗漏/冗余\n   g. 检查是否有重复规则\n   h. 生成报告，汇报给主人，等确认后再调整\n8. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n9. 向主人汇报检查结果,确认后执行清理\n10. **更新状态文件**：写入当前时间到 `memory/redundancy-check-state.json`（仅 Heartbeat 方案）\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| 触发机制划分+锚点格式 | ✅/⚠️ | cron锚点格式+HEARTBEAT.md锚点规范+一一对应检查 |\n\n发现问题:[描述]\n层级放错建议:[描述]\n重复触发风险:[同一任务出现在两个及以上机制中时列出]\n锚点格式告警:[HEARTBEAT.md锚点格式不规范/锚点与cron不一一对应/规则重复出现在HEARTBEAT.md和cron payload中]\n归类建议:[每个任务推荐放的触发机制及理由]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.6 | 2026-06-07 | **Cron任务按复杂度分级(修复引导断裂)**:1新增#cron-complexity-grades分级规则(简单≤3条锚点引导/中等4-8条混合/复杂≥9条直写);2#trigger-setup冗余检查改为直写9项清单+报告模板进payload;3第9项检查标准更新为按复杂度分级检查,不再一刀切要求锚点引导;4解决隔离会话引导链断裂导致agent偷懒跑简化版的问题 ✅ |\n| v3.5 | 2026-06-05 | **第9项重构为Cron锚点格式检查**:1HEARTBEAT.md改为cron触发时通过锚点引导加载;2每个任务块必须有唯一锚点(<!--#xxx-->);3cron payload使用锚点引导(而非硬编码长规则);4检查锚点与cron一一对应,无遗漏/冗余;5检查是否有重复规则(同一规则既在HEARTBEAT.md又在cron payload硬编码);6生成报告不自动修改 ✅ |\n\nFile v3.6.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.6.0\",\n  \"publishedAt\": 1786004416564\n}\n\nFile v3.6.0:skill-card.md\n\n## Description:\n\nPyramid Memory Architecture is an agent skill for organizing AI-agent memory into layered files, guiding rule placement, redundancy checks, cron trigger design, and workspace initialization.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[popo67ll](https://clawhub.ai/user/popo67ll)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent builders use this skill to initialize and maintain AI-agent workspaces with clear memory layers for rules, personality, heartbeat tasks, local tool notes, and technical implementation details. It also helps agents audit markdown memory files for redundancy, misplaced rules, broken anchors, and cron payload design.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may lead an agent to inspect private memory, user-profile, tool, cookie, API-key, or repository information.\n\nMitigation: Use explicit file allowlists and exclude credential-bearing or private paths unless the user has authorized that access for the task.\n\nRisk: Recurring cron workflows can cause repeated scans or actions that the user did not intend.\n\nMitigation: Keep cron workflows disabled unless they are deliberately configured, reviewed, and scoped.\n\nRisk: Cleanup or GitHub synchronization guidance could alter or publish workspace content.\n\nMitigation: Require separate confirmation before cleanup, file deletion, commits, tags, or GitHub pushes.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/popo67ll/skills/pyramid-memory-architecture)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Configuration, Shell commands]\n\n**Output Format:** [Markdown guidance with file templates, checklists, JSON payload examples, and command snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May propose workspace file edits, cron payloads, redundancy-check reports, and memory-layer classification decisions.]\n\n## Skill Version(s):\n\n3.6.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v3.4.0: 3 files, 10799 bytes\n\nFiles: skill-card.md (2407b), SKILL.md (24607b), _meta.json (146b)\n\nFile v3.4.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.4.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.4** - 第9项新增:Heartbeat-Cron任务归属标记检查(杜绝重复执行)\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 触发机制配置\n<!-- #trigger-setup -->\n\n冗余检查**不会自动触发**，需要手动配置触发器。根据 Agent 类型选择方案：\n\n**方案 A：Heartbeat + 状态文件（推荐，适用于有心跳的 Agent）**\n\n1. **在 `HEARTBEAT.md` 添加任务**：\n   ```markdown\n   ## 🔺 金字塔冗余检查（每 3 天一次）\n   1. 读取 `memory/redundancy-check-state.json`，检查 `lastCheckDate`\n   2. 如果距今天 ≥ 3 天，或 `lastCheck` 为 `null`（首次），则执行\n   3. 按本 Skill `#redundancy-check` 的 9 项清单逐一检查\n   4. 向主人汇报结果（只汇报，不擅自修改，等确认再清理）\n   5. 更新 `memory/redundancy-check-state.json` 的 `lastCheck` 和 `lastCheckDate`\n   ```\n2. **创建状态文件** `memory/redundancy-check-state.json`：\n   ```json\n   {\n     \"lastCheck\": null,\n     \"lastCheckDate\": null\n   }\n   ```\n\n**方案 B：cron 定时任务（无心跳的 Agent）**\n\n隔离会话无法读取 Skill，必须把 9 项检查流程完整写在 cron prompt 里，不能用「详见 SKILL.md」引导。\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **触发机制职责划分+健康检查+通道校验+触发-流程链路完整性**:\n   - **三域扫描**:扫描当前agent自己workspace下的HEARTBEAT.md流程规则、当前agent的cron任务列表、当前agent的launchd任务列表(**只检查本agent区域,不干涉其他agent**)\n   - **同域去重**:\n     - Cron内部:同一个功能不能建两个cron任务\n     - Launchd内部:不能重复配置\n     - Cron vs Launchd:同一功能不能既配cron又配launchd脚本\n     - ⚠️ HEARTBEAT.md vs Cron**不去重**(它们是配套关系:流程说明书+闹钟)\n   - **触发状态健康检查**:\n     - **Heartbeat**:检查当前agent的heartbeat是否启用、间隔是否正常、上次触发时间\n     - **Cron**:检查当前agent的cron任务status是否为ok、Last是否有值(证明跑过)、有无失败记录\n     - **Launchd**:检查PID是否存在、LastExitStatus是否为0(正常退出)、有无crash重启\n     - 发现问题标记:⚠️配置了但没触发 / ⚠️触发了但失败 / ⚠️从来没跑过\n   - **触发机制职责划分**:\n     - 逐个分析任务特性,推荐最适合的机制:\n       - **launchd**(macOS系统级):不需要OpenClaw会话的独立任务,如脚本执行、文件备份、系统健康检查\n       - **Cron**(OpenClaw内置):需要精确时间点触发、隔离会话执行的任务,如\"周三14:00开会\"\"每日23:00写日志\"\n       - **Heartbeat**(OpenClaw主会话唤醒):不需要精确时间点,定期唤醒判断状态再执行的任务,如\"每3天冗余检查\"\"值班日判断\"\n   - **推送通道校验**:\n     - 检查每个提醒任务的delivery target(agent+channel)是否与任务类型匹配\n     - 工作类应走微信通道,舞蹈类可走石榴的QQ通道,运维类走栗子QQ通道\n     - 发现问题标记:⚠️工作提醒推到了QQ / ⚠️舞蹈提醒推到了微信 / ⚠️推送到不存在的通道\n   - **触发-流程链路完整性**:\n     - HEARTBEAT.md有流程 → 有没有对应cron触发?(防遗漏)\n     - cron有任务 → prompt有没有正确引用HEARTBEAT.md对应区块?(防断链)\n     - cron prompt是否包含\"读HEARTBEAT.md第X区块,按流程执行\"的明确指令?(隔离会话必须一句话写完规则,不能跳转引用)\n     - 有没有cron触发了但HEARTBEAT.md没对应流程的?(防空转)\n   - **Heartbeat-Cron任务归属标记检查**:\n     - HEARTBEAT.md每个任务是否明确标注归属?(cron/heartbeat/流程参考)\n     - 已配cron的任务 → HEARTBEAT.md是否标记为\"流程参考\"或\"走cron\",避免heartbeat重复执行?\n     - 没有配cron的任务 → 是否标注为\"heartbeat待执行\"?\n     - 发现问题标记:⚠️任务归属不明 / ⚠️已配cron但HEARTBEAT未标注流程参考\n   - 生成报告汇报给主人,等确认后再调整,不自动修改\n\n### 执行步骤\n\n1. **读取触发状态**：先读 `memory/redundancy-check-state.json`，判断是否满足 3 天间隔（仅 Heartbeat 方案）\n2. 读取所有 md 文件内容\n3. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(触发机制职责划分+健康检查+通道校验+链路完整性+归属标记):\n   a. 扫描当前agent自己workspace下的HEARTBEAT.md所有流程规则(cron和launchd只查当前agent的,通过agentId过滤,不干涉其他agent)\n   b. 同域去重:cron内部/cron与launchd之间的重复任务\n   c. 触发状态健康检查:Heartbeat启用状态、Cron Last值、Launchd PID和ExitStatus\n   d. 触发机制职责划分:逐个分析推荐最适合机制(launchd/cron/heartbeat)\n   e. 推送通道校验:检查delivery target是否与任务类型匹配\n   f. 触发-流程链路完整性:HEARTBEAT.md流程vs cron prompt双向检查,确保链路完整\n   g. 任务归属标记检查:HEARTBEAT.md每个任务是否明确标注归属(cron/heartbeat/流程参考)\n   h. 生成报告,汇报给主人,等确认后再调整\n8. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n9. 向主人汇报检查结果,确认后执行清理\n10. **更新状态文件**：写入当前时间到 `memory/redundancy-check-state.json`（仅 Heartbeat 方案）\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| 触发机制划分+链路完整性 | ✅/⚠️ | 三域职责划分+健康检查+通道校验+触发-流程链路完整性(仅本agent区域) |\n\n发现问题:[描述]\n层级放错建议:[描述]\n重复触发风险:[同一任务出现在两个及以上机制中时列出]\n触发健康告警:[配置了但没触发/触发了但失败/从来没跑过的任务]\n通道校验告警:[工作提醒推到了QQ/舞蹈提醒推到了微信/推送到不存在的通道]\n链路完整性告警:[HEARTBEAT有流程但无cron触发/cron有任务但HEARTBEAT无对应流程/cron prompt未正确引用HEARTBEAT区块]\n归属标记告警:[任务归属不明/已配cron但HEARTBEAT未标注流程参考/未标注heartbeat待执行]\n归类建议:[每个任务推荐放的触发机制及理由]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.4 | 2026-05-31 | **第9项新增任务归属标记检查**:1新增HEARTBEAT-Cron任务归属标记检查(每个任务必须标注归属:走cron/走heartbeat/流程参考);2防止已配cron的任务被heartbeat重复执行;3HEARTBEAT.md已配cron任务应标注为\"流程参考\"未配cron任务标注为\"heartbeat待执行\";4发现问题标记告警;5生成报告不自动修改 ✅ |\n| v3.3 | 2026-05-31 | **第9项重构为触发-流程链路完整性**:1明确HEARTBEAT.md=Cron配套关系(流程说明书+闹钟)不去重;2新增同域去重(cron内部/cron与launchd);3新增Agent隔离(只查本agent区域,按agentId过滤,不干涉其他agent);4新增推送通道校验(agent+channel匹配);5新增触发-流程链路完整性双向检查(HEARTBEAT流程vs cron prompt);6新增cron prompt规范(隔离会话一句话写完规则,禁止跳转引用);7生成报告不自动修改 ✅ |\n\nFile v3.4.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.4.0\",\n  \"publishedAt\": 1780222024339\n}\n\nFile v3.4.0:skill-card.md\n\n## Description: <br>\n金字塔记忆架构 helps agents initialize and maintain layered workspace memory files, separating high-priority behavior rules, business memory, persona files, technical skill details, and scheduled-check responsibilities. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[popo67ll](https://clawhub.ai/user/popo67ll) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent operators use this skill to organize OpenClaw workspace memory, route new rules to the right files, and review memory, heartbeat, cron, and launchd responsibilities before changes are applied. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can guide edits to persistent workspace memory files and recurring task definitions, which may affect future agent behavior or cause duplicate scheduled work. <br>\nMitigation: Review proposed changes to AGENTS.md, MEMORY.md, HEARTBEAT.md, USER.md, TOOLS.md, cron, launchd, and generated reports before applying them. <br>\nRisk: Workspace configuration may involve sensitive credential locations, notification channels, repositories, or git/GitHub sync actions. <br>\nMitigation: Keep secrets out of skill files and verify credential paths, channel targets, repository destinations, and sync commands before execution. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/popo67ll/pyramid-memory-architecture) <br>\n- [ClawHub publisher profile](https://clawhub.ai/user/popo67ll) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with checklists, file-structure recommendations, reports, and example shell or JSON snippets] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs are proposals for workspace memory and scheduler configuration; users should review them before approving edits or sync actions.] <br>\n\n## Skill Version(s): <br>\n3.4.0 (source: SKILL.md frontmatter and ClawHub release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v3.3.0: 3 files, 10661 bytes\n\nFiles: skill-card.md (2204b), SKILL.md (24607b), _meta.json (146b)\n\nFile v3.3.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.4.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.4** - 第9项新增:Heartbeat-Cron任务归属标记检查(杜绝重复执行)\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 触发机制配置\n<!-- #trigger-setup -->\n\n冗余检查**不会自动触发**，需要手动配置触发器。根据 Agent 类型选择方案：\n\n**方案 A：Heartbeat + 状态文件（推荐，适用于有心跳的 Agent）**\n\n1. **在 `HEARTBEAT.md` 添加任务**：\n   ```markdown\n   ## 🔺 金字塔冗余检查（每 3 天一次）\n   1. 读取 `memory/redundancy-check-state.json`，检查 `lastCheckDate`\n   2. 如果距今天 ≥ 3 天，或 `lastCheck` 为 `null`（首次），则执行\n   3. 按本 Skill `#redundancy-check` 的 9 项清单逐一检查\n   4. 向主人汇报结果（只汇报，不擅自修改，等确认再清理）\n   5. 更新 `memory/redundancy-check-state.json` 的 `lastCheck` 和 `lastCheckDate`\n   ```\n2. **创建状态文件** `memory/redundancy-check-state.json`：\n   ```json\n   {\n     \"lastCheck\": null,\n     \"lastCheckDate\": null\n   }\n   ```\n\n**方案 B：cron 定时任务（无心跳的 Agent）**\n\n隔离会话无法读取 Skill，必须把 9 项检查流程完整写在 cron prompt 里，不能用「详见 SKILL.md」引导。\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **触发机制职责划分+健康检查+通道校验+触发-流程链路完整性**:\n   - **三域扫描**:扫描当前agent自己workspace下的HEARTBEAT.md流程规则、当前agent的cron任务列表、当前agent的launchd任务列表(**只检查本agent区域,不干涉其他agent**)\n   - **同域去重**:\n     - Cron内部:同一个功能不能建两个cron任务\n     - Launchd内部:不能重复配置\n     - Cron vs Launchd:同一功能不能既配cron又配launchd脚本\n     - ⚠️ HEARTBEAT.md vs Cron**不去重**(它们是配套关系:流程说明书+闹钟)\n   - **触发状态健康检查**:\n     - **Heartbeat**:检查当前agent的heartbeat是否启用、间隔是否正常、上次触发时间\n     - **Cron**:检查当前agent的cron任务status是否为ok、Last是否有值(证明跑过)、有无失败记录\n     - **Launchd**:检查PID是否存在、LastExitStatus是否为0(正常退出)、有无crash重启\n     - 发现问题标记:⚠️配置了但没触发 / ⚠️触发了但失败 / ⚠️从来没跑过\n   - **触发机制职责划分**:\n     - 逐个分析任务特性,推荐最适合的机制:\n       - **launchd**(macOS系统级):不需要OpenClaw会话的独立任务,如脚本执行、文件备份、系统健康检查\n       - **Cron**(OpenClaw内置):需要精确时间点触发、隔离会话执行的任务,如\"周三14:00开会\"\"每日23:00写日志\"\n       - **Heartbeat**(OpenClaw主会话唤醒):不需要精确时间点,定期唤醒判断状态再执行的任务,如\"每3天冗余检查\"\"值班日判断\"\n   - **推送通道校验**:\n     - 检查每个提醒任务的delivery target(agent+channel)是否与任务类型匹配\n     - 工作类应走微信通道,舞蹈类可走石榴的QQ通道,运维类走栗子QQ通道\n     - 发现问题标记:⚠️工作提醒推到了QQ / ⚠️舞蹈提醒推到了微信 / ⚠️推送到不存在的通道\n   - **触发-流程链路完整性**:\n     - HEARTBEAT.md有流程 → 有没有对应cron触发?(防遗漏)\n     - cron有任务 → prompt有没有正确引用HEARTBEAT.md对应区块?(防断链)\n     - cron prompt是否包含\"读HEARTBEAT.md第X区块,按流程执行\"的明确指令?(隔离会话必须一句话写完规则,不能跳转引用)\n     - 有没有cron触发了但HEARTBEAT.md没对应流程的?(防空转)\n   - **Heartbeat-Cron任务归属标记检查**:\n     - HEARTBEAT.md每个任务是否明确标注归属?(cron/heartbeat/流程参考)\n     - 已配cron的任务 → HEARTBEAT.md是否标记为\"流程参考\"或\"走cron\",避免heartbeat重复执行?\n     - 没有配cron的任务 → 是否标注为\"heartbeat待执行\"?\n     - 发现问题标记:⚠️任务归属不明 / ⚠️已配cron但HEARTBEAT未标注流程参考\n   - 生成报告汇报给主人,等确认后再调整,不自动修改\n\n### 执行步骤\n\n1. **读取触发状态**：先读 `memory/redundancy-check-state.json`，判断是否满足 3 天间隔（仅 Heartbeat 方案）\n2. 读取所有 md 文件内容\n3. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(触发机制职责划分+健康检查+通道校验+链路完整性+归属标记):\n   a. 扫描当前agent自己workspace下的HEARTBEAT.md所有流程规则(cron和launchd只查当前agent的,通过agentId过滤,不干涉其他agent)\n   b. 同域去重:cron内部/cron与launchd之间的重复任务\n   c. 触发状态健康检查:Heartbeat启用状态、Cron Last值、Launchd PID和ExitStatus\n   d. 触发机制职责划分:逐个分析推荐最适合机制(launchd/cron/heartbeat)\n   e. 推送通道校验:检查delivery target是否与任务类型匹配\n   f. 触发-流程链路完整性:HEARTBEAT.md流程vs cron prompt双向检查,确保链路完整\n   g. 任务归属标记检查:HEARTBEAT.md每个任务是否明确标注归属(cron/heartbeat/流程参考)\n   h. 生成报告,汇报给主人,等确认后再调整\n8. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n9. 向主人汇报检查结果,确认后执行清理\n10. **更新状态文件**：写入当前时间到 `memory/redundancy-check-state.json`（仅 Heartbeat 方案）\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| 触发机制划分+链路完整性 | ✅/⚠️ | 三域职责划分+健康检查+通道校验+触发-流程链路完整性(仅本agent区域) |\n\n发现问题:[描述]\n层级放错建议:[描述]\n重复触发风险:[同一任务出现在两个及以上机制中时列出]\n触发健康告警:[配置了但没触发/触发了但失败/从来没跑过的任务]\n通道校验告警:[工作提醒推到了QQ/舞蹈提醒推到了微信/推送到不存在的通道]\n链路完整性告警:[HEARTBEAT有流程但无cron触发/cron有任务但HEARTBEAT无对应流程/cron prompt未正确引用HEARTBEAT区块]\n归属标记告警:[任务归属不明/已配cron但HEARTBEAT未标注流程参考/未标注heartbeat待执行]\n归类建议:[每个任务推荐放的触发机制及理由]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.4 | 2026-05-31 | **第9项新增任务归属标记检查**:1新增HEARTBEAT-Cron任务归属标记检查(每个任务必须标注归属:走cron/走heartbeat/流程参考);2防止已配cron的任务被heartbeat重复执行;3HEARTBEAT.md已配cron任务应标注为\"流程参考\"未配cron任务标注为\"heartbeat待执行\";4发现问题标记告警;5生成报告不自动修改 ✅ |\n| v3.3 | 2026-05-31 | **第9项重构为触发-流程链路完整性**:1明确HEARTBEAT.md=Cron配套关系(流程说明书+闹钟)不去重;2新增同域去重(cron内部/cron与launchd);3新增Agent隔离(只查本agent区域,按agentId过滤,不干涉其他agent);4新增推送通道校验(agent+channel匹配);5新增触发-流程链路完整性双向检查(HEARTBEAT流程vs cron prompt);6新增cron prompt规范(隔离会话一句话写完规则,禁止跳转引用);7生成报告不自动修改 ✅ |\n\nFile v3.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.3.0\",\n  \"publishedAt\": 1780222005254\n}\n\nFile v3.3.0:skill-card.md\n\n## Description: <br>\nThis skill guides agents in organizing workspace memory into a pyramid of core rules, business memory, persona files, operational notes, and technical implementation details. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[popo67ll](https://clawhub.ai/user/popo67ll) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent operators use this skill to initialize and audit agent workspaces, classify rules into the correct memory layer, check markdown rule redundancy, and review trigger ownership for heartbeat, cron, and launchd workflows. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Broad memory-file audits may expose personal notes, credentials, or cookie-related details. <br>\nMitigation: Restrict scans to relevant files, avoid storing secrets in TOOLS.md, and redact generated reports before sharing. <br>\nRisk: Trigger and channel audits may inspect cron, launchd, heartbeat, and routing metadata that controls operational behavior. <br>\nMitigation: Require explicit user confirmation before cleanup, GitHub pushes, cron or launchd inspection, or channel-routing changes. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/popo67ll/pyramid-memory-architecture) <br>\n- [Publisher profile](https://clawhub.ai/user/popo67ll) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, markdown, configuration, shell commands] <br>\n**Output Format:** [Markdown guidance with file templates, checklists, and command examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May produce audit reports and proposed workspace file changes; it should not automatically clean up findings without user confirmation.] <br>\n\n## Skill Version(s): <br>\n3.3.0 (source: server release metadata; artifact frontmatter reports 3.4.0) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v3.2.0: 3 files, 10667 bytes\n\nFiles: skill-card.md (2199b), SKILL.md (24607b), _meta.json (146b)\n\nFile v3.2.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.4.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.4** - 第9项新增:Heartbeat-Cron任务归属标记检查(杜绝重复执行)\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 触发机制配置\n<!-- #trigger-setup -->\n\n冗余检查**不会自动触发**，需要手动配置触发器。根据 Agent 类型选择方案：\n\n**方案 A：Heartbeat + 状态文件（推荐，适用于有心跳的 Agent）**\n\n1. **在 `HEARTBEAT.md` 添加任务**：\n   ```markdown\n   ## 🔺 金字塔冗余检查（每 3 天一次）\n   1. 读取 `memory/redundancy-check-state.json`，检查 `lastCheckDate`\n   2. 如果距今天 ≥ 3 天，或 `lastCheck` 为 `null`（首次），则执行\n   3. 按本 Skill `#redundancy-check` 的 9 项清单逐一检查\n   4. 向主人汇报结果（只汇报，不擅自修改，等确认再清理）\n   5. 更新 `memory/redundancy-check-state.json` 的 `lastCheck` 和 `lastCheckDate`\n   ```\n2. **创建状态文件** `memory/redundancy-check-state.json`：\n   ```json\n   {\n     \"lastCheck\": null,\n     \"lastCheckDate\": null\n   }\n   ```\n\n**方案 B：cron 定时任务（无心跳的 Agent）**\n\n隔离会话无法读取 Skill，必须把 9 项检查流程完整写在 cron prompt 里，不能用「详见 SKILL.md」引导。\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **触发机制职责划分+健康检查+通道校验+触发-流程链路完整性**:\n   - **三域扫描**:扫描当前agent自己workspace下的HEARTBEAT.md流程规则、当前agent的cron任务列表、当前agent的launchd任务列表(**只检查本agent区域,不干涉其他agent**)\n   - **同域去重**:\n     - Cron内部:同一个功能不能建两个cron任务\n     - Launchd内部:不能重复配置\n     - Cron vs Launchd:同一功能不能既配cron又配launchd脚本\n     - ⚠️ HEARTBEAT.md vs Cron**不去重**(它们是配套关系:流程说明书+闹钟)\n   - **触发状态健康检查**:\n     - **Heartbeat**:检查当前agent的heartbeat是否启用、间隔是否正常、上次触发时间\n     - **Cron**:检查当前agent的cron任务status是否为ok、Last是否有值(证明跑过)、有无失败记录\n     - **Launchd**:检查PID是否存在、LastExitStatus是否为0(正常退出)、有无crash重启\n     - 发现问题标记:⚠️配置了但没触发 / ⚠️触发了但失败 / ⚠️从来没跑过\n   - **触发机制职责划分**:\n     - 逐个分析任务特性,推荐最适合的机制:\n       - **launchd**(macOS系统级):不需要OpenClaw会话的独立任务,如脚本执行、文件备份、系统健康检查\n       - **Cron**(OpenClaw内置):需要精确时间点触发、隔离会话执行的任务,如\"周三14:00开会\"\"每日23:00写日志\"\n       - **Heartbeat**(OpenClaw主会话唤醒):不需要精确时间点,定期唤醒判断状态再执行的任务,如\"每3天冗余检查\"\"值班日判断\"\n   - **推送通道校验**:\n     - 检查每个提醒任务的delivery target(agent+channel)是否与任务类型匹配\n     - 工作类应走微信通道,舞蹈类可走石榴的QQ通道,运维类走栗子QQ通道\n     - 发现问题标记:⚠️工作提醒推到了QQ / ⚠️舞蹈提醒推到了微信 / ⚠️推送到不存在的通道\n   - **触发-流程链路完整性**:\n     - HEARTBEAT.md有流程 → 有没有对应cron触发?(防遗漏)\n     - cron有任务 → prompt有没有正确引用HEARTBEAT.md对应区块?(防断链)\n     - cron prompt是否包含\"读HEARTBEAT.md第X区块,按流程执行\"的明确指令?(隔离会话必须一句话写完规则,不能跳转引用)\n     - 有没有cron触发了但HEARTBEAT.md没对应流程的?(防空转)\n   - **Heartbeat-Cron任务归属标记检查**:\n     - HEARTBEAT.md每个任务是否明确标注归属?(cron/heartbeat/流程参考)\n     - 已配cron的任务 → HEARTBEAT.md是否标记为\"流程参考\"或\"走cron\",避免heartbeat重复执行?\n     - 没有配cron的任务 → 是否标注为\"heartbeat待执行\"?\n     - 发现问题标记:⚠️任务归属不明 / ⚠️已配cron但HEARTBEAT未标注流程参考\n   - 生成报告汇报给主人,等确认后再调整,不自动修改\n\n### 执行步骤\n\n1. **读取触发状态**：先读 `memory/redundancy-check-state.json`，判断是否满足 3 天间隔（仅 Heartbeat 方案）\n2. 读取所有 md 文件内容\n3. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(触发机制职责划分+健康检查+通道校验+链路完整性+归属标记):\n   a. 扫描当前agent自己workspace下的HEARTBEAT.md所有流程规则(cron和launchd只查当前agent的,通过agentId过滤,不干涉其他agent)\n   b. 同域去重:cron内部/cron与launchd之间的重复任务\n   c. 触发状态健康检查:Heartbeat启用状态、Cron Last值、Launchd PID和ExitStatus\n   d. 触发机制职责划分:逐个分析推荐最适合机制(launchd/cron/heartbeat)\n   e. 推送通道校验:检查delivery target是否与任务类型匹配\n   f. 触发-流程链路完整性:HEARTBEAT.md流程vs cron prompt双向检查,确保链路完整\n   g. 任务归属标记检查:HEARTBEAT.md每个任务是否明确标注归属(cron/heartbeat/流程参考)\n   h. 生成报告,汇报给主人,等确认后再调整\n8. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n9. 向主人汇报检查结果,确认后执行清理\n10. **更新状态文件**：写入当前时间到 `memory/redundancy-check-state.json`（仅 Heartbeat 方案）\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| 触发机制划分+链路完整性 | ✅/⚠️ | 三域职责划分+健康检查+通道校验+触发-流程链路完整性(仅本agent区域) |\n\n发现问题:[描述]\n层级放错建议:[描述]\n重复触发风险:[同一任务出现在两个及以上机制中时列出]\n触发健康告警:[配置了但没触发/触发了但失败/从来没跑过的任务]\n通道校验告警:[工作提醒推到了QQ/舞蹈提醒推到了微信/推送到不存在的通道]\n链路完整性告警:[HEARTBEAT有流程但无cron触发/cron有任务但HEARTBEAT无对应流程/cron prompt未正确引用HEARTBEAT区块]\n归属标记告警:[任务归属不明/已配cron但HEARTBEAT未标注流程参考/未标注heartbeat待执行]\n归类建议:[每个任务推荐放的触发机制及理由]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.4 | 2026-05-31 | **第9项新增任务归属标记检查**:1新增HEARTBEAT-Cron任务归属标记检查(每个任务必须标注归属:走cron/走heartbeat/流程参考);2防止已配cron的任务被heartbeat重复执行;3HEARTBEAT.md已配cron任务应标注为\"流程参考\"未配cron任务标注为\"heartbeat待执行\";4发现问题标记告警;5生成报告不自动修改 ✅ |\n| v3.3 | 2026-05-31 | **第9项重构为触发-流程链路完整性**:1明确HEARTBEAT.md=Cron配套关系(流程说明书+闹钟)不去重;2新增同域去重(cron内部/cron与launchd);3新增Agent隔离(只查本agent区域,按agentId过滤,不干涉其他agent);4新增推送通道校验(agent+channel匹配);5新增触发-流程链路完整性双向检查(HEARTBEAT流程vs cron prompt);6新增cron prompt规范(隔离会话一句话写完规则,禁止跳转引用);7生成报告不自动修改 ✅ |\n\nFile v3.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.2.0\",\n  \"publishedAt\": 1780221992580\n}\n\nFile v3.2.0:skill-card.md\n\n## Description: <br>\nA general AI agent memory-architecture skill that organizes workspace rules into a pyramid of top-level guardrails, mid-level memory and persona files, and lower-level technical instructions. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[popo67ll](https://clawhub.ai/user/popo67ll) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent operators use this skill to initialize and maintain structured agent workspaces, place rules in the right memory layer, check Markdown rule redundancy, and review heartbeat, cron, and launchd task ownership. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can prompt an agent to inspect private workspace memory files and scheduling state. <br>\nMitigation: Limit use to a test or current-agent workspace, and exclude or redact USER.md and TOOLS.md unless they are necessary for the task. <br>\nRisk: Cleanup edits, cron or launchd checks, report sharing, and GitHub push or repository actions can affect user control or expose sensitive context. <br>\nMitigation: Require explicit user approval before those actions and review generated reports before applying changes. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/popo67ll/pyramid-memory-architecture) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, markdown, shell commands, configuration] <br>\n**Output Format:** [Markdown guidance with checklists, tables, JSON snippets, and shell commands] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Produces recommendations and reports; workspace edits, cleanup, scheduling checks, and repository actions should require explicit user approval.] <br>\n\n## Skill Version(s): <br>\n3.2.0 (source: server release metadata; artifact SKILL.md frontmatter states 3.4.0) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v3.1.0: 3 files, 10992 bytes\n\nFiles: skill-card.md (2619b), SKILL.md (24607b), _meta.json (146b)\n\nFile v3.1.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.4.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.4** - 第9项新增:Heartbeat-Cron任务归属标记检查(杜绝重复执行)\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 触发机制配置\n<!-- #trigger-setup -->\n\n冗余检查**不会自动触发**，需要手动配置触发器。根据 Agent 类型选择方案：\n\n**方案 A：Heartbeat + 状态文件（推荐，适用于有心跳的 Agent）**\n\n1. **在 `HEARTBEAT.md` 添加任务**：\n   ```markdown\n   ## 🔺 金字塔冗余检查（每 3 天一次）\n   1. 读取 `memory/redundancy-check-state.json`，检查 `lastCheckDate`\n   2. 如果距今天 ≥ 3 天，或 `lastCheck` 为 `null`（首次），则执行\n   3. 按本 Skill `#redundancy-check` 的 9 项清单逐一检查\n   4. 向主人汇报结果（只汇报，不擅自修改，等确认再清理）\n   5. 更新 `memory/redundancy-check-state.json` 的 `lastCheck` 和 `lastCheckDate`\n   ```\n2. **创建状态文件** `memory/redundancy-check-state.json`：\n   ```json\n   {\n     \"lastCheck\": null,\n     \"lastCheckDate\": null\n   }\n   ```\n\n**方案 B：cron 定时任务（无心跳的 Agent）**\n\n隔离会话无法读取 Skill，必须把 9 项检查流程完整写在 cron prompt 里，不能用「详见 SKILL.md」引导。\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **触发机制职责划分+健康检查+通道校验+触发-流程链路完整性**:\n   - **三域扫描**:扫描当前agent自己workspace下的HEARTBEAT.md流程规则、当前agent的cron任务列表、当前agent的launchd任务列表(**只检查本agent区域,不干涉其他agent**)\n   - **同域去重**:\n     - Cron内部:同一个功能不能建两个cron任务\n     - Launchd内部:不能重复配置\n     - Cron vs Launchd:同一功能不能既配cron又配launchd脚本\n     - ⚠️ HEARTBEAT.md vs Cron**不去重**(它们是配套关系:流程说明书+闹钟)\n   - **触发状态健康检查**:\n     - **Heartbeat**:检查当前agent的heartbeat是否启用、间隔是否正常、上次触发时间\n     - **Cron**:检查当前agent的cron任务status是否为ok、Last是否有值(证明跑过)、有无失败记录\n     - **Launchd**:检查PID是否存在、LastExitStatus是否为0(正常退出)、有无crash重启\n     - 发现问题标记:⚠️配置了但没触发 / ⚠️触发了但失败 / ⚠️从来没跑过\n   - **触发机制职责划分**:\n     - 逐个分析任务特性,推荐最适合的机制:\n       - **launchd**(macOS系统级):不需要OpenClaw会话的独立任务,如脚本执行、文件备份、系统健康检查\n       - **Cron**(OpenClaw内置):需要精确时间点触发、隔离会话执行的任务,如\"周三14:00开会\"\"每日23:00写日志\"\n       - **Heartbeat**(OpenClaw主会话唤醒):不需要精确时间点,定期唤醒判断状态再执行的任务,如\"每3天冗余检查\"\"值班日判断\"\n   - **推送通道校验**:\n     - 检查每个提醒任务的delivery target(agent+channel)是否与任务类型匹配\n     - 工作类应走微信通道,舞蹈类可走石榴的QQ通道,运维类走栗子QQ通道\n     - 发现问题标记:⚠️工作提醒推到了QQ / ⚠️舞蹈提醒推到了微信 / ⚠️推送到不存在的通道\n   - **触发-流程链路完整性**:\n     - HEARTBEAT.md有流程 → 有没有对应cron触发?(防遗漏)\n     - cron有任务 → prompt有没有正确引用HEARTBEAT.md对应区块?(防断链)\n     - cron prompt是否包含\"读HEARTBEAT.md第X区块,按流程执行\"的明确指令?(隔离会话必须一句话写完规则,不能跳转引用)\n     - 有没有cron触发了但HEARTBEAT.md没对应流程的?(防空转)\n   - **Heartbeat-Cron任务归属标记检查**:\n     - HEARTBEAT.md每个任务是否明确标注归属?(cron/heartbeat/流程参考)\n     - 已配cron的任务 → HEARTBEAT.md是否标记为\"流程参考\"或\"走cron\",避免heartbeat重复执行?\n     - 没有配cron的任务 → 是否标注为\"heartbeat待执行\"?\n     - 发现问题标记:⚠️任务归属不明 / ⚠️已配cron但HEARTBEAT未标注流程参考\n   - 生成报告汇报给主人,等确认后再调整,不自动修改\n\n### 执行步骤\n\n1. **读取触发状态**：先读 `memory/redundancy-check-state.json`，判断是否满足 3 天间隔（仅 Heartbeat 方案）\n2. 读取所有 md 文件内容\n3. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(触发机制职责划分+健康检查+通道校验+链路完整性+归属标记):\n   a. 扫描当前agent自己workspace下的HEARTBEAT.md所有流程规则(cron和launchd只查当前agent的,通过agentId过滤,不干涉其他agent)\n   b. 同域去重:cron内部/cron与launchd之间的重复任务\n   c. 触发状态健康检查:Heartbeat启用状态、Cron Last值、Launchd PID和ExitStatus\n   d. 触发机制职责划分:逐个分析推荐最适合机制(launchd/cron/heartbeat)\n   e. 推送通道校验:检查delivery target是否与任务类型匹配\n   f. 触发-流程链路完整性:HEARTBEAT.md流程vs cron prompt双向检查,确保链路完整\n   g. 任务归属标记检查:HEARTBEAT.md每个任务是否明确标注归属(cron/heartbeat/流程参考)\n   h. 生成报告,汇报给主人,等确认后再调整\n8. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n9. 向主人汇报检查结果,确认后执行清理\n10. **更新状态文件**：写入当前时间到 `memory/redundancy-check-state.json`（仅 Heartbeat 方案）\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| 触发机制划分+链路完整性 | ✅/⚠️ | 三域职责划分+健康检查+通道校验+触发-流程链路完整性(仅本agent区域) |\n\n发现问题:[描述]\n层级放错建议:[描述]\n重复触发风险:[同一任务出现在两个及以上机制中时列出]\n触发健康告警:[配置了但没触发/触发了但失败/从来没跑过的任务]\n通道校验告警:[工作提醒推到了QQ/舞蹈提醒推到了微信/推送到不存在的通道]\n链路完整性告警:[HEARTBEAT有流程但无cron触发/cron有任务但HEARTBEAT无对应流程/cron prompt未正确引用HEARTBEAT区块]\n归属标记告警:[任务归属不明/已配cron但HEARTBEAT未标注流程参考/未标注heartbeat待执行]\n归类建议:[每个任务推荐放的触发机制及理由]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.4 | 2026-05-31 | **第9项新增任务归属标记检查**:1新增HEARTBEAT-Cron任务归属标记检查(每个任务必须标注归属:走cron/走heartbeat/流程参考);2防止已配cron的任务被heartbeat重复执行;3HEARTBEAT.md已配cron任务应标注为\"流程参考\"未配cron任务标注为\"heartbeat待执行\";4发现问题标记告警;5生成报告不自动修改 ✅ |\n| v3.3 | 2026-05-31 | **第9项重构为触发-流程链路完整性**:1明确HEARTBEAT.md=Cron配套关系(流程说明书+闹钟)不去重;2新增同域去重(cron内部/cron与launchd);3新增Agent隔离(只查本agent区域,按agentId过滤,不干涉其他agent);4新增推送通道校验(agent+channel匹配);5新增触发-流程链路完整性双向检查(HEARTBEAT流程vs cron prompt);6新增cron prompt规范(隔离会话一句话写完规则,禁止跳转引用);7生成报告不自动修改 ✅ |\n\nFile v3.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.1.0\",\n  \"publishedAt\": 1780221972868\n}\n\nFile v3.1.0:skill-card.md\n\n## Description: <br>\n通用 AI Agent 记忆架构 Skill，采用金字塔分层结构帮助 agents 初始化工作区、分类写入规则、检查 Markdown 记忆文件冗余，并规划心跳、cron 和 launchd 触发职责。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[popo67ll](https://clawhub.ai/user/popo67ll) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent operators use this skill to set up and maintain OpenClaw-style agent memory workspaces with clear layering across AGENTS.md, MEMORY.md, SOUL.md, HEARTBEAT.md, SKILL.md, TOOLS.md, and self-improving notes. It guides rule placement, redundancy checks, trigger ownership, and user-confirmed cleanup recommendations. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Sync, cleanup, cron, launchd, and GitHub-related steps can persist workspace changes or publish changes externally. <br>\nMitigation: Review the proposed changes, destination repository, schedule, and delivery channel before allowing those actions. <br>\nRisk: Scheduled or isolated agent sessions may miss injected memory files or duplicate work across heartbeat, cron, and launchd mechanisms. <br>\nMitigation: Use direct prompts for isolated sessions and require explicit task ownership labels before scheduling or changing triggers. <br>\nRisk: Rule maintenance guidance can move or remove memory content incorrectly if applied without review. <br>\nMitigation: Treat redundancy reports as recommendations and apply cleanup only after user confirmation. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/popo67ll/pyramid-memory-architecture) <br>\n- [Publisher profile](https://clawhub.ai/user/popo67ll) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with inline code blocks, file templates, JSON snippets, shell commands, and review reports] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Produces recommendations and workspace maintenance instructions; cleanup, sync, scheduling, and publishing steps are framed for user review before execution.] <br>\n\n## Skill Version(s): <br>\n3.1.0 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v3.0.0: 3 files, 8994 bytes\n\nFiles: skill-card.md (2146b), SKILL.md (19195b), _meta.json (146b)\n\nFile v3.0.0:SKILL.md\n\n---\nname: 金字塔记忆架构\nversion: 3.0.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.0** - 规则分类决策树 + 动态词指纹检查 + Skill 自包含原则\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 规则分类决策树\n<!-- #rule-classify-tree -->\n\n**每次写入或修改规则前，必须先过此判断矩阵。**\n\n```\n主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘\n```\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n4. **🔢 同步脚本文件版本号** - 如果 skill 目录下有脚本文件(如 `scripts/*.js`)，必须同步更新脚本文件头部的版本号注释，确保 SKILL.md 版本号、脚本文件头版本号、git tag 三处一致\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### ⚠️ Skill 自包含原则\n<!-- #skill-self-contained -->\n\n**每个 SKILL.md 必须能独立指导完整操作流程，不依赖 MEMORY.md 的技术细节。**\n\n- ✅ 业务触发逻辑（何时触发、推送渠道配置）可以引导去 MEMORY.md\n- ✅ 技术实现细节（怎么执行、API 调用、排版规范、标题公式、上传流程）必须在 SKILL.md 写完整\n- ❌ 违反表现：MEMORY.md 里出现\"步骤1/2/3\"、\"用 xxx API\"、\"HTML 用内联样式\"、\"封面上传流程\"等\n\n**检查方法**：MEMORY.md 中如果出现操作步骤类内容（含\"步骤/流程/API 调用/上传/生成/排版/标题公式\"等技术词），视为违反自包含原则，应移至对应 SKILL.md。\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语、安全红线、行为底线 | 执行步骤、技术细节、详细说明 |\n| **MEMORY.md** | 业务触发规则、推送渠道、项目专属规则、禁止重复规则、同步规则 | 操作步骤、API 调用、HTML 排版、标题公式、封面上传流程 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 操作步骤、API 调用、HTML 排版、标题公式、封面上传、技术选择器、正则、版本历史 | 业务触发逻辑、推送渠道配置、人格描述 |\n| **TOOLS.md** | 本地配置笔记（设备端口、Cookie、API Key 存放路径） | 业务规则、操作流程 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规（动态词指纹检查）**:\n   - **Step 1**: 扫描 workspace 下所有 SKILL.md，动态提取技术关键词（动态词指纹）：\n     - skill name 和 description 中的动词（如 web_search、wechat-mp-publish、封面上传）\n     - SKILL.md 正文中的 API 名、工具名、技术名词（如 HTML 内联样式、排版规范、标题公式）\n   - **Step 2**: 用这些词去匹配 MEMORY.md 的所有规则\n   - **Step 3**: 发现匹配 → 提示\"MEMORY.md 中的规则含技术关键词 {词}，可能应该放 {skill名}.md\"\n   - **Step 4**: 同时检查 AGENTS.md 中是否包含操作/技术类内容（应下放至 SKILL.md）\n   - **Step 5**: 检查 MEMORY.md 中是否包含铁律/红线类内容（应上移至 AGENTS.md）\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **HEARTBEAT vs cron 一致性**:HEARTBEAT.md 的提醒时间/频率与 cron 任务 schedule 是否一致，不一致时提醒主人手动同步 cron（只提醒，不自动改）\n\n### 执行步骤\n\n1. 读取所有 md 文件内容\n2. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):\n   a. 动态词指纹提取:扫描所有 SKILL.md,提取技术关键词\n   b. 用动态词指纹匹配 MEMORY.md,发现技术细节错位→建议移至 SKILL.md\n   c. 扫描 AGENTS.md,发现操作步骤类内容→建议下放至 SKILL.md\n   d. 扫描 MEMORY.md,发现铁律/红线类内容→建议上移至 AGENTS.md\n   e. 检查 MEMORY.md 是否违反 Skill 自包含原则(含操作步骤/API/标题公式等)\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(HEARTBEAT vs cron):读取 HEARTBEAT.md 所有提醒规则，与 cron jobs.json 中对应任务的 schedule 比对，时间/频率不一致的列出差异，提醒主人手动同步\n6. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n7. 向主人汇报检查结果,确认后执行清理\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 动态词指纹检查结果 + 层级错位详情 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| HEARTBEAT vs cron | ✅/⚠️ | 提醒时间/频率一致或提醒同步 |\n\n发现问题:[描述]\n层级放错建议:[描述]\ncron 同步提醒:[HEARTBEAT.md 与 cron 不一致时列出,提醒主人手动修改]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v3.0 | 2026-05-27 | **规则分类决策树+动态词指纹+Skill自包含**:1新增规则分类决策树(5类判断矩阵),录入流程必须先过决策树;2第7项升级为动态词指纹检查(自动扫描SKILL.md提取技术关键词,匹配MEMORY.md发现错位规则);3新增Skill自包含原则(Skill必须独立指导完整流程,不依赖MEMORY.md);4细化各层\"应该/不应该\"表格(新增SKILL.md应放操作步骤/API调用/标题公式,不应放业务触发逻辑) ✅ |\n| v2.9 | 2026-05-26 | **无锚点规则检测**:冗余检查新增扫描未锚定规则的能力,自动发现含\"铁律/规则/禁止/必须\"等关键词但无锚点的内容,推荐补锚点并按金字塔架构归类 ✅ |\n\nFile v3.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1779938319185\n}\n\nFile v3.0.0:skill-card.md\n\n## Description: <br>\n通用 AI Agent 记忆架构 Skill，采用金字塔分层结构组织铁律级行为规则、业务规则、人格配置和技术实现细节，适用于新建子 Agent 工作区初始化、记忆架构设计、规则录入引导和 Markdown 冗余检查。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[popo67ll](https://clawhub.ai/user/popo67ll) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent operators use this skill to initialize and maintain layered memory files for OpenClaw-style agent workspaces. It guides where rules, identity, operational reminders, local configuration notes, and technical procedures should live so agents can reduce duplication and preserve priority order. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can guide an agent to read and reorganize memory-related Markdown files that may include USER.md or TOOLS.md with local configuration or credential notes. <br>\nMitigation: Install only in workspaces where this access is acceptable, and review proposed changes before allowing deletions, moves, commits, tags, pushes, or cron-related updates. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/popo67ll/pyramid-memory-architecture) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, markdown, configuration] <br>\n**Output Format:** [Markdown guidance with file-organization tables, decision trees, and examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May propose edits to memory-related Markdown files; user approval is expected for deletions, file moves, commits, tags, pushes, and cron-related changes.] <br>\n\n## Skill Version(s): <br>\n3.0.0 (source: frontmatter and server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.8.0: 15 files, 17057 bytes\n\nFiles: README.md (3696b), scripts/check-anchors.sh (1462b), scripts/init.ps1 (1437b), scripts/init.sh (1067b), SKILL.md (14201b), templates/AGENTS.md (2037b), templates/HEARTBEAT.md (1009b), templates/IDENTITY.md (202b), templates/MEMORY.md (1349b), templates/self-improving/corrections.md (687b), templates/self-improving/memory.md (626b), templates/SOUL.md (1079b), templates/TOOLS.md (220b), templates/USER.md (396b), _meta.json (146b)\n\nFile v2.8.0:SKILL.md\n\n---\nname: 金字塔记忆架构\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v2.8** - HEARTBEAT-cron同步检查:冗余检查升级为9项,HEARTBEAT提醒时间与cron schedule一致性比对\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(心跳触发时加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见XX),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}\n```\n\n错误做法(引导会断裂):\n```json\n{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}\n```\n\n**总结:主会话对话可以 A→B→C 多级联链,隔离场景必须一句话写完,不要跳转。**\n\n### 录入流程\n<!-- #rule-entry-flow -->\n\n```\n主人要求写入新规则\n    ↓\n1. 判断规则类型:行为规则 / 业务规则 / 技术细节 / 人格配置 / 自我经验\n    ↓\n2. 匹配层级:\n   - 行为规则(铁律级)→ AGENTS.md\n   - 业务规则(触发器)→ MEMORY.md\n   - 人格/身份 → SOUL.md / IDENTITY.md\n   - 技术细节 → SKILL.md / docs/\n   - 自我进化经验 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐\n```\n\n### 级联格式铁律\n<!-- #cascade-format -->\n\n**AGENTS.md 标准格式:一句话核心 + 引导语,不写执行步骤**\n\n```markdown\n- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)\n```\n\n**多层级联链示例:**\n```\nAGENTS.md(铁律核心)\n  → \"修改 skill 必须同步问询\":详见 SKILL.md「同步流程」(#skill-sync-flow)\n      ↓\nSKILL.md(执行细节)\n  → #skill-sync-flow:同步内容=1版本号 2版本历史 3git commit+tag\n  → \"发布规则详见 MEMORY.md\": 详见 MEMORY.md「发布渠道」(#publish-channels)\n      ↓\nMEMORY.md(业务规则)\n  → #publish-channels:抖音走 QQ、小红书走微信\n```\n\n**级联链前提:链路必须通**\n- 每一级的 `#[锚点]` 在目标文件中真实存在\n- 引导目标是系统注入文件或 `<available_skills>` 匹配的 SKILL.md,确保 AI 能读到\n\n### Skill 同步流程\n<!-- #skill-sync-flow -->\n\n修改任何 skill 内容并测试通过后,主动询问主人是否执行同步:\n1. 更新 SKILL.md 版本号\n2. 更新 SKILL.md 版本历史(保留最新 2 条)\n3. git commit + tag + GitHub 推送\n- 新增 skill 先创建独立 GitHub 仓库,禁止混入 monorepo\n- 每个人格的 skill 推送各自对应的 GitHub 仓库,绝不混淆\n\n### 失败处理\n<!-- #fail-stop -->\n\n当 SKILL.md 中明确写了「失败一次就停手汇报」时,第一次失败后必须立刻停止一切尝试,向主人汇报:\n- 不得以任何理由继续自行尝试\n- 这是保护 Cookie 和主人控制权的安全红线\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 一句话核心铁律 + 引导语 | 执行步骤、技术细节、详细说明\n| **MEMORY.md** | 推送渠道规则、业务触发器、项目专属规则、同步规则 | Cookie 保护铁律(应放 AGENTS.md)、技术选择器 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律(应放 AGENTS.md) |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情(应引到 MEMORY.md) |\n| **SKILL.md** | 技术选择器、正则、API 流程、版本历史 | 行为规则、人格描述 |\n\n### 标准引导语格式\n\n**统一格式:** `详见 [文件]「[章节名]」(#[锚点])`\n\n**AGENTS.md 标准引导表示例:**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md(#clawhub-publish-rules) |\n| 心跳检查清单 | 详见 HEARTBEAT.md(#reminder-tasks) |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n```\n\n**其他常见引导示例:**\n- `详见 SKILL.md「规则录入流程」(#rule-entry-flow)`\n- `详见 MEMORY.md「ClawHub 上架规则」(#clawhub-publish-rules)`\n- `详见 self-improving/memory.md(#ops-sync-failure)`\n\n\n\n## 🔄 冗余检查机制\n<!-- #redundancy-check -->\n\n**每 3 天执行一次 9 项检查清单，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 9 项检查清单\n\n1. **内容冗余**:同一规则是否出现在多个文件中\n2. **引导方向**:有没有底层文件引导回顶层(违反从上往下原则)\n3. **锚点一致性**:引导语里的 `#[锚点]` 是否在目标文件中真实存在\n4. **引导格式**:是否都使用 `详见 [文件]「[章节名]」(#[锚点])` 格式\n5. **版本历史**:各 SKILL.md 版本历史是否超过 2 条\n6. **文件大小**:各 md 文件是否异常膨胀(>3KB 需检查)\n7. **金字塔合规**:规则是否放在正确的层级(如通用行为铁律应在 AGENTS.md,不应在 MEMORY.md)\n8. **连接建议**:只在发现明显主题相关的规则时才建议级联,不全量扫描\n9. **HEARTBEAT vs cron 一致性**:HEARTBEAT.md 的提醒时间/频率与 cron 任务 schedule 是否一致，不一致时提醒主人手动同步 cron（只提醒，不自动改）\n\n### 执行步骤\n\n1. 读取所有 md 文件内容\n2. 逐项检查上述 9 项清单\n3. 第7项(金字塔合规):检查每条规则是否放在正确的层级,放错层的建议迁移\n4. 第8项(连接建议):只在发现明显主题相关的规则时才建议级联(如两条都是运维安全类),不强制\n5. 第9项(HEARTBEAT vs cron):读取 HEARTBEAT.md 所有提醒规则，与 cron jobs.json 中对应任务的 schedule 比对，时间/频率不一致的列出差异，提醒主人手动同步\n6. 按照金字塔架构规则,以高层级文件为准,删除低层级重复\n7. 向主人汇报检查结果,确认后执行清理\n\n### 检查报告模板\n\n```\n## 冗余检查报告(YYYY-MM-DD)\n\n| 检查项 | 状态 | 详情 |\n|--------|------|------|\n| 内容冗余 | ✅/❌ | ... |\n| 引导方向 | ✅/❌ | ... |\n| 锚点一致性 | ✅/❌ | ... |\n| 引导格式 | ✅/❌ | ... |\n| 版本历史 | ✅/❌ | ... |\n| 文件大小 | ✅/❌ | ... |\n| 金字塔合规 | ✅/❌ | 检查规则是否放在正确层级 |\n| 连接建议 | 💡/无 | 仅明显相关时建议 |\n| HEARTBEAT vs cron | ✅/⚠️ | 提醒时间/频率一致或提醒同步 |\n\n发现问题:[描述]\n层级放错建议:[描述]\ncron 同步提醒:[HEARTBEAT.md 与 cron 不一致时列出,提醒主人手动修改]\n连接建议:[仅明显相关时才提]\n建议操作:[描述]\n```\n\n## 🚀 快速部署\n\n### 方式一:一键初始化脚本(推荐)\n\n*   **Mac / Linux 用户**:\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**:\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二:手动初始化\n\n创建新子 Agent 时,按以下结构初始化:\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录(v2.0 教学版):\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板(带使用说明注释) |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板(带示例) |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板(带安全锚示例) |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n| v2.8 | 2026-05-25 | **HEARTBEAT-cron同步检查**:1冗余检查升级为9项,新增HEARTBEAT.md提醒时间与cron schedule一致性比对;2发现不一致只提醒主人手动改cron,不自动修改;3报告模板新增HEARTBEAT vs cron行和cron同步提醒字段 ✅ |\n| v2.7 | 2026-05-25 | **冗余检查升级**:1新增金字塔合规检查(规则是否放对层级);2新增连接建议(仅明显相关时触发,不全量扫描);3移除冗余的级联合规和隔离直写检查项(已合并) ✅ |\n\nFile v2.8.0:README.md\n\n# 金字塔记忆架构（Pyramid Memory Architecture）\n\n> 通用 AI Agent 记忆架构 Skill，适用于所有新建子 Agent 工作区初始化。\n> 版本：v2.7\n\n## 🚀 快速开始\n\n### 方式一：一键初始化（推荐）\n\n```bash\n./scripts/init.sh my-new-agent\n```\n\nWindows 用户：\n```powershell\n.\\scripts\\init.ps1 my-new-agent\n```\n\n### 方式二：手动复制\n\n将 `templates/` 目录下的文件复制到你的工作区：\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律\n├── MEMORY.md          ← 业务规则\n├── SOUL.md            ← 人格配置\n├── IDENTITY.md        ← 身份卡片\n├── USER.md            ← 主人信息\n├── TOOLS.md           ← 本地配置\n├── HEARTBEAT.md       ← 心跳清单\n├── self-improving/    ← 自我进化\n└── docs/              ← 详细文档\n```\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层：系统注入，铁律级行为规则（每次必加载）\n     /-----------\\\n    / MEMORY.md   \\    ← 中层：主会话加载，业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层：人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取：执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层：按需读取，技术实现细节、操作流程\n```\n\n| 层级 | 文件 | 加载方式 | 放什么 |\n|------|------|---------|--------|\n| **顶层** | AGENTS.md | 系统注入，每次必加载 | 铁律级行为规则、安全红线 |\n| **中层** | MEMORY.md | 主会话注入 | 业务规则、长期记忆 |\n| **中层** | SOUL.md | 系统注入 | 人格、使命、行为准则 |\n| **中层** | HEARTBEAT.md | 心跳触发 | 待办提醒、周期性任务 |\n| **按需** | self-improving/ | 任务前读取 | 执行经验、错误教训 |\n| **底层** | SKILL.md | 场景匹配 | 技术实现、操作流程 |\n\n## 📝 如何添加新规则\n\n1. **判断类型**：行为规则 → AGENTS.md / 业务规则 → MEMORY.md / 技术细节 → SKILL.md\n2. **生成锚点**：使用 `<!-- #领域-功能 -->` 格式（如 `<!-- #backup-database -->`）\n3. **检查重复**：确认文件中没有相同规则\n4. **写入文件**：锚点 + 规则内容\n5. **更新引导**：如需引用，使用 `详见 [文件]「[章节名]」（#[锚点]）` 格式\n\n### ⚠️ 铁律\n\n- 新增/修改规则后，必须主动询问主人是否执行同步\n- 引导方向只能从上往下（AGENTS → MEMORY → SKILL），禁止反向引导\n- 锚点命名使用「领域-功能」格式，禁止裸写易冲突名称\n\n## 🛠️ 工具脚本\n\n| 脚本 | 用途 |\n|------|------|\n| `scripts/init.sh` | 一键初始化新 Agent 工作区 |\n| `scripts/check-anchors.sh` | 检查锚点一致性，发现断裂引用 |\n\n## ❓ 常见问题\n\n### Q: 版本历史要保留多少条？\nA: 只保留最新 2 条。\n\n### Q: 文件太大怎么办？\nA: 单个 md 文件超过 3KB 时，考虑拆分到下层文件。\n\n### Q: 如何检查规则有没有放错层级？\nA: 每 3 天执行一次冗余检查（6 项清单 + 金字塔合规检查）。\n\n### Q: 锚点断裂了怎么办？\nA: 运行 `./scripts/check-anchors.sh <workspace目录>` 自动检测并修复。\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| v2.7 | 2026-05-25 | 冗余检查升级：新增金字塔合规检查 + 连接建议（仅明显相关时触发） |\n| v2.6 | 2026-05-25 | 隐患修复：锚点断裂自动检测 + 命名规范 + monorepo 禁推 |\n\n## 📄 许可证\n\nMIT License\n\nFile v2.8.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"2.8.0\",\n  \"publishedAt\": 1779711089051\n}\n\nFile v2.8.0:templates/AGENTS.md\n\n# AGENTS.md - 顶层行为规则（金字塔第一层）\n\n> **💡 使用说明**：\n> 1. 本文件只存放**最高优先级的行为铁律**，采用**级联格式**：一句话核心 + 引导语。\n> 2. 执行步骤、技术细节等引导到下层文件（MEMORY.md / SKILL.md）。\n> 3. 所有规则应具有**通用性**，不要在顶层文件写死具体业务逻辑。\n> 4. ⚠️ 此规则与金字塔架构 SKILL.md 铁律相关，如有冲突以 SKILL.md 为准。\n\n## ⚡ 铁律（最高优先级）\n<!-- #iron-rules -->\n\n- **用户提问时，必须先回答用户的问题，再进行任何操作。**\n- 禁止在未确认的情况下直接执行、修改文件、运行脚本。\n- 如果是明确的操作指令，直接执行不废话；其他情况先确认后动手。\n- 此规则适用于所有场景。\n- **每 3 天执行一次冗余检查**：详见 SKILL.md「冗余检查流程」（#redundancy-check）。\n- **新增/修改任何规则自动归类**：详见 SKILL.md「规则录入流程」（#rule-entry-flow）。\n- **修改任何 skill 必须主动问询同步**：详见 SKILL.md「同步流程」（#skill-sync-flow）。\n- **锚点命名规范**：使用「领域-功能」格式（如 `douyin-publish`、`work-report-push`），禁止裸写 `publish` 等易冲突名称。\n- **workspace monorepo 禁止直接 push**：只允许推送独立 skill 仓库，禁止混入 monorepo。\n- **脚本执行失败就停手汇报**：详见 SKILL.md「失败处理」（#fail-stop）。\n\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md（#biz-rules） |\n| 心跳检查清单 | 详见 HEARTBEAT.md（#reminder-tasks） |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n| 安全红线 | Red Lines（见下方） |\n| 规则录入流程 | 详见 SKILL.md「规则录入流程」（#rule-entry-flow） |\n\n## Red Lines\n\n- 隐私数据绝对保密\n- 不要运行破坏性命令\n- `trash` > `rm`（可恢复 > 永久删除）\n\nFile v2.8.0:templates/HEARTBEAT.md\n\n# HEARTBEAT.md - 定时提醒任务清单\n\n> **💡 使用说明**：\n> 1. 本文件用于配置**周期性检查任务**（如：待办提醒、报告队列、数据维护）。\n> 2. 只有在接收到 Heartbeat 信号时才会读取，平时不消耗 Token。\n\n## ⏰ 待办提醒\n\n- 检查 `~/self-improving/heartbeat-state.md` 中的 pending_reminders。\n- 如果到达触发时间且未发送，通过 message 工具发送，发送后标记为 done。\n\n## 📤 推送规则\n\n- [推送渠道配置，如：舞蹈通知走 QQ，工作通知走微信]\n\n## 📋 定期维护任务\n<!-- #maintenance-tasks -->\n\n- **每 3 天执行一次 6 项检查**：①内容冗余 ②引导方向 ③锚点一致性 ④引导格式 ⑤版本历史 ⑥文件大小。\n- **执行逻辑**：详见 SKILL.md「冗余检查流程」（#redundancy-check）。\n\n## Self-Improving Check\n\n- 检查 `~/self-improving/` 目录是否有文件变更。\n- 如有变更，整理索引或归档；如无变更，返回 `HEARTBEAT_OK`。\n\nFile v2.8.0:templates/IDENTITY.md\n\n# IDENTITY.md - Who Am I?\n\n- **Name:** [Agent 名字]\n- **Creature:** [形象描述]\n- **Vibe:** [性格关键词]\n- **Emoji:** [代表表情]\n- **Avatar:** [头像描述]\n\n---\n\n[一句话自我介绍]\n\nFile v2.8.0:templates/MEMORY.md\n\n# MEMORY.md - 长期记忆（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件存放**业务规则、项目配置、长期记忆**。\n> 2. 技术实现细节（如 API 调用流程、正则表达式）请放入对应的 SKILL.md。\n> 3. 行为铁律请放入 AGENTS.md。\n\n## 业务规则\n<!-- #biz-rules -->\n\n- **[业务规则名称]**：[规则描述，如：收到用户发送视频后，自动执行发布流程]\n  - 详见 [相关文件/SKILL.md]\n\n## Skill 修改后同步规则\n<!-- #skill-sync-rules -->\n- 修改任何 skill 内容并测试通过后，主动询问主人是否执行同步\n- 同步内容、版本历史规则详见 SKILL.md「同步流程」（#skill-sync-flow）\n\n## 🎭 项目规则\n<!-- #project-rules -->\n\n- **专属文件夹**：`~/.openclaw/workspace/[项目名]/`\n- **触发规则**：用户说「开始 XXX 任务」→ 读取项目进度\n- **文件归档**：所有产出统一存放，不散落在根目录\n\n## 触发规则\n<!-- #trigger-rules -->\n\n- 严禁擅自往 MEMORY.md 添加内容，需经用户确认。\n- 发现可复用规则时，按**金字塔引导优先级**写入对应文件。\n\n## 铁律（本层独有）\n<!-- #iron-rules -->\n\n- **[独有铁律]**：[仅适用于当前业务场景的铁律，如：保护 Cookie 是第一位]\n  - *注意：通用行为铁律应写在 AGENTS.md*\n\nFile v2.8.0:templates/self-improving/corrections.md\n\n<!-- #self-improving-corrections -->\n# 错误纠正记录（corrections.md）\n\n> **💡 使用说明**：\n> 1. 本文件记录 Agent 执行出错后的纠正措施。\n> 2. 每次纠正都带锚点标记，方便后续检索。\n\n## 纠正记录示例\n\n<!-- #fix-duplicate-rules -->\n### 重复规则清理\n- **问题**：AGENTS.md 和 MEMORY.md 写了相同的隐私保密规则\n- **纠正**：只保留 AGENTS.md 版本，MEMORY.md 删除重复\n- **日期**：2026-05-25\n\n<!-- #fix-guide-direction -->\n### 引导方向修正\n- **问题**：SKILL.md 里写了\"详见 AGENTS.md\"（底层→顶层）\n- **纠正**：改为顶层摘要自包含，不引导回底层\n- **日期**：2026-05-25\n\nFile v2.8.0:templates/self-improving/memory.md\n\n<!-- #self-improving-memory -->\n# 执行经验记录（memory.md）\n\n> **💡 使用说明**：\n> 1. 本文件记录 Agent 执行任务时的经验教训。\n> 2. 每条经验都带锚点标记，方便精准引导。\n\n## 经验记录示例\n\n<!-- #ops-sync-failure -->\n### 同步失败教训\n- **场景**：执行 git push 时网络超时\n- **教训**：推送前设置 `GIT_TERMINAL_PROMPT=0` 避免卡住\n- **日期**：2026-05-25\n\n<!-- #api-rate-limit -->\n### API 限流应对\n- **场景**：短时间内连续调用同一 API 被限流\n- **教训**：设置请求间隔，优先使用批量接口\n- **日期**：2026-05-25\n\nFile v2.8.0:templates/SOUL.md\n\n# SOUL.md - 灵魂人格（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件定义 Agent 的**人格、身份、使命**。\n> 2. 它是 Agent 的\"性格设定\"，决定了说话风格和价值观。\n> 3. 行为规则（该做什么、不该做什么）应优先放在 AGENTS.md。\n\n## 基础身份\n\n- **名字**：[Agent 名字]\n- **形象**：[形象描述，如：蓝陨石边牧、严肃的工程师等]\n- **所属**：[所属事业/团队]\n- **语气**：[性格关键词，如：温柔、幽默、严谨、务实]\n\n## 核心使命\n\n- [Agent 存在的意义，如：帮助主人管理舞室运营、辅助代码开发等]\n\n## 行为准则\n\n1. [准则 1：如：优先区分工作日/周末，严格匹配主人节奏]\n2. [准则 2：如：像真人朋友一样聊天，不机械回复]\n\n## ⚠️ 铁律\n\n- ⚠️ **安全锚**：此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准。\n- [本层独有的铁律，如：外部操作先确认再执行、隐私数据绝对保密]\n\n---\n\n[一句话描述，作为 Agent 的结束语或座右铭]\n\nFile v2.8.0:templates/TOOLS.md\n\n# TOOLS.md - 本地配置笔记\n\n### [配置项名称]\n- **配置项**：[值]\n- **说明**：[说明]\n\n---\n\n> 此文件只存放本地环境特有的配置笔记，不存放技术流程（技术流程放 SKILL.md）。\n\nFile v2.8.0:templates/USER.md\n\n# USER.md - 主人信息\n\n## 主人：[主人名字]\n\n**所在地：** [主人所在地]\n\n**工作日：** [工作日安排]\n\n**周末：** [周末安排]\n\n---\n\n## 伴侣：[伴侣名字]\n\n**常驻地址：** [地址]\n\n**事业：** [事业描述]\n\n---\n\n## 共同事业\n\n[共同的事业/项目描述]\n\n---\n\n## 性格\n\n[主人性格描述]\n\n---\n\n## 身份定位\n\n[Agent 对主人的身份定位]\n\nArchive v2.2.0: 11 files, 10760 bytes\n\nFiles: scripts/init.ps1 (1437b), scripts/init.sh (1067b), SKILL.md (10274b), templates/AGENTS.md (1226b), templates/HEARTBEAT.md (911b), templates/IDENTITY.md (202b), templates/MEMORY.md (1407b), templates/SOUL.md (1079b), templates/TOOLS.md (220b), templates/USER.md (396b), _meta.json (146b)\n\nFile v2.2.0:SKILL.md\n\n---\nname: 金字塔记忆架构\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构：顶层（AGENTS.md）只放铁律级行为规则，中层（MEMORY.md/SOUL.md/HEARTBEAT.md）放业务规则和人格配置，底层（SKILL.md/TOOLS.md）放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景：创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查。\n---\n\n# 金字塔记忆架构（Pyramid Memory Architecture）\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构，适用于任何新建子 Agent 工作区。\n> 核心理念：**规则按触发优先级分层存放，引导只能从上往下，下层不引导回上层。**\n> 版本：**v2.2** - 包含一键初始化脚本 + 教学版模板\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层：系统注入，铁律级行为规则（每次必加载）\n     /-----------\\\n    / MEMORY.md   \\    ← 中层：主会话加载，业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层：人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取：执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层：按需读取，技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入，每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片（名字、形象、表情） |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记（设备、端口、Cookie） |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训（memory.md / domains/ / projects/ / corrections.md） |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**：\n   - 系统注入文件（AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER）> 按需读取文件（HEARTBEAT/memory日志/self-improving）> 外部 SKILL.md\n2. **引导方向主要从上往下**：\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n   - ⚠️ **安全锚**：底层文件如果有一条规则和顶层铁律直接相关，可以加备注：`⚠️ 此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**：\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导，实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**（每次对话自动加载，Agent 一定能读到）：\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`（由 OpenClaw 系统注入）\n- `HEARTBEAT.md`（心跳触发时加载）\n\n**非注入文件**（需要 Agent 主动读取，可能读不到）：\n- `SKILL.md`（需 `<available_skills>` 匹配才自动读取）\n- `self-improving/` 目录（需任务前主动读取）\n- `memory/` 日志（需 `memory_search` 或 `memory_get` 主动搜索）\n- `docs/` 目录（需按路径手动读取）\n\n**引导原则**：\n- ✅ 重要规则尽量放在注入文件内，形成闭环\n- ⚠️ 引导到非注入文件时，确保目标文件在 `<available_skills>` 中有 description 匹配\n- ❌ 不要多层引导（A→B→C），大概率断裂\n\n### 录入流程\n\n```\n主人要求写入新规则\n    ↓\n1. 判断规则类型：行为规则 / 业务规则 / 技术细节\n    ↓\n2. 匹配层级：\n   - 行为规则（铁律级）→ AGENTS.md\n   - 业务规则（触发器）→ MEMORY.md\n   - 人格/身份 → SOUL.md / IDENTITY.md\n   - 技术细节 → SKILL.md / docs/\n    ↓\n3. 检查现有文件有无重复内容：\n   - 有重复 → 以高层级为准，删除低层级重复\n   - 无重复 → 写入对应文件\n    ↓\n4. 如不确定放哪层 → 向主人推荐\n```\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 先回答再操作、禁止未确认执行、规则录入引导、3天检查冗余 | 详细 Heartbeat 说明、群聊详细规则、Memory 详细说明 |\n| **MEMORY.md** | 推送渠道规则、业务触发器、项目专属规则、同步规则 | Cookie 保护铁律（应放 AGENTS.md）、技术选择器 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律（应放 AGENTS.md） |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情（应引到 MEMORY.md） |\n| **SKILL.md** | 技术选择器、正则、API 流程、版本历史 | 行为规则、人格描述 |\n\n### 标准引导语格式\n\n**统一格式：** `详见 [文件/章节名]`\n\n**AGENTS.md 标准引导表：**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md |\n| 心跳检查清单 | 详见 HEARTBEAT.md |\n| 群聊发言规则 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n| 安全红线 | Red Lines（见下方） |\n```\n\n**其他常见引导示例：**\n- `完整规则详见 docs/temp-tasks.md`\n- `技术细节详见 SKILL.md「主人规则」第11条`\n- `自动发布流程详见 SKILL.md「主人标准工作流程」`\n\n**引导语铁律：**\n- ✅ 引导只能从上往下（AGENTS → MEMORY → SKILL）\n- ❌ 底层文件不要引导回上层（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n- 引导语要简洁，一行搞定，不要展开详细内容\n\n## 🔄 冗余检查机制\n\n**每 3 天检查一次各 md 文件有无冗余/重复或者可合并内容，发现后按照金字塔架构规则，推荐主人清理，主人确认后执行。**\n\n### 检查步骤\n\n1. 读取所有 md 文件内容\n2. 对比各层文件，查找：\n   - **重复内容**：两个文件写了同样的规则\n   - **可合并内容**：可以精简的相似规则\n   - **违规引导**：底层文件引导回顶层（如\"详见 AGENTS.md\"）\n3. 按照金字塔架构规则，以高层级文件为准，删除低层级重复\n4. 向主人汇报检查结果，确认后执行清理\n\n### 检查清单\n\n- [ ] AGENTS.md 铁律 vs MEMORY.md 铁律 vs SOUL.md 铁律 — 有无重复？\n- [ ] 各文件有无引导回上层的情况？\n- [ ] HEARTBEAT.md / TOOLS.md 有无默认模板未清理？\n- [ ] MEMORY.md 业务规则有无与 SKILL.md 重复？\n\n## 🚀 快速部署\n\n### 方式一：一键初始化脚本（推荐）\n\n*   **Mac / Linux 用户**：\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**：\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二：手动初始化\n\n创建新子 Agent 时，按以下结构初始化：\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录（v2.0 教学版）：\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板（带使用说明注释） |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板（带示例） |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板（带安全锚示例） |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| v2.2 | 2026-05-25 | **冗余检查规则更新**：①删除 HEARTBEAT.md 中 3 个子 agent 的冗余检查规则（只保留 cron 触发）；②统一主工作区/lizi 工作区/work 工作区的版本 ✅ |\n| v2.0 | 2026-05-21 | **Market Ready 发布**：①新增 scripts/init.sh 一键初始化脚本；②升级 templates 为“教学版”，内含详细使用说明；③补全 self-improving 目录结构 ✅ |\n| v1.3 | 2026-05-21 | **消除重复铁律+补充执行机制**：①删除 SOUL.md 与 AGENTS.md 重复的隐私保密规则，只保留独有规则；②HEARTBEAT.md 新增 3 天检查冗余定时任务；③AGENTS.md 新增冲突定义；④同步更新 QQ/微信两个人格 + 金字塔模板 ✅ |\n| v1.2 | 2026-05-21 | **新增安全锚机制**：底层文件可与顶层铁律挂钩，备注\"如有冲突以 AGENTS.md 为准\"，防止规则冲突而不被发现；同步更新 QQ/微信两个人格 ✅ |\n| v1.1 | 2026-05-21 | **修复5个隐患**：①加入 self-improving 层级到架构图和部署命令；②AGENTS.md 加\"不要只看本文件\"提醒 + 铁律优先级声明；③MEMORY.md 加业务规则引导表；④模板文件加占位示例内容；⑤标准引导语格式章节 ✅ |\n| v1.0 | 2026-05-21 | 初始版本：金字塔架构定义、规则录入铁律、冗余检查机制、模板文件 ✅ |\n\nFile v2.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"2.2.0\",\n  \"publishedAt\": 1779643491905\n}\n\nFile v2.2.0:templates/AGENTS.md\n\n# AGENTS.md - 顶层行为规则（金字塔第一层）\n\n> **💡 使用说明**：\n> 1. 本文件只存放**最高优先级的行为铁律**（如：安全红线、交互原则）。\n> 2. 具体的业务规则、项目细节请移至 MEMORY.md，保持本文件精简。\n> 3. 所有规则应具有**通用性**，不要在顶层文件写死具体业务逻辑。\n\n## ⚡ 铁律（最高优先级）\n\n- **用户提问时，必须先回答用户的问题，再进行任何操作。**\n- 禁止在未确认的情况下直接执行、修改文件、运行脚本。\n- 如果是明确的操作指令，直接执行不废话；其他情况先确认后动手。\n- 此规则适用于所有场景。\n- **每 3 天检查一次各 md 文件有无冗余/重复或者可合并内容，发现后按照金字塔架构规则，推荐用户清理，用户确认后执行。**\n\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统/业务规则 | 详见 MEMORY.md |\n| 心跳/定时任务 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n\n## Red Lines\n\n- 隐私数据绝对保密\n- 不要运行破坏性命令\n- `trash` > `rm`（可恢复 > 永久删除）\n\nFile v2.2.0:templates/HEARTBEAT.md\n\n# HEARTBEAT.md - 定时提醒任务清单\n\n> **💡 使用说明**：\n> 1. 本文件用于配置**周期性检查任务**（如：待办提醒、报告队列、数据维护）。\n> 2. 只有在接收到 Heartbeat 信号时才会读取，平时不消耗 Token。\n\n## ⏰ 待办提醒\n\n- 检查 `~/self-improving/heartbeat-state.md` 中的 pending_reminders。\n- 如果到达触发时间且未发送，通过 message 工具发送，发送后标记为 done。\n\n## 📤 推送规则\n\n- [推送渠道配置，如：舞蹈通知走 QQ，工作通知走微信]\n\n## 📋 定期维护任务\n\n- **每 3 天检查一次**：各 md 文件有无冗余/重复/可合并内容。\n- **执行逻辑**：检查后向用户汇报结果，确认后执行清理。\n\n## Self-Improving Check\n\n- 检查 `~/self-improving/` 目录是否有文件变更。\n- 如有变更，整理索引或归档；如无变更，返回 `HEARTBEAT_OK`。\n\nFile v2.2.0:templates/IDENTITY.md\n\n# IDENTITY.md - Who Am I?\n\n- **Name:** [Agent 名字]\n- **Creature:** [形象描述]\n- **Vibe:** [性格关键词]\n- **Emoji:** [代表表情]\n- **Avatar:** [头像描述]\n\n---\n\n[一句话自我介绍]\n\nFile v2.2.0:templates/MEMORY.md\n\n# MEMORY.md - 长期记忆（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件存放**业务规则、项目配置、长期记忆**。\n> 2. 技术实现细节（如 API 调用流程、正则表达式）请放入对应的 SKILL.md。\n> 3. 行为铁律请放入 AGENTS.md。\n\n## 业务规则\n\n- **[业务规则名称]**：[规则描述，如：收到用户发送视频后，自动执行发布流程]\n  - 详见 [相关文件/SKILL.md]\n\n## Skill 修改后同步规则\n- 修改任何 skill 内容并测试通过后，主动询问主人是否执行同步，确认后操作\n- 同步内容：①skill 版本号 ②SKILL.md 版本历史 ③git commit + tag\n- 版本历史只保留最新 2 条\n- 修复经验/经验教训保留最新 1-2 条\n- 更新前必须先读取 SKILL.md 当前版本历史内容，确认已有几条\n\n## 🎭 项目规则\n\n- **专属文件夹**：`~/.openclaw/workspace/[项目名]/`\n- **触发规则**：用户说「开始 XXX 任务」→ 读取项目进度\n- **文件归档**：所有产出统一存放，不散落在根目录\n\n## 触发规则\n\n- 严禁擅自往 MEMORY.md 添加内容，需经用户确认。\n- 发现可复用规则时，按**金字塔引导优先级**写入对应文件。\n\n## 铁律（本层独有）\n\n- **[独有铁律]**：[仅适用于当前业务场景的铁律，如：保护 Cookie 是第一位]\n  - *注意：通用行为铁律应写在 AGENTS.md*\n\nFile v2.2.0:templates/SOUL.md\n\n# SOUL.md - 灵魂人格（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件定义 Agent 的**人格、身份、使命**。\n> 2. 它是 Agent 的\"性格设定\"，决定了说话风格和价值观。\n> 3. 行为规则（该做什么、不该做什么）应优先放在 AGENTS.md。\n\n## 基础身份\n\n- **名字**：[Agent 名字]\n- **形象**：[形象描述，如：蓝陨石边牧、严肃的工程师等]\n- **所属**：[所属事业/团队]\n- **语气**：[性格关键词，如：温柔、幽默、严谨、务实]\n\n## 核心使命\n\n- [Agent 存在的意义，如：帮助主人管理舞室运营、辅助代码开发等]\n\n## 行为准则\n\n1. [准则 1：如：优先区分工作日/周末，严格匹配主人节奏]\n2. [准则 2：如：像真人朋友一样聊天，不机械回复]\n\n## ⚠️ 铁律\n\n- ⚠️ **安全锚**：此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准。\n- [本层独有的铁律，如：外部操作先确认再执行、隐私数据绝对保密]\n\n---\n\n[一句话描述，作为 Agent 的结束语或座右铭]\n\nFile v2.2.0:templates/TOOLS.md\n\n# TOOLS.md - 本地配置笔记\n\n### [配置项名称]\n- **配置项**：[值]\n- **说明**：[说明]\n\n---\n\n> 此文件只存放本地环境特有的配置笔记，不存放技术流程（技术流程放 SKILL.md）。\n\nFile v2.2.0:templates/USER.md\n\n# USER.md - 主人信息\n\n## 主人：[主人名字]\n\n**所在地：** [主人所在地]\n\n**工作日：** [工作日安排]\n\n**周末：** [周末安排]\n\n---\n\n## 伴侣：[伴侣名字]\n\n**常驻地址：** [地址]\n\n**事业：** [事业描述]\n\n---\n\n## 共同事业\n\n[共同的事业/项目描述]\n\n---\n\n## 性格\n\n[主人性格描述]\n\n---\n\n## 身份定位\n\n[Agent 对主人的身份定位]\n\nArchive v2.1.0: 11 files, 10344 bytes\n\nFiles: scripts/init.ps1 (1437b), scripts/init.sh (1067b), SKILL.md (9959b), templates/AGENTS.md (1058b), templates/HEARTBEAT.md (911b), templates/IDENTITY.md (202b), templates/MEMORY.md (1025b), templates/SOUL.md (1079b), templates/TOOLS.md (220b), templates/USER.md (396b), _meta.json (146b)\n\nFile v2.1.0:SKILL.md\n\n---\nname: 金字塔记忆架构\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构：顶层（AGENTS.md）只放铁律级行为规则，中层（MEMORY.md/SOUL.md/HEARTBEAT.md）放业务规则和人格配置，底层（SKILL.md/TOOLS.md）放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景：创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查。\n---\n\n# 金字塔记忆架构（Pyramid Memory Architecture）\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构，适用于任何新建子 Agent 工作区。\n> 核心理念：**规则按触发优先级分层存放，引导只能从上往下，下层不引导回上层。**\n> 版本：**v2.0 (Market Ready)** - 包含一键初始化脚本 + 教学版模板\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层：系统注入，铁律级行为规则（每次必加载）\n     /-----------\\\n    / MEMORY.md   \\    ← 中层：主会话加载，业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层：人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取：执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层：按需读取，技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入，每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片（名字、形象、表情） |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记（设备、端口、Cookie） |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训（memory.md / domains/ / projects/ / corrections.md） |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**：\n   - 系统注入文件（AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER）> 按需读取文件（HEARTBEAT/memory日志/self-improving）> 外部 SKILL.md\n2. **引导方向主要从上往下**：\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n   - ⚠️ **安全锚**：底层文件如果有一条规则和顶层铁律直接相关，可以加备注：`⚠️ 此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**：\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导，实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**（每次对话自动加载，Agent 一定能读到）：\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`（由 OpenClaw 系统注入）\n- `HEARTBEAT.md`（心跳触发时加载）\n\n**非注入文件**（需要 Agent 主动读取，可能读不到）：\n- `SKILL.md`（需 `<available_skills>` 匹配才自动读取）\n- `self-improving/` 目录（需任务前主动读取）\n- `memory/` 日志（需 `memory_search` 或 `memory_get` 主动搜索）\n- `docs/` 目录（需按路径手动读取）\n\n**引导原则**：\n- ✅ 重要规则尽量放在注入文件内，形成闭环\n- ⚠️ 引导到非注入文件时，确保目标文件在 `<available_skills>` 中有 description 匹配\n- ❌ 不要多层引导（A→B→C），大概率断裂\n\n### 录入流程\n\n```\n主人要求写入新规则\n    ↓\n1. 判断规则类型：行为规则 / 业务规则 / 技术细节\n    ↓\n2. 匹配层级：\n   - 行为规则（铁律级）→ AGENTS.md\n   - 业务规则（触发器）→ MEMORY.md\n   - 人格/身份 → SOUL.md / IDENTITY.md\n   - 技术细节 → SKILL.md / docs/\n    ↓\n3. 检查现有文件有无重复内容：\n   - 有重复 → 以高层级为准，删除低层级重复\n   - 无重复 → 写入对应文件\n    ↓\n4. 如不确定放哪层 → 向主人推荐\n```\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 先回答再操作、禁止未确认执行、规则录入引导、3天检查冗余 | 详细 Heartbeat 说明、群聊详细规则、Memory 详细说明 |\n| **MEMORY.md** | 推送渠道规则、业务触发器、项目专属规则、同步规则 | Cookie 保护铁律（应放 AGENTS.md）、技术选择器 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律（应放 AGENTS.md） |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情（应引到 MEMORY.md） |\n| **SKILL.md** | 技术选择器、正则、API 流程、版本历史 | 行为规则、人格描述 |\n\n### 标准引导语格式\n\n**统一格式：** `详见 [文件/章节名]`\n\n**AGENTS.md 标准引导表：**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md |\n| 心跳检查清单 | 详见 HEARTBEAT.md |\n| 群聊发言规则 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n| 安全红线 | Red Lines（见下方） |\n```\n\n**其他常见引导示例：**\n- `完整规则详见 docs/temp-tasks.md`\n- `技术细节详见 SKILL.md「主人规则」第11条`\n- `自动发布流程详见 SKILL.md「主人标准工作流程」`\n\n**引导语铁律：**\n- ✅ 引导只能从上往下（AGENTS → MEMORY → SKILL）\n- ❌ 底层文件不要引导回上层（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n- 引导语要简洁，一行搞定，不要展开详细内容\n\n## 🔄 冗余检查机制\n\n**每 3 天检查一次各 md 文件有无冗余/重复或者可合并内容**\n\n### 检查步骤\n\n1. 读取所有 md 文件内容\n2. 对比各层文件，查找：\n   - **重复内容**：两个文件写了同样的规则\n   - **可合并内容**：可以精简的相似规则\n   - **违规引导**：底层文件引导回顶层（如\"详见 AGENTS.md\"）\n3. 以高层级文件为准，删除低层级重复\n4. 向主人汇报检查结果，确认后执行清理\n\n### 检查清单\n\n- [ ] AGENTS.md 铁律 vs MEMORY.md 铁律 vs SOUL.md 铁律 — 有无重复？\n- [ ] 各文件有无引导回上层的情况？\n- [ ] HEARTBEAT.md / TOOLS.md 有无默认模板未清理？\n- [ ] MEMORY.md 业务规则有无与 SKILL.md 重复？\n\n## 🚀 快速部署\n\n### 方式一：一键初始化脚本（推荐）\n\n*   **Mac / Linux 用户**：\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**：\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二：手动初始化\n\n创建新子 Agent 时，按以下结构初始化：\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录（v2.0 教学版）：\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板（带使用说明注释） |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板（带示例） |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板（带安全锚示例） |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| v2.0 | 2026-05-21 | **Market Ready 发布**：①新增 scripts/init.sh 一键初始化脚本；②升级 templates 为“教学版”，内含详细使用说明；③补全 self-improving 目录结构 ✅ |\n| v1.3 | 2026-05-21 | **消除重复铁律+补充执行机制**：①删除 SOUL.md 与 AGENTS.md 重复的隐私保密规则，只保留独有规则；②HEARTBEAT.md 新增 3 天检查冗余定时任务；③AGENTS.md 新增冲突定义；④同步更新 QQ/微信两个人格 + 金字塔模板 ✅ |\n| v1.2 | 2026-05-21 | **新增安全锚机制**：底层文件可与顶层铁律挂钩，备注\"如有冲突以 AGENTS.md 为准\"，防止规则冲突而不被发现；同步更新 QQ/微信两个人格 ✅ |\n| v1.1 | 2026-05-21 | **修复5个隐患**：①加入 self-improving 层级到架构图和部署命令；②AGENTS.md 加\"不要只看本文件\"提醒 + 铁律优先级声明；③MEMORY.md 加业务规则引导表；④模板文件加占位示例内容；⑤标准引导语格式章节 ✅ |\n| v1.0 | 2026-05-21 | 初始版本：金字塔架构定义、规则录入铁律、冗余检查机制、模板文件 ✅ |\n\nFile v2.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"2.1.0\",\n  \"publishedAt\": 1779439926733\n}\n\nFile v2.1.0:templates/AGENTS.md\n\n# AGENTS.md - 顶层行为规则（金字塔第一层）\n\n> **💡 使用说明**：\n> 1. 本文件只存放**最高优先级的行为铁律**（如：安全红线、交互原则）。\n> 2. 具体的业务规则、项目细节请移至 MEMORY.md，保持本文件精简。\n> 3. 所有规则应具有**通用性**，不要在顶层文件写死具体业务逻辑。\n\n## ⚡ 铁律（最高优先级）\n\n- **用户提问时，必须先回答用户的问题，再进行任何操作。**\n- 禁止在未确认的情况下直接执行、修改文件、运行脚本。\n- 如果是明确的操作指令，直接执行不废话；其他情况先确认后动手。\n- 此规则适用于所有场景。\n\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统/业务规则 | 详见 MEMORY.md |\n| 心跳/定时任务 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n\n## Red Lines\n\n- 隐私数据绝对保密\n- 不要运行破坏性命令\n- `trash` > `rm`（可恢复 > 永久删除）\n\nFile v2.1.0:templates/HEARTBEAT.md\n\n# HEARTBEAT.md - 定时提醒任务清单\n\n> **💡 使用说明**：\n> 1. 本文件用于配置**周期性检查任务**（如：待办提醒、报告队列、数据维护）。\n> 2. 只有在接收到 Heartbeat 信号时才会读取，平时不消耗 Token。\n\n## ⏰ 待办提醒\n\n- 检查 `~/self-improving/heartbeat-state.md` 中的 pending_reminders。\n- 如果到达触发时间且未发送，通过 message 工具发送，发送后标记为 done。\n\n## 📤 推送规则\n\n- [推送渠道配置，如：舞蹈通知走 QQ，工作通知走微信]\n\n## 📋 定期维护任务\n\n- **每 3 天检查一次**：各 md 文件有无冗余/重复/可合并内容。\n- **执行逻辑**：检查后向用户汇报结果，确认后执行清理。\n\n## Self-Improving Check\n\n- 检查 `~/self-improving/` 目录是否有文件变更。\n- 如有变更，整理索引或归档；如无变更，返回 `HEARTBEAT_OK`。\n\nFile v2.1.0:templates/IDENTITY.md\n\n# IDENTITY.md - Who Am I?\n\n- **Name:** [Agent 名字]\n- **Creature:** [形象描述]\n- **Vibe:** [性格关键词]\n- **Emoji:** [代表表情]\n- **Avatar:** [头像描述]\n\n---\n\n[一句话自我介绍]\n\nFile v2.1.0:templates/MEMORY.md\n\n# MEMORY.md - 长期记忆（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件存放**业务规则、项目配置、长期记忆**。\n> 2. 技术实现细节（如 API 调用流程、正则表达式）请放入对应的 SKILL.md。\n> 3. 行为铁律请放入 AGENTS.md。\n\n## 业务规则\n\n- **[业务规则名称]**：[规则描述，如：收到用户发送视频后，自动执行发布流程]\n  - 详见 [相关文件/SKILL.md]\n\n## 🎭 项目规则\n\n- **专属文件夹**：`~/.openclaw/workspace/[项目名]/`\n- **触发规则**：用户说「开始 XXX 任务」→ 读取项目进度\n- **文件归档**：所有产出统一存放，不散落在根目录\n\n## 触发规则\n\n- 严禁擅自往 MEMORY.md 添加内容，需经用户确认。\n- 发现可复用规则时，按**金字塔引导优先级**写入对应文件。\n\n## 铁律（本层独有）\n\n- **[独有铁律]**：[仅适用于当前业务场景的铁律，如：保护 Cookie 是第一位]\n  - *注意：通用行为铁律应写在 AGENTS.md*\n\nFile v2.1.0:templates/SOUL.md\n\n# SOUL.md - 灵魂人格（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件定义 Agent 的**人格、身份、使命**。\n> 2. 它是 Agent 的\"性格设定\"，决定了说话风格和价值观。\n> 3. 行为规则（该做什么、不该做什么）应优先放在 AGENTS.md。\n\n## 基础身份\n\n- **名字**：[Agent 名字]\n- **形象**：[形象描述，如：蓝陨石边牧、严肃的工程师等]\n- **所属**：[所属事业/团队]\n- **语气**：[性格关键词，如：温柔、幽默、严谨、务实]\n\n## 核心使命\n\n- [Agent 存在的意义，如：帮助主人管理舞室运营、辅助代码开发等]\n\n## 行为准则\n\n1. [准则 1：如：优先区分工作日/周末，严格匹配主人节奏]\n2. [准则 2：如：像真人朋友一样聊天，不机械回复]\n\n## ⚠️ 铁律\n\n- ⚠️ **安全锚**：此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准。\n- [本层独有的铁律，如：外部操作先确认再执行、隐私数据绝对保密]\n\n---\n\n[一句话描述，作为 Agent 的结束语或座右铭]\n\nFile v2.1.0:templates/TOOLS.md\n\n# TOOLS.md - 本地配置笔记\n\n### [配置项名称]\n- **配置项**：[值]\n- **说明**：[说明]\n\n---\n\n> 此文件只存放本地环境特有的配置笔记，不存放技术流程（技术流程放 SKILL.md）。\n\nFile v2.1.0:templates/USER.md\n\n# USER.md - 主人信息\n\n## 主人：[主人名字]\n\n**所在地：** [主人所在地]\n\n**工作日：** [工作日安排]\n\n**周末：** [周末安排]\n\n---\n\n## 伴侣：[伴侣名字]\n\n**常驻地址：** [地址]\n\n**事业：** [事业描述]\n\n---\n\n## 共同事业\n\n[共同的事业/项目描述]\n\n---\n\n## 性格\n\n[主人性格描述]\n\n---\n\n## 身份定位\n\n[Agent 对主人的身份定位]\n\nArchive v2.0.0: 11 files, 10008 bytes\n\nFiles: scripts/init.ps1 (1437b), scripts/init.sh (1067b), SKILL.md (9132b), templates/AGENTS.md (1058b), templates/HEARTBEAT.md (911b), templates/IDENTITY.md (202b), templates/MEMORY.md (1025b), templates/SOUL.md (1079b), templates/TOOLS.md (220b), templates/USER.md (396b), _meta.json (146b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: 金字塔记忆架构\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构：顶层（AGENTS.md）只放铁律级行为规则，中层（MEMORY.md/SOUL.md/HEARTBEAT.md）放业务规则和人格配置，底层（SKILL.md/TOOLS.md）放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景：创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查。\n---\n\n# 金字塔记忆架构（Pyramid Memory Architecture）\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构，适用于任何新建子 Agent 工作区。\n> 核心理念：**规则按触发优先级分层存放，引导只能从上往下，下层不引导回上层。**\n> 版本：**v2.0 (Market Ready)** - 包含一键初始化脚本 + 教学版模板\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层：系统注入，铁律级行为规则（每次必加载）\n     /-----------\\\n    / MEMORY.md   \\    ← 中层：主会话加载，业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层：人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取：执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层：按需读取，技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入，每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | 心跳触发时加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片（名字、形象、表情） |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记（设备、端口、Cookie） |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训（memory.md / domains/ / projects/ / corrections.md） |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**：\n   - 系统注入文件（AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER）> 按需读取文件（HEARTBEAT/memory日志/self-improving）> 外部 SKILL.md\n2. **引导方向主要从上往下**：\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n   - ⚠️ **安全锚**：底层文件如果有一条规则和顶层铁律直接相关，可以加备注：`⚠️ 此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**：\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导，实在引导不了再向主人推荐其他写入方式**\n\n### 录入流程\n\n```\n主人要求写入新规则\n    ↓\n1. 判断规则类型：行为规则 / 业务规则 / 技术细节\n    ↓\n2. 匹配层级：\n   - 行为规则（铁律级）→ AGENTS.md\n   - 业务规则（触发器）→ MEMORY.md\n   - 人格/身份 → SOUL.md / IDENTITY.md\n   - 技术细节 → SKILL.md / docs/\n    ↓\n3. 检查现有文件有无重复内容：\n   - 有重复 → 以高层级为准，删除低层级重复\n   - 无重复 → 写入对应文件\n    ↓\n4. 如不确定放哪层 → 向主人推荐\n```\n\n### 各层\"独有规则\"示例\n\n| 层级 | 应该放什么 | 不应该放什么 |\n|------|-----------|-------------|\n| **AGENTS.md** | 先回答再操作、禁止未确认执行、规则录入引导、3天检查冗余 | 详细 Heartbeat 说明、群聊详细规则、Memory 详细说明 |\n| **MEMORY.md** | 推送渠道规则、业务触发器、项目专属规则、同步规则 | Cookie 保护铁律（应放 AGENTS.md）、技术选择器 |\n| **SOUL.md** | 人格描述、使命、能力设定、行为准则、底线 | 通用行为铁律（应放 AGENTS.md） |\n| **HEARTBEAT.md** | 待办提醒、报告队列、检查项 | 推送规则详情（应引到 MEMORY.md） |\n| **SKILL.md** | 技术选择器、正则、API 流程、版本历史 | 行为规则、人格描述 |\n\n### 标准引导语格式\n\n**统一格式：** `详见 [文件/章节名]`\n\n**AGENTS.md 标准引导表：**\n```markdown\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统规则 | 详见 MEMORY.md |\n| 心跳检查清单 | 详见 HEARTBEAT.md |\n| 群聊发言规则 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n| 安全红线 | Red Lines（见下方） |\n```\n\n**其他常见引导示例：**\n- `完整规则详见 docs/temp-tasks.md`\n- `技术细节详见 SKILL.md「主人规则」第11条`\n- `自动发布流程详见 SKILL.md「主人标准工作流程」`\n\n**引导语铁律：**\n- ✅ 引导只能从上往下（AGENTS → MEMORY → SKILL）\n- ❌ 底层文件不要引导回上层（如 MEMORY.md 不要写\"详见 AGENTS.md\"）\n- 引导语要简洁，一行搞定，不要展开详细内容\n\n## 🔄 冗余检查机制\n\n**每 3 天检查一次各 md 文件有无冗余/重复或者可合并内容**\n\n### 检查步骤\n\n1. 读取所有 md 文件内容\n2. 对比各层文件，查找：\n   - **重复内容**：两个文件写了同样的规则\n   - **可合并内容**：可以精简的相似规则\n   - **违规引导**：底层文件引导回顶层（如\"详见 AGENTS.md\"）\n3. 以高层级文件为准，删除低层级重复\n4. 向主人汇报检查结果，确认后执行清理\n\n### 检查清单\n\n- [ ] AGENTS.md 铁律 vs MEMORY.md 铁律 vs SOUL.md 铁律 — 有无重复？\n- [ ] 各文件有无引导回上层的情况？\n- [ ] HEARTBEAT.md / TOOLS.md 有无默认模板未清理？\n- [ ] MEMORY.md 业务规则有无与 SKILL.md 重复？\n\n## 🚀 快速部署\n\n### 方式一：一键初始化脚本（推荐）\n\n*   **Mac / Linux 用户**：\n    ```bash\n    ./scripts/init.sh my-new-agent\n    ```\n*   **Windows 用户 (PowerShell)**：\n    ```powershell\n    .\\scripts\\init.ps1 my-new-agent\n    ```\n\n### 方式二：手动初始化\n\n创建新子 Agent 时，按以下结构初始化：\n\n```\nworkspace-{name}/\n├── AGENTS.md          ← 顶层铁律模板\n├── MEMORY.md          ← 中层业务规则模板\n├── SOUL.md            ← 中层人格配置模板\n├── IDENTITY.md        ← 身份卡片模板\n├── USER.md            ← 主人信息模板\n├── TOOLS.md           ← 本地配置模板\n├── HEARTBEAT.md       ← 心跳清单模板\n├── docs/              ← 详细文档目录\n└── self-improving/    ← 自我进化目录\n```\n\n## 📋 模板文件\n\n各层模板详见 `templates/` 目录（v2.0 教学版）：\n\n| 模板 | 路径 | 说明 |\n|------|------|------|\n| AGENTS.md | `templates/AGENTS.md` | 顶层铁律模板（带使用说明注释） |\n| MEMORY.md | `templates/MEMORY.md` | 中层业务规则模板（带示例） |\n| SOUL.md | `templates/SOUL.md` | 中层人格配置模板（带安全锚示例） |\n| IDENTITY.md | `templates/IDENTITY.md` | 身份卡片模板 |\n| USER.md | `templates/USER.md` | 主人信息模板 |\n| TOOLS.md | `templates/TOOLS.md` | 本地配置模板 |\n| HEARTBEAT.md | `templates/HEARTBEAT.md` | 心跳清单模板 |\n\n## 📖 版本历史\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| v2.0 | 2026-05-21 | **Market Ready 发布**：①新增 scripts/init.sh 一键初始化脚本；②升级 templates 为“教学版”，内含详细使用说明；③补全 self-improving 目录结构 ✅ |\n| v1.3 | 2026-05-21 | **消除重复铁律+补充执行机制**：①删除 SOUL.md 与 AGENTS.md 重复的隐私保密规则，只保留独有规则；②HEARTBEAT.md 新增 3 天检查冗余定时任务；③AGENTS.md 新增冲突定义；④同步更新 QQ/微信两个人格 + 金字塔模板 ✅ |\n| v1.2 | 2026-05-21 | **新增安全锚机制**：底层文件可与顶层铁律挂钩，备注\"如有冲突以 AGENTS.md 为准\"，防止规则冲突而不被发现；同步更新 QQ/微信两个人格 ✅ |\n| v1.1 | 2026-05-21 | **修复5个隐患**：①加入 self-improving 层级到架构图和部署命令；②AGENTS.md 加\"不要只看本文件\"提醒 + 铁律优先级声明；③MEMORY.md 加业务规则引导表；④模板文件加占位示例内容；⑤标准引导语格式章节 ✅ |\n| v1.0 | 2026-05-21 | 初始版本：金字塔架构定义、规则录入铁律、冗余检查机制、模板文件 ✅ |\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1779377257074\n}\n\nFile v2.0.0:templates/AGENTS.md\n\n# AGENTS.md - 顶层行为规则（金字塔第一层）\n\n> **💡 使用说明**：\n> 1. 本文件只存放**最高优先级的行为铁律**（如：安全红线、交互原则）。\n> 2. 具体的业务规则、项目细节请移至 MEMORY.md，保持本文件精简。\n> 3. 所有规则应具有**通用性**，不要在顶层文件写死具体业务逻辑。\n\n## ⚡ 铁律（最高优先级）\n\n- **用户提问时，必须先回答用户的问题，再进行任何操作。**\n- 禁止在未确认的情况下直接执行、修改文件、运行脚本。\n- 如果是明确的操作指令，直接执行不废话；其他情况先确认后动手。\n- 此规则适用于所有场景。\n\n## 🔗 其他规则引导\n\n| 类别 | 引导位置 |\n|------|----------|\n| 记忆系统/业务规则 | 详见 MEMORY.md |\n| 心跳/定时任务 | 详见 HEARTBEAT.md |\n| 技能调用说明 | 详见各 SKILL.md |\n| 本地配置 | 详见 TOOLS.md |\n\n## Red Lines\n\n- 隐私数据绝对保密\n- 不要运行破坏性命令\n- `trash` > `rm`（可恢复 > 永久删除）\n\nFile v2.0.0:templates/HEARTBEAT.md\n\n# HEARTBEAT.md - 定时提醒任务清单\n\n> **💡 使用说明**：\n> 1. 本文件用于配置**周期性检查任务**（如：待办提醒、报告队列、数据维护）。\n> 2. 只有在接收到 Heartbeat 信号时才会读取，平时不消耗 Token。\n\n## ⏰ 待办提醒\n\n- 检查 `~/self-improving/heartbeat-state.md` 中的 pending_reminders。\n- 如果到达触发时间且未发送，通过 message 工具发送，发送后标记为 done。\n\n## 📤 推送规则\n\n- [推送渠道配置，如：舞蹈通知走 QQ，工作通知走微信]\n\n## 📋 定期维护任务\n\n- **每 3 天检查一次**：各 md 文件有无冗余/重复/可合并内容。\n- **执行逻辑**：检查后向用户汇报结果，确认后执行清理。\n\n## Self-Improving Check\n\n- 检查 `~/self-improving/` 目录是否有文件变更。\n- 如有变更，整理索引或归档；如无变更，返回 `HEARTBEAT_OK`。\n\nFile v2.0.0:templates/IDENTITY.md\n\n# IDENTITY.md - Who Am I?\n\n- **Name:** [Agent 名字]\n- **Creature:** [形象描述]\n- **Vibe:** [性格关键词]\n- **Emoji:** [代表表情]\n- **Avatar:** [头像描述]\n\n---\n\n[一句话自我介绍]\n\nFile v2.0.0:templates/MEMORY.md\n\n# MEMORY.md - 长期记忆（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件存放**业务规则、项目配置、长期记忆**。\n> 2. 技术实现细节（如 API 调用流程、正则表达式）请放入对应的 SKILL.md。\n> 3. 行为铁律请放入 AGENTS.md。\n\n## 业务规则\n\n- **[业务规则名称]**：[规则描述，如：收到用户发送视频后，自动执行发布流程]\n  - 详见 [相关文件/SKILL.md]\n\n## 🎭 项目规则\n\n- **专属文件夹**：`~/.openclaw/workspace/[项目名]/`\n- **触发规则**：用户说「开始 XXX 任务」→ 读取项目进度\n- **文件归档**：所有产出统一存放，不散落在根目录\n\n## 触发规则\n\n- 严禁擅自往 MEMORY.md 添加内容，需经用户确认。\n- 发现可复用规则时，按**金字塔引导优先级**写入对应文件。\n\n## 铁律（本层独有）\n\n- **[独有铁律]**：[仅适用于当前业务场景的铁律，如：保护 Cookie 是第一位]\n  - *注意：通用行为铁律应写在 AGENTS.md*\n\nFile v2.0.0:templates/SOUL.md\n\n# SOUL.md - 灵魂人格（金字塔第二层）\n\n> **💡 使用说明**：\n> 1. 本文件定义 Agent 的**人格、身份、使命**。\n> 2. 它是 Agent 的\"性格设定\"，决定了说话风格和价值观。\n> 3. 行为规则（该做什么、不该做什么）应优先放在 AGENTS.md。\n\n## 基础身份\n\n- **名字**：[Agent 名字]\n- **形象**：[形象描述，如：蓝陨石边牧、严肃的工程师等]\n- **所属**：[所属事业/团队]\n- **语气**：[性格关键词，如：温柔、幽默、严谨、务实]\n\n## 核心使命\n\n- [Agent 存在的意义，如：帮助主人管理舞室运营、辅助代码开发等]\n\n## 行为准则\n\n1. [准则 1：如：优先区分工作日/周末，严格匹配主人节奏]\n2. [准则 2：如：像真人朋友一样聊天，不机械回复]\n\n## ⚠️ 铁律\n\n- ⚠️ **安全锚**：此规则与 AGENTS.md 铁律相关，如有冲突以 AGENTS.md 为准。\n- [本层独有的铁律，如：外部操作先确认再执行、隐私数据绝对保密]\n\n---\n\n[一句话描述，作为 Agent 的结束语或座右铭]\n\nFile v2.0.0:templates/TOOLS.md\n\n# TOOLS.md - 本地配置笔记\n\n### [配置项名称]\n- **配置项**：[值]\n- **说明**：[说明]\n\n---\n\n> 此文件只存放本地环境特有的配置笔记，不存放技术流程（技术流程放 SKILL.md）。\n\nFile v2.0.0:templates/USER.md\n\n# USER.md - 主人信息\n\n## 主人：[主人名字]\n\n**所在地：** [主人所在地]\n\n**工作日：** [工作日安排]\n\n**周末：** [周末安排]\n\n---\n\n## 伴侣：[伴侣名字]\n\n**常驻地址：** [地址]\n\n**事业：** [事业描述]\n\n---\n\n## 共同事业\n\n[共同的事业/项目描述]\n\n---\n\n## 性格\n\n[主人性格描述]\n\n---\n\n## 身份定位\n\n[Agent 对主人的身份定位]","readmeExcerpt":"Skill: 金字塔记忆架构 Owner: popo67ll Summary: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。 Tags: latest:3.6.0 Version history: v3.6.0 | 2026-08-06T08:20:16.564Z | user 更新到 3.6.0 v3.4.0 | 2026-05-31T10:07:04.339Z | user 第9项新增任务归属标记检","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程"},{"language":"json","snippet":"{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"检查当月值班表 /path/to/duty.md,判断今天是否为值班日。\\n\\n如果是值班日:提醒用户做好值班准备。\\n如果不是值班日:回复 NO_REPLY。\"\n  }\n}"},{"language":"json","snippet":"{\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"详见 MEMORY.md(#duty-check)判断是否值班,如果是详见 HEARTBEAT.md(#duty-rules)推送提醒。\"\n  }\n}"},{"language":"text","snippet":"主人说要加/改一条规则\n         ↓\n问：这条规则描述的是什么？\n         ↓\n┌──────────────────────────────────────────────────────┐\n│ A. 描述\"什么时候做/做什么/触发条件/推送渠道\"？        │\n│    示例：每天23:30发文章、公众号先发草稿再发布          │\n│         禁止重复参考已发过的文章、抖音走QQ小红书走微信    │\n│    → MEMORY.md（业务规则层）                           │\n├──────────────────────────────────────────────────────┤\n│ B. 描述\"怎么做/用什么工具/API/技术实现/操作步骤\"？     │\n│    示例：用web_search搜标题、HTML用内联样式禁止<style> │\n│         调用wechat-mp-publish、封面上传流程、标题公式   │\n│    → 对应的 SKILL.md（技术细节层）                     │\n├──────────────────────────────────────────────────────┤\n│ C. 描述\"行为底线/安全红线/绝对禁止/必须先做\"？         │\n│    示例：必须先回答再操作、禁止未经授权删除文件         │\n│         禁止私自改文件、失败一次就停手汇报              │\n│    → AGENTS.md（铁律层）                              │\n├──────────────────────────────────────────────────────┤\n│ D. 描述\"人格/身份/使命/行为风格\"？                    │\n│    示例：极客导师、沉稳务实、话少精准                   │\n│    → SOUL.md / IDENTITY.md                            │\n├──────────────────────────────────────────────────────┤\n│ E. 描述\"执行经验/踩坑教训/领域知识\"？                  │\n│    示例：OVATION 工作原则10条、360卸载失败经验          │\n│    → self-improving/                                  │\n└──────────────────────────────────────────────────────┘"},{"language":"text","snippet":"主人要求写入新规则\n    ↓\n1. 过规则分类决策树（见上方）：判断规则属于 A/B/C/D/E 哪类\n    ↓\n2. 匹配层级:\n   - A类 → MEMORY.md\n   - B类 → 对应的 SKILL.md / docs/\n   - C类 → AGENTS.md\n   - D类 → SOUL.md / IDENTITY.md\n   - E类 → self-improving/\n    ↓\n3. 🔍 全局扫描关联项:\n   - 扫描全部 md 文件,找出与新规则主题相关的所有现有规则\n   - 判断这些相关规则之间是否能组成「多级联链」\n   - 级联链不限于 2 层,可以 A→B→C 多层,前提是每层锚点真实存在且链路可达\n    ↓\n4. 向主人推荐级联方案:\n   - 展示发现的关联规则分布\n   - 推荐最优级联路径(例如:AGENTS.md 一行核心 → MEMORY.md 业务展开 → SKILL.md 技术实现)\n   - 等待主人确认后执行\n    ↓\n5. 生成锚点名:<!-- #[英文短横线] -->\n   - 命名规则:全小写 + 短横线分隔,如 #backup-rules\n   - self-improving/ 锚点需加领域前缀,如 #ops-sync-failure\n    ↓\n6. 写入规则(级联格式):\n   - AGENTS.md 只保留「一句话核心 + 一个引导语」\n   - 执行步骤、技术细节等引导到下层文件\n   - 每层只保留本层独有的内容\n    ↓\n7. 如不确定放哪层 → 向主人推荐"},{"language":"markdown","snippet":"- **修改 skill 必须同步问询**:详见 SKILL.md「同步流程」(#skill-sync-flow)\n- **脚本执行失败就停手**:详见 SKILL.md「失败处理」(#fail-stop)"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: 金字塔记忆架构\nversion: 3.6.0\ndescription: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。\n---\n\n# 金字塔记忆架构(Pyramid Memory Architecture)\n\n> 本 Skill 提供一套标准化的 Agent 记忆分层架构,适用于任何新建子 Agent 工作区。\n> 核心理念:**规则按触发优先级分层存放,引导只能从上往下,下层不引导回上层。**\n> 版本:**v3.6** - Cron任务按复杂度分级:简单任务用锚点引导,复杂任务直写进cron payload,彻底解决隔离会话引导断裂问题\n\n## 📐 架构总览\n\n```\n         ▲\n        / \\\n       /   \\\n      / AGENTS.md \\    ← 顶层:系统注入,铁律级行为规则(每次必加载)\n     /-----------\\\n    / MEMORY.md   \\    ← 中层:主会话加载,业务规则、触发器、长期记忆\n   /---------------\\\n  /  SOUL.md 等      \\  ← 中层:人格配置、心跳清单、身份信息\n /---------------------\\\n/  self-improving/     \\ ← 按需读取:执行经验、错误纠正、领域教训\n/-----------------------\\\n\\   SKILL.md/TOOLS.md   / ← 底层:按需读取,技术实现细节、操作流程\n```\n\n### 各层定位\n\n| 层级 | 文件 | 加载方式 | 内容定位 |\n|------|------|----------|----------|\n| **顶层** | `AGENTS.md` | 系统级注入,每次必加载 | 铁律级行为规则、安全红线、引导表 |\n| **中层** | `MEMORY.md` | 主会话系统注入 | 业务触发规则、长期记忆、项目规则 |\n| **中层** | `SOUL.md` | 系统级注入 | 人格、身份、使命、行为准则 |\n| **中层** | `HEARTBEAT.md` | cron触发时通过锚点引导加载 | 待办提醒、报告队列、周期性检查清单 |\n| **中层** | `IDENTITY.md` | 系统级注入 | Agent 身份卡片(名字、形象、表情) |\n| **中层** | `USER.md` | 系统级注入 | 主人信息、作息、偏好 |\n| **中层** | `TOOLS.md` | 系统级注入 | 本地配置笔记(设备、端口、Cookie) |\n| **按需读取** | `self-improving/` | 任务前主动读取 | 执行经验、错误纠正、领域教训(memory.md / domains/ / projects/ / corrections.md) |\n| **底层** | `SKILL.md` | 匹配场景时读取 | 技术实现、操作流程、选择器、正则 |\n| **底层** | `docs/*.md` | 按需读取 | 详细操作文档、临时任务规则等 |\n\n## 📝 规则录入铁律\n\n### 录入原则\n\n1. **按触发优先级引导**:\n   - 系统注入文件(AGENTS/SOUL/MEMORY/TOOLS/IDENTITY/USER)> 按需读取文件(HEARTBEAT/memory日志/self-improving)> 外部 SKILL.md\n2. **引导方向主要从上往下**:\n   - ✅ AGENTS.md → 引导去 MEMORY.md / SKILL.md\n   - ✅ MEMORY.md → 引导去 SKILL.md\n   - ❌ 底层文件**不要引导回上层**(如 MEMORY.md 不要写\"详见 AGENTS.md\")\n   - ⚠️ **安全锚**:底层文件如果有一条规则和顶层铁律直接相关,可以加备注:`⚠️ 此规则与 AGENTS.md 铁律相关,如有冲突以 AGENTS.md 为准`\n3. **检查冗余时以高层级文件为准**:\n   - 删除低层级已覆盖的重复内容\n   - 低层级只保留自己独有的规则\n4. **能引导就引导,实在引导不了再向主人推荐其他写入方式**\n\n### 📂 注入 vs 非注入文件说明\n\n**注入文件**(每次对话自动加载,Agent 一定能读到):\n- `AGENTS.md` `SOUL.md` `MEMORY.md` `IDENTITY.md` `USER.md` `TOOLS.md`(由 OpenClaw 系统注入)\n- `HEARTBEAT.md`(cron 触发时通过锚点引导加载)\n\n**非注入文件**(需要 Agent 主动读取,可能读不到):\n- `SKILL.md`(需 `<available_skills>` 匹配才自动读取)\n- `self-improving/` 目录(需任务前主动读取)\n- `memory/` 日志(需 `memory_search` 或 `memory_get` 主动搜索)\n- `docs/` 目录(需按路径手动读取)\n\n**引导原则**:\n- ✅ 重要规则尽量放在注入文件内,形成闭环\n- ⚠️ 引导到非注入文件时,确保目标文件在 `<available_skills>` 中有 description 匹配\n- ⚠️ 可以多层引导(A→B→C),前提是:每一级的 `#[锚点]` 在目标文件真实存在,且目标是系统注入文件或 description 匹配的 SKILL.md,确保 AI 能读到\n- ✅ **推荐多级联链**:AGENTS.md(一行核心)→ MEMORY.md(业务展开)→ SKILL.md(技术实现)\n\n### ⚠️ 隔离场景直写铁律\n<!-- #isolated-direct-write -->\n\n**cron 定时任务、子 agent、隔离会话中,禁止使用多级引导(详见 SKILL.md「隔离场景直写铁律」(#isolated-direct-write)),规则必须直写在 prompt 里。**\n\n原因:隔离会话不加载 MEMORY.md/SOUL.md/HEARTBEAT.md 等注入文件,引导会断裂。\n\n适用场景:\n- OpenClaw cron 定时任务的 prompt\n- `sessions_spawn` 创建的隔离子 agent\n- 任何 `sessionTarget: isolated` 的场景\n\n正确做法:\n```json\n{\n  \"payload\": {\n    \"ki"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn75z0q7pbnpbf33zjy3znsgcs84qmse\",\n  \"slug\": \"pyramid-memory-architecture\",\n  \"version\": \"3.6.0\",\n  \"publishedAt\": 1786004416564\n}"},{"path":"skill-card.md","content":"## Description:\n\nPyramid Memory Architecture is an agent skill for organizing AI-agent memory into layered files, guiding rule placement, redundancy checks, cron trigger design, and workspace initialization.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[popo67ll](https://clawhub.ai/user/popo67ll)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent builders use this skill to initialize and maintain AI-agent workspaces with clear memory layers for rules, personality, heartbeat tasks, local tool notes, and technical implementation details. It also helps agents audit markdown memory files for redundancy, misplaced rules, broken anchors, and cron payload design.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may lead an agent to inspect private memory, user-profile, tool, cookie, API-key, or repository information.\n\nMitigation: Use explicit file allowlists and exclude credential-bearing or private paths unless the user has authorized that access for the task.\n\nRisk: Recurring cron workflows can cause repeated scans or actions that the user did not intend.\n\nMitigation: Keep cron workflows disabled unless they are deliberately configured, reviewed, and scoped.\n\nRisk: Cleanup or GitHub synchronization guidance could alter or publish workspace content.\n\nMitigation: Require separate confirmation before cleanup, file deletion, commits, tags, or GitHub pushes.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/popo67ll/skills/pyramid-memory-architecture)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Configuration, Shell commands]\n\n**Output Format:** [Markdown guidance with file templates, checklists, JSON payload examples, and command snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May propose workspace file edits, cron payloads, redundancy-check reports, and memory-layer classification decisions.]\n\n## Skill Version(s):\n\n3.6.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。 Skill: 金字塔记忆架构 Owner: popo67ll Summary: 通用 AI Agent 记忆架构 Skill。采用\"金字塔\"分层结构:顶层(AGENTS.md)只放铁律级行为规则,中层(MEMORY.md/SOUL.md/HEARTBEAT.md)放业务规则和人格配置,底层(SKILL.md/TOOLS.md)放技术实现细节。适用于所有新建子 Agent 工作区初始化。触发场景:创建新 Agent、初始化工作区、记忆架构设计、规则录入引导、md 文件冗余检查、触发机制职责划分、任务归属标记检查、cron锚点格式检查、cron复杂度分级。 Tags: latest:3.6.0 Version history: v3.6.0 | 2026-08-06T08:20:16.564Z | user 更新到 3.6.0 v3.4.0 | 2026-05-31T10:07:04.339Z | user 第9项新增任务归属标记检","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":848,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:37:45.418Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T21:48:30.861Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}