⚡

内存管理元技能Skill memory-management

此技能是用于管理Claude Code内存系统的元技能，提供稳定原则、关键词注册和导航指导，帮助用户高效处理CLAUDE.md文件、内存层次、导入语法等。关键词：内存管理、CLAUDE.md、静态内存、元技能、AI代理、文档查找、渐进披露、令牌预算。

AI智能体 0 次安装 0 次浏览 更新于 3/11/2026

名称: 内存管理 描述: 用于Claude Code内存系统的元技能（CLAUDE.md，静态内存）。提供稳定原则、文档查找的关键词注册和导航指导。在处理CLAUDE.md文件、内存层次、导入语法、渐进披露模式、内存组织或静态内存最佳实践时使用。将当前实现细节委托给文档管理技能。关键词：CLAUDE.md，静态内存，内存层次，导入语法，渐进披露，内存组织，企业项目用户内存。 用户可调用: false 允许工具: 读取，全局，搜索，技能

内存元技能

🚨 强制：首先调用文档管理技能

停止 - 在提供任何关于Claude Code内存（CLAUDE.md）的响应之前：

  1. 调用 文档管理 技能
  2. 查询 使用关键词：CLAUDE.md，静态内存，内存层次，导入语法或相关主题
  3. 基于 所有响应仅基于加载的官方文档

跳过此步骤将导致过时或错误的信息。

验证检查点

在响应之前，验证：

  • [ ] 我是否调用了文档管理技能？
  • [ ] 官方文档是否加载？
  • [ ] 我的响应是否仅基于官方文档？

如果任何复选框未勾选，停止并首先调用文档管理。

用于Claude Code内存系统的元技能 - 100% 由官方文档驱动

零重复政策

此技能包含零重复的官方文档内容。所有实现细节委托给文档管理技能，使用自然语言查询。此技能提供不会改变的稳定原则和导航，而文档管理提供当前的官方指导。

概述

此元技能提供用于处理Claude Code内存系统（CLAUDE.md文件，静态内存）的稳定原则、关键词注册和模式。它不重复官方文档，而是教您如何高效查询文档管理技能以获取任何内存相关信息。

此技能提供的内容：

  • 不会改变的稳定原则（永恒指导）
  • 高效文档查找的关键词注册
  • 常见组织模式
  • 快速导航决策树
  • 故障排除指导

此技能委托给文档管理的内容：

  • 当前导入语法规范
  • 确切文件位置和路径
  • 版本特定行为
  • 可能演变的实现细节
  • 完整最佳实践文档

何时使用此技能

此技能应在以下情况下使用：

  • 处理CLAUDE.md文件 - 创建、编辑或组织内存
  • 内存层次问题 - 理解企业/项目/用户/本地优先级
  • 导入语法问题 - 如何导入文件，@语法，递归查找
  • 渐进披露模式 - 组织始终加载与按需加载的内容
  • 内存组织 - 中心辐射，令牌预算，交叉引用
  • 最佳实践查找 - 高效查询以找到官方指导

稳定原则（不会改变）

这些原则是LLM和内存系统工作原理的基础。即使Claude Code的实现演变，它们也不会改变。

1. 渐进披露

原则： 按需加载上下文，而不是所有内容都预先加载。

为什么稳定： 上下文窗口是有限资源。这是LLM的基本约束，不会改变。

应用：

  • 始终加载的内容应最小化且高信号
  • 详细内容仅在需要时加载
  • 中心文件链接到详细参考

2. 战略强调

原则： 使用强调关键词（关键，从不，必须，重要）策略性地用于必须遵循的规则。

为什么稳定： 人类通信优先级信号模式是通用的。

应用：

  • 保留强调用于真正关键的规则
  • 不要过度使用（降低有效性）
  • 在您的内存文件中一致使用

3. 具体性优于模糊性

原则： “使用2空格缩进”优于“正确格式化代码”

为什么稳定： 具体指令比模糊指导更可操作。

应用：

  • 具体示例优于抽象指导
  • 确切命令优于一般方向
  • 可衡量标准优于主观标准

