上下文审计技能Skill context-audit

这个技能用于审计代码库的上下文工程健康,识别优化机会,以提高AI代理的性能和令牌使用效率。它帮助开发者在上下文窗口过载、代理性能低下时,通过分析内存文件、MCP配置、命令和钩子,提供评分和建议。关键词:上下文审计、代码库优化、AI智能体、令牌管理、性能提升、R&D框架。

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

name: context-audit description: 审计当前上下文组成并识别优化机会。在上下文窗口过载、代理性能低下或应用R&D框架优化令牌使用时使用。 allowed-tools: Read, Grep, Glob

上下文审计技能

审计代码库的上下文工程健康并识别优化机会。

目的

专注的代理是性能高的代理。这个技能帮助你理解什么在消耗你的上下文窗口以及在哪里应用R&D框架。

何时使用

  • 开始处理新代码库时
  • 代理性能感觉迟缓时
  • 出现上下文警告时
  • 在优化上下文策略之前
  • 定期上下文健康检查

审计过程

1. 内存文件分析

扫描CLAUDE.md和相关内存文件:

检查:
- 根目录CLAUDE.md大小(目标:<2KB)
- 导入数量
- 每目录CLAUDE.md文件
- 总内存文件令牌数

评分内存健康:

大小 分数 评估
<1KB 优秀 最小且专注
1-2KB 良好 在目标范围内
2-5KB 需要审查 增长中,审计内容
>5KB 需要行动 臃肿,需要R&D

2. MCP服务器分析

检查MCP配置:

检查:
- .mcp.json存在性
- 配置的MCP服务器数量
- 每服务器令牌估计(2-5%每个)
- 活动与未使用服务器

评分MCP健康:

服务器 分数 评估
0 优秀 无MCP膨胀
1-2 良好 目标使用
3-5 审查 可能过度配置
>5 需要行动 可能消耗15%以上

3. 命令分析

审查.claude/commands/:

检查:
- 命令数量
- 命令复杂度(简单vs复杂)
- 是否存在priming命令?
- 任务类型覆盖

评分命令健康:

命令 分数 评估
有priming 优秀 动态上下文加载
无priming 需要注意 依赖静态内存

4. 钩子分析

检查消耗上下文的钩子:

检查:
- 钩子数量
- 钩子事件类型
- 潜在上下文注入

5. 总体上下文评分

计算总体上下文工程分数:

组件 权重 最大分数
内存文件 30% 30
MCP配置 25% 25
命令基础设施 25% 25
上下文模式 20% 20

输出格式

{
  "score": 75,
  "grade": "B",
  "components": {
    "memory": {
      "score": 20,
      "max": 30,
      "files_found": ["CLAUDE.md"],
      "total_tokens": 1500,
      "issues": ["未检测到priming命令"]
    },
    "mcp": {
      "score": 25,
      "max": 25,
      "servers_found": 0,
      "estimated_consumption": "0%"
    },
    "commands": {
      "score": 15,
      "max": 25,
      "count": 5,
      "has_priming": false,
      "issues": ["缺少/prime命令"]
    },
    "patterns": {
      "score": 15,
      "max": 20,
      "issues": ["未定义输出样式"]
    }
  },
  "recommendations": [
    "创建/prime命令用于动态上下文加载",
    "通过委托给priming减少CLAUDE.md大小",
    "考虑输出样式以提高令牌效率"
  ]
}

评分标准

分数 等级 状态
90-100 A 精英上下文工程
80-89 B 良好实践,小优化
70-79 C 功能正常,需要注意
60-69 D 显著问题
<60 F 上下文膨胀,需要大修

建议框架

基于发现,推荐:

对于内存膨胀(减少)

  • 识别可以移动到priming命令的内容
  • 标记过时或矛盾的指导
  • 建议最小化CLAUDE.md结构

对于缺少基础设施(委托)

  • 推荐创建priming命令
  • 建议输出样式以控制冗长
  • 提出代理专家模式

交叉引用

  • @rd-framework.md - 减少和委托策略
  • @context-layers.md - 理解上下文组成
  • @context-rot-vs-pollution.md - 诊断上下文问题
  • @context-priming-patterns.md - 动态上下文加载

版本历史

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

最后更新

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