mcpField
C
context-audit

context-audit

github.com/hjewkesAgent 工作流445 次安装35 周前更新
代码仓库

关于 context-audit

context-audit 是面向 Claude 用户的技能，用于检查并减少上下文窗口的消耗。它结合静态清单、会话令牌分析、加权评分和优化建议。

主要功能

  1. 01盘点上下文来源
  2. 02分析会话令牌变化
  3. 03评估上下文状况
  4. 04提供优化建议

适用场景

  1. 01发现过大的技能和 CLAUDE.md 文件
  2. 02定位令牌大幅增长的轮次
  3. 03检查插件与 MCP 工具数量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill context-audit

安装后在 Claude Code 中输入/context-audit确认已加载。

附带文件references/audit-procedures.mdscripts/audit-context

详细介绍

上下文审计

分析哪些内容正在占用你的上下文窗口，并推荐优化方案。三种审计模式可以独立运行，也可以组合运行。

快速开始

  • /context-audit 或“审计我的上下文”——运行全部三项审计
  • “静态审计”或“上下文清单”——仅检查文件清单
  • “会话分析”——仅解析 JSONL 令牌
  • “上下文评分”——仅进行评分并提供建议

审计模式

1. 静态清单

运行 scripts/audit-context 以自动生成静态清单。支持通过 --json 输出结构化数据，通过 --flagged 仅显示问题，通过 --top N 显示体积最大的项目。

该脚本会扫描所有影响上下文的来源：

  • 技能（SKILL.md、rules/、references/）
  • CLAUDE.md 文件（全局、项目及子目录）
  • 自动记忆文件（~/.claude/projects/*/memory/*.md）
  • 插件，并估算每个插件的工具数量
  • MCP 服务

**阈值：**标记超过 500 个词的 SKILL.md、任何 rules/ 目录、超过 2KB 的 CLAUDE.md、5 个或更多 MCP 服务，以及包含 10 个或更多工具的插件。

2. 实时上下文窗口（/context）

运行静态清单后，告知用户内置的 /context 命令：

  • 它会显示实时令牌用量：当前令牌数、最大容量和使用百分比
  • 它会细分当前上下文窗口中的内容（系统提示词、对话、工具结果）
  • 建议用户自行运行 /context 获取实时令牌数据，作为静态清单的补充
  • 如果用户分享 /context 的输出，请将其纳入评分（会话效率部分）
3. 会话令牌分析

解析当前会话的 JSONL，以追踪上下文增长：

  1. 在 ~/.claude/projects/ 中找到活动会话的 JSONL
  2. 提取每轮的 usage.input_tokens 和 usage.cache_read_input_tokens
  3. 找出连续两轮之间令牌数变化最大的 5 处
  4. 将变化与前几轮的工具调用关联起来
  5. 报告每次激增的触发原因

阅读 references/audit-procedures.md，了解完整的 JSONL 解析流程。

4. 建议与评分

生成可执行的建议和字母等级（A-F，0-100 分）。

评分权重：

组成部分权重
技能健康度30%
CLAUDE.md 健康度25%
插件/MCP 健康度25%
会话效率20%

输出格式

生成一份包含以下部分的报告：

  1. 静态清单表格（来自 audit-context 脚本输出）
  2. /context 提示——提醒用户运行 /context 查看实时令牌细分
  3. 会话分析（如果有 JSONL）
  4. 首要建议
  5. 评分

阅读 references/audit-procedures.md，了解详细流程、评分标准和建议规则。

评论

支持 Markdown