用途:创建、编辑、维护 AGENTS.md 与 .agents/rules/,适用于新增、修改、重构或优化项目规则、约定与约束。
主要能力:管理两层规则体系——始终加载的索引加模块化文件。每个模块化文件必须从索引链接,否则 agent 无法找到。选择 AGENTS.md+.agents/rules/ 还是 CLAUDE.md+.claude/rules/、路径作用域、frontmatter 或双格式前,先打开 agents-vs-claude.md;写新规则文件或索引骨架前先打开 examples.md。
使用方式:init 读取包清单;若索引或规则目录已存在,写入前先询问;创建少于40行的索引(含空 Rules 段)与规则目录。add <name>:将名称 slug 化,无索引则先 init,询问强制内容与生效时机,写模块化文件,并加一条与文件路径匹配的索引条目。edit:只改指定索引段,保持所有模块化文件链接完整。optimize:清点索引与文件(标出孤立项与断链);删除 linter 强制、通用、冗长及可从代码得出的规则;压缩为条目;显示 diff 并等待。目标:索引少于80行,每条规则少于60行。自由请求按 add 处理并推导名称;规则不清晰时问1至2个范围问题。
限制:未经询问不得覆盖现有文件;未确认内容不得写规则文件;新规则默认为模块化文件(20–60行),1–2行约束放入 Universal Rules;用户点名索引内容(技术栈、命令、通用规则)时就地编辑该文件;写具体禁止项;不添加通用最佳实践、linter 强制规则或 agent 能从代码读到的事实。