SuperAPI AI 工具集

agents-md-edit

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:在改动 AGENTS.md 前使用的流程规则技能,覆盖工作流规则、阶段表、术语表条目或维护者注释的编辑。不适用于 CLAUDE.md,因为它只是指针文件、本身不承载内容。

主要能力与结构:AGENTS.md 同一文件服务两类读者。<!-- FORGE:START --> 至 <!-- FORGE:END --> 为产品契约,由 Forge 渲染并随产品发布给用户,需面向未见过该仓库的人书写,不得出现 scripts/、lefthook.yml、.agents/skills、机器路径或维护者琐事,也不得手改以记录开发期间学到的内容。<!-- USER:START --> 至 <!-- USER:END --> 为维护者契约,包含不可妥协项、术语表、覆盖各表面的检查清单、易受伤点与开发运行手册。渲染器在重新生成时保留 USER 块,smartMergeAgentsMd 用正则提取并重新输出,内容可保留但其位置会被重新排到 FORGE 块上方,因此不要依赖位置。

写入前检查:判断受众,凡涉及仓库本地路径、脚本、钩子文件或测试的句子应放入 USER 块或 .forge/contributor-skills/,面向产品的文本应写命令而非文件。确认证据,每条规则需带来源标签,如挖掘修正用 [Forge #N ×n]、阅读运行代码用 [verified DATE]、借用默认无本地事件用 [imported],无标签规则会在下次重挖时被删除。判断是否优于默认,删除任何合格智能体本就会遵循的句子。保持简短,需多段辩护的规则即为错误规则。

提交:AGENTS.md 是受保护状态,暂存前需阅读 protected-commit;截至 2026-08-13,该门禁没有可授权 AGENTS.md 提交的写入器,包括仅改 USER 块的编辑,绝不要使用 --no-verify。

禁止事项:不要把内容放入 CLAUDE.md;不要编辑生成镜像(.claude/skills、.codex/skills、.cursor/skills、.hermes/skills、.agents/skills),应编辑规范来源并运行生成器,漂移是测试失败而非小问题;不要让仅内部推理为产品文本中的维护者假设辩护。

完成标准:改动位于正确块、带来源标签、用平实英文书写,并通过受保护状态门禁或报告为被阻止。

限制:资料未提供具体安装命令、价格或平台信息。