⚡

上下文层次结构设计技能Skill context-hierarchy-design

这个技能用于设计内存层次结构，实现渐进式加载以优化上下文管理。它适用于组织CLAUDE.md导入、实施即时上下文加载或为AI代理设计启动层次结构。关键词包括上下文管理、内存层次、渐进加载、AI代理、CLAUDE.md、启动命令。

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

名称: context-hierarchy-design 描述: 设计带有渐进式加载的内存层次结构以实现最优上下文管理。在组织CLAUDE.md导入、实施即时上下文加载或为代理设计启动层次结构时使用。 允许工具: Read, Grep, Glob

上下文层次结构设计技能

设计一个基于任务需求渐进加载上下文的内存层次结构。

目的

并非所有上下文都需要一直存在。一个良好设计的层次结构确保代理获得恰好所需的上下文，而不会臃肿。

何时使用

  • 设置新项目的上下文基础设施
  • 重构臃肿的CLAUDE.md文件
  • 创建任务特定上下文加载
  • 优化代理启动时间
  • 为多种任务类型扩展上下文

三层次内存策略

第一层: CLAUDE.md (最小化，始终加载)
        |
        v
第二层: 启动命令 (任务特定，按需)
        |
        v
第三层: 文件读取 (即时，根据需要)

设计过程

步骤 1: 审计当前状态

分析现有上下文基础设施：

  1. 测量CLAUDE.md大小
  2. 统计导入及其大小
  3. 审查命令覆盖范围
  4. 识别任务类型
检查清单：
- [ ] CLAUDE.md令牌计数
- [ ] 导入计数和总数
- [ ] 任务类型识别
- [ ] 命令覆盖映射

步骤 2: 分类上下文

对于每个现有上下文片段，询问：

问题 如果是的 ->
每个任务都需要吗？ 第一层 (CLAUDE.md)
任务类型需要吗？ 第二层 (启动)
特定工作需要吗？ 第三层 (按需)

步骤 3: 设计第一层 (CLAUDE.md)

仅最小化必需品：

# 项目名称

## 上下文
一句话项目描述。

## 工具
- 语言: X
- 运行时: Y
- 包管理器: Z

## 关键命令
- `cmd test` - 运行测试
- `cmd build` - 构建项目

## 关键规则
1. 最重要规则
2. 第二重要
3. 第三重要 (最多5个)

目标大小：小于2KB。

步骤 4: 设计第二层 (启动命令)

为每个任务类型创建命令：

任务类型 命令 加载的上下文
通用 /prime README, git状态
错误修复 /prime-bug 最近提交，测试文件
功能 /prime-feature 架构，API模式
审查 /prime-review 风格指南，PR差异
文档 /prime-docs 现有文档，API表面

启动命令模板：

# 启动: [任务类型]

## 运行
[当前状态的发现命令]

## 读取
[此任务类型的必需文件]

## 报告
[理解摘要提示]

步骤 5: 设计第三层 (按需)

识别工作中加载的文件：

类别 加载策略
源文件 编辑时读取特定文件
测试文件 运行测试时读取
配置 配置时读取
依赖 调试依赖时读取

原则： 永远不要预加载可以按需加载的内容。

输出格式

设计文档结构：

# 上下文层次结构设计: [项目]

## 第一层: CLAUDE.md (始终加载)

**目标大小:** <2KB
**内容:**
- 项目上下文 (1句话)
- 工具 (语言，运行时，包管理器)
- 关键命令 (3-5个)
- 关键规则 (3-5个)

## 第二层: 启动命令 (任务特定)

### /prime
**目的:** 通用代码库理解
**加载:** README, git状态，项目结构

### /prime-bug
**目的:** 错误修复上下文
**加载:** 最近提交，测试模式，错误日志

### /prime-feature
**目的:** 功能开发上下文
**加载:** 架构，API模式，类似功能

## 第三层: 按需 (即时)

**策略:** 执行期间加载，而非预先
- 源文件: 编辑时读取
- 测试: 测试时读取
- 配置: 配置时读取

## 迁移计划

1. [ ] 备份当前CLAUDE.md
2. [ ] 创建最小化CLAUDE.md
3. [ ] 创建启动命令
4. [ ] 用常见任务类型测试
5. [ ] 基于使用迭代

设计模式

模式: 导入层次结构

CLAUDE.md (始终)
  -> imports/core.md (始终，如果大)
  -> imports/tooling.md (条件性)
  -> imports/workflows.md (条件性)

模式: 目录范围内存

/project
  CLAUDE.md (项目范围)
  /frontend
    CLAUDE.md (前端特定)
  /backend
    CLAUDE.md (后端特定)

模式: 任务类型启动

/prime -> 基础上下文
/prime-{type} -> 类型特定上下文

验证标准

设计后，验证：

  • [ ] CLAUDE.md 小于2KB
  • [ ] 每个任务类型都有启动命令
  • [ ] 没有“以防万一”的加载
  • [ ] 渐进披露工作
  • [ ] 常见工作流程顺畅

要避免的反模式

反模式 问题 解决方案
所有内容在CLAUDE.md中 臃肿 移到启动
无启动命令 静态上下文 添加任务类型启动
导入所有内容 浪费令牌 条件导入
目录CLAUDE.md臃肿 复合 保持范围最小化

关键引用

“使用上下文启动而非CLAUDE.md或类似自动加载内存文件。工程工作不断变化，但内存文件只增长。”

交叉参考

  • @context-priming-patterns.md - 启动命令模式
  • @rd-framework.md - 减少不必要上下文
  • @context-layers.md - 加载到上下文的内容
  • @minimum-context-principle.md - 仅包括必要内容

版本历史

  • v1.0.0 (2025-12-26): 初始发布

最后更新

日期: 2025-12-26 模型: claude-opus-4-5-20251101