4. 结构有助于解析

原则： 项目符号、标题和清晰组织提高理解。

为什么稳定： 人类和LLM都更有效地处理结构化内容。

应用：

  • 一致使用Markdown标题
  • 列表项使用项目符号
  • 结构化比较使用表格
  • 命令/示例使用代码块

5. 层次/分层

原则： 配置层相互覆盖（企业 → 项目 → 用户 → 本地）。

为什么稳定： 跨所有软件系统使用的标准配置模式。

应用：

  • 高级别设置默认值
  • 低级别可以覆盖
  • 理解您的更改属于哪个级别

6. 令牌效率

原则： 上下文有限 - 高效使用令牌。

为什么稳定： LLM上下文窗口有限制。即使它们增长，效率也重要。

应用：

  • 移除冗余内容
  • 链接而不是复制
  • 使用渐进披露
  • 监控令牌预算

详细解释： 参见稳定原则参考

快速决策树

您想做什么？

  1. 创建新CLAUDE.md文件 → 查询文档管理：“查找关于创建CLAUDE.md文件和/init命令的文档”

  2. 组织项目内存 → 参见常见模式

  3. 理解导入语法 → 查询文档管理：“查找关于CLAUDE.md导入语法和@引用的文档”

  4. 设置内存层次 → 查询文档管理：“查找关于内存层次企业项目用户的文档”

  5. 优化令牌使用 → 参见稳定原则 + 常见模式

  6. 修复内存未加载 → 参见故障排除

  7. 查找官方最佳实践 → 参见关键词注册 以高效查询

文档管理关键词注册

查询文档管理技能以获取内存相关文档时使用这些关键词：

核心内存系统

关键词： CLAUDE.md, 静态内存, 内存层次, 内存系统

示例查询：

查找关于CLAUDE.md静态内存系统和内存层次的文档

导入语法

关键词： 导入语法, @引用, 递归查找, 文件导入

示例查询：

查找关于CLAUDE.md导入语法和@文件引用的文档

内存命令

关键词： /init命令, /memory命令, #快捷方式, 内存命令

示例查询：

查找关于CLAUDE.md的/init和/memory命令的文档

最佳实践

关键词： 内存最佳实践, CLAUDE.md调优, 内存组织

示例查询：

查找关于CLAUDE.md最佳实践和内存调优的文档

Agent SDK集成

关键词： settingSources, 内存API, Agent SDK内存

示例查询：

查找关于Agent SDK settingSources和内存集成的文档

完整关键词注册： 参见关键词注册参考

常见模式

中心辐射组织

模式： 中心文件（CLAUDE.md）链接到详细参考文件。

CLAUDE.md (中心)
├─ 快速参考（必需，始终加载）
├─ 核心原则（简要）
└─ 链接到详细文档
    ├─→ .claude/memory/architecture.md
    ├─→ .claude/memory/workflows.md
    └─→ .claude/memory/testing.md

好处：

  • 中心保持小（令牌高效）
  • 细节按需加载
  • 单一入口点
  • 易于导航

始终加载与上下文依赖

模式： 分离关键内容与详细内容。

始终加载（@前缀导入）：

  • 适用于每个任务的核心原则
  • 绝不能违反的关键规则
  • 常见操作的快速参考
  • 推荐最大约10-15k令牌

上下文依赖（按需加载）：

  • 特定主题的详细指南
  • 参考文档
  • 示例和模板
  • 可以更大，因为选择性加载

令牌预算策略

模式： 跨内存层有意识地分配令牌。

层 目标预算 内容类型
始终加载 ~10-15k令牌 核心原则，关键规则
按需 ~30-50k令牌 详细指南，参考
外部（技能） 无限制 委托文档

详细模式： 参见常见模式参考

故障排除

内存未加载

症状： CLAUDE.md内容未出现在上下文中

