SuperAPI AI 工具集

audit-agent-context

智能体与模型

查看项目

更新于 10-16 01:15

技能介绍

用途:在用户输入第一条提示之前,先量化项目塞进每个代理会话的常驻上下文,找出代理文档中的膨胀内容并削减,称为“审计代理上下文”。

主要能力:一是测量首次提示前加载的内容,从 git rev-parse --show-toplevel 出发,覆盖根代理文件(CLAUDE.md、AGENTS.md 等)、其 @-import 链(逐层解析,导入即把整份文件粘进每次请求)、.claude/settings.json 指定的输出风格、所有已安装技能的前置元数据(name 与 description,按名称去重)、常驻记忆索引文件。按来源报告字节数与 token,并注明所用换算方式(按差值实测、harness 计数、或字节÷2.6)。同时计算两项价格:花费为 token × 每会话轮数(常驻内容每轮重发),余量以同一 token 占 120k 工作区的比例表示,并说明这是模型属性而非窗口大小。

查找不配其位的内容:先运行捆绑脚本 node <this-skill-dir>/scripts/audit-bloat.mjs <repo-root>,它机械检查第 2、6–10 项并逐条打印文件与字节数。检查项包括:内容扩张型 @ 导入、重复根文件、无主体的规则与技能、被内联的 runbook、每次工具调用注入的 hook、复述 lint 门禁的散文、自我检查清单、指令中的决策历史、多文件重复句子、技能体积过大(正文超 8 KB 会被标出)。

三种放置方式:内联(始终常驻)、指针(正文中的路径,按需读取)、嵌套(放在所受管目录中的上下文文件,在该处工作时加载)。按段落判断,而非对整个文件判断;须先确认 harness 是否会遍历目录树。

报告与执行:按字节数排序,每行给出文件、字节数与该做的编辑;移动前先 grep 全树引用,被引用的段落不能直接改为指针,需一并重指向。静默失败的削减要显式标出并交用户决定。只应用用户接受的部分,然后重跑测量与脚本,报告前后总量与余量占比;若后值未下降,须如实说明。限制:只报告再编辑,不主张遵守度提升;不得报告与其他仓库比较的百分位。