Vercel-react-best-practices: AGENTS.md (2975 行) 丢失上下文 — 重组以实现渐进式揭露

□ 问题

" Vercel-反应-最佳做法 " 技术船的 " AGENTS.md " 文件为2,975行/83KB——所有58个规则的单一倾倒地。 这一内容已经与`规则/'中的57个个人档案相同。 重复造成两个问题:

1. SKILL.md 第137行积极指示代理人装入AGENTS.md:`为了扩展所有规则的完整指南:AGENTS.md'-这可能导致代理人不必要地将整个83KB装入上下文. 2.**Claude.md(当作为AGENTS.md的同义链接而出现时)**可以通过Claude代码的内存扫描系统取出,将上千个信使泄露到每次对话中.

□ 当前结构

Vercel-反应-最佳做法/
^ AGENTS.md# 2,975行——全部58行规则入行(单体).
Claude.md#与AGENTS.md的共通(上下文为83KB)
├── SKILL.md#138行-好路由表
* 读取3 360字节
QQ规则/# 57个单个规则文件(结构完善,每行30-80行)

□ 建议的结构

Vercel-反应-最佳做法/
QQ SKILL.md #~125行 — 前事+ 有规则/链接的规则索引
为人类浏览回波
QQ规则/# 57个单个规则文件(未更改)

SKILL.MD 改进

1. ** 添加用户可诉:虚假的'-这是背景知识,而不是可诉的/命令'
2. 取出指示代理人装入AGENTS.md的"全编译文件"部分(135至137行).
3. ** 在规则索引中使用标记下表链接** 这样代理可以直接导航到规则文件: 减记 (规则/规则/规则-规则-等待) 移动到实际使用的分行

4. ** 取消非标准前题** (`许可证'、`元数据')——Claude 代码忽略这些字段

要删除的文件

- `规则/ ' 目录100%复制。 渐进披露模式(描述 → SKILL.md → 点播规则/)是每个[ZZTERM0]的正确方法. (https://docs.ZAnthropic.com/en/docs/Claude-code/技能#add-支持文件) (中文(简体) ).
- 不需要; 代码使用SKILL.md作为技能入门. 拥有Claude.md在XQ/.ZClaude/技能/ ' 子目录有被Claude.md内存扫描仪拾取的风险,将内容注入每一会

□ 内容

出自[Anthropic的技能文档](https://docs.Anthropic.com/en/docs/Claude-code/chilling#add-support-files):

>保持SKILL.md在500行以下. 将详细的参考材料移动到单独的文件中。

>技能可以在其目录中包含多个文件. 这使得SKILL.md专注于基本内容,而Claude只有在需要时才能访问详细的参考材料.

" 规则/ " 目录已完全遵循这一模式。 问题是AGENTS.md把全部复制在一个庞大的文件中, SKILL.md将特工指向它.

□ 影响

- 储蓄**: 消除83KB可漏入代理语境的冗余内容
- ** 不失去知识**: 全体
. . . . . . .