optimize-agents-md

用途：创建、审计或精简 AGENTS.md 与 CLAUDE.md，使 Claude Code、Codex CLI、Cursor、Copilot、Gemini CLI、Windsurf 等工具读取同一份事实来源。核心理念是前沿模型每次会话只能可靠遵循约 150-200 条指令，Claude Code 系统提示已占用约 50 条，因此文件需严格精简，典型项目目标 60-80 行，超过 120 行属警示信号；长对话中遵从度会衰减，故文件应编码偏好而非硬性要求，硬性要求应放入 hooks、格式化器或 CI。每行判断标准：删除它是否会让模型犯原本不会犯的错。工作流：1）调查项目现有 AGENTS.md、CLAUDE.md、.claude/、.cursor/rules/、README、CONTRIBUTING 等，并把旧内容视为假设而非事实，核对 package.json 与锁文件，避免写入已不存在的依赖；2）从仓库直接探测客观事实，如包管理器（pnpm-lock.yaml、bun.lockb、uv.lock 等）、测试/检查/格式化命令、非常规工具链、框架与 monorepo 结构；3）必要时向用户提问主观约定；4）决定单包用一个根文件，monorepo 按需嵌套；5）按模板起草；6）连接 CLAUDE.md。连接方式二选一：符号链接 ln -s AGENTS.md CLAUDE.md（零漂移，但不能容纳 Claude 专属内容）或导入形式，CLAUDE.md 写入 @AGENTS.md 并可附 Claude 专属段落；无 Claude 专属内容时默认符号链接。可将不需每次加载的内容移到 .claude/rules/*.md（带 paths 前置元数据按需加载，用户级 paths 规则存在不生效问题）、Skills、Subagents、.claude/settings.json 或 Hooks。应保留：带标志的精确命令、非显然工具选择、与代码暗示相反的架构决策、反常规团队约定、领域概念、失败驱动规则。应删减：人格指令、风格指南、目录树、代码片段、自明实践、与 README/package.json 等重复的信息。写作模式：行为用祈使句、事实用陈述句；多用正面表述、少用否定；每条禁令附理由与替代方案；命令放代码围栏；每条项目一条指令；MUST/IMPORTANT 仅用于 3-5 条；用 HTML 注释写维护者说明；把最关键规则放在开头与结尾。monorepo 中，根文件只保留适用约 30% 以上代码库的规则，子目录文件按需懒加载，infra/ 通常单独成文件。审计已有臃肿文件时，先分类每行、提出精简版本给用户确认、保留失败驱动规则、合并去重并标记可迁移到其他载体的规则。限制：资料未提供官方文档、价格、平台支持范围等具体信息。