诊断步骤：

  1. 检查文件位置：

    • 项目：./CLAUDE.md 在仓库根目录
    • 用户：~/.claude/CLAUDE.md

  2. 检查导入语法：

    • 有效：@路径/到/文件.md
    • 无效：@路径/到/文件（缺少扩展名）
    • 无效：在代码块内（导入不处理）

  3. 检查文件存在：

    • 导入的文件必须在指定路径存在
    • 相对路径从导入文件的位置解析

查询文档管理以获取当前故障排除：

查找关于CLAUDE.md故障排除和内存加载问题的文档

导入语法问题

常见错误：

  • 始终加载导入缺少@前缀
  • 在代码块内使用导入（不会处理）
  • 循环导入（A导入B导入A）
  • 超过最大导入深度

查询文档管理以获取语法规范：

查找关于CLAUDE.md导入语法要求和限制的文档

层次冲突

症状： 由于冲突指令导致的意外行为

解决：

  1. 识别每个指令来自哪个级别
  2. 高级别（企业）覆盖低级别（用户）
  3. 在同一级别内，后内容可能覆盖前内容
  4. 使用特定指令覆盖一般指令

查询文档管理以获取层次详情：

查找关于内存层次优先级和冲突解决的文档

参考加载指南

此技能中的所有参考都是条件加载 - 仅在需要时加载。

何时加载每个参考

渐进披露策略

层1：始终在上下文中

  • SKILL.md（此文件） - 导航中心，快速参考

层2：按需加载

  • 需要特定主题时的参考文件

层3：外部委托

  • 通过文档管理技能的官方文档（始终当前）

相关技能

与内存管理配合良好的技能：

  • 文档管理 - 官方文档访问（内存管理将所有文档查询委托给此）
  • 技能开发 - 如果您正在创建使用内存模式的技能
  • 当前日期 - 用于内存文件中的最后更新时间戳

最佳实践摘要

做：

  • 查询文档管理获取所有官方文档
  • 使用稳定原则作为基础（它们不会改变）
  • 应用渐进披露（始终加载与按需）
  • 保持中心文件小而专注
  • 使用关键词注册以高效查找
  • 监控令牌预算

不做：

  • 重复官方文档
  • 将所有内容放在始终加载导入中
  • 使用模糊指令（“正确做事”）
  • 忽略令牌预算
  • 跳过导入语法验证

审计内存文件

此技能提供由内存组件审计员代理用于正式审计的验证标准。

审计资源

资源 位置 目的
审计框架 references/audit-framework.md 查询指南和评分标准

评分类别

类别 分数 关键标准
结构 25 有效Markdown，适当部分
导入语法 25 正确@路径语法，文件存在
层次合规 20 正确级别（企业/项目/用户）
内容组织 20 渐进披露，适当大小
无反模式 10 无循环导入，过度嵌套

阈值： 85+ = 通过，70-84 = 通过但警告，<70 = 失败

相关代理

内存组件审计员代理（Haiku模型）使用此技能执行正式审计：

  • 通过skills: 内存管理自动加载此技能
  • 使用审计框架和文档管理获取规则
  • 生成结构化审计报告
  • 由/audit-memory命令调用

外部技术验证

在审计引用外部技术（脚本、包、运行时）的内存文件时，审计员必须在标记发现前使用MCP服务器验证声明。

需要MCP验证的技术：

  • .NET/C#脚本：使用microsoft-learn + perplexity验证
  • Node.js/npm包：使用context7 + perplexity验证
  • Python脚本/包：使用context7 + perplexity验证
  • Shell脚本：使用perplexity验证
  • 任何版本特定声明：始终使用perplexity验证

验证规则：

在未首先进行以下操作时，切勿将技术使用标记为不正确：

  1. 查询适当MCP服务器以获取当前文档
  2. 使用perplexity验证最近更改（特别是.NET 10+）
  3. 在发现中记录MCP来源

过时数据警告：

  • microsoft-learn可能返回缓存/过时文档
  • 始终将microsoft-learn与perplexity配对以验证版本
  • 信任perplexity以获取版本号和最近发布功能

参考

参考文件：

版本历史

  • v1.0.0 (2025-11-26)：初始发布 - 委托优先的元技能，具有稳定原则、关键词注册和常见模式