agents-md-craft

Agent 指令文件

选择模型之前先选择分支。此工作流由当前协调器和直接工具运行，不会分派工作者。

将根指令文件视为缓存上下文。只保留适用于大多数工作的规则。将有条件的细节移至专门的文件，并在根文件中指向这些文件。

目标

根据已核实的项目事实，生成一套权威的指令。审计会报告拟议的差异。创建或更新请求会写入约定的范围，并验证其指针。

工作流

1. 将请求归类为 audit、create、update 或 staleness check。检查目标文件以及为其中指令提供依据的项目事实：用途、布局、命令和长期约束。
2. 如果 AGENTS.md 和 CLAUDE.md 均存在，则除非项目要求内容分开维护，否则选择维护中的文件作为规范文件。当当前工具能够遵循另一个文件时，将其保留为简短的文本指针。不要创建两份会逐渐偏离的副本。
3. 将根文件精简至结构完整所需的最小内容：
   1. 项目用途和主要区域；
   2. 适用于常规工作的命令和约束；
   3. 指向有条件指南的简短链接。
4. 将操作手册、冗长的命令说明、子系统规则和 ADR 移至 agent_docs/ 或项目现有文档。对于现有格式化工具、代码检查工具和钩子能够强制执行的规则，指向这些工具。保留需要用文字说明的团队规范和安全边界。使用稳定的文件或符号指针，而不是复制代码；包含行号时请核实。
5. 对于 audit，提供发现项、预算视图和具体草案，但不写入文件。对于 create 或 update，只写入所请求的文件及其必要的 agent_docs/ 引用。不要臆造项目事实。
6. 根据实际定义检查变更后的命令，并修正变更后的链接或行指针。仅在需要消除重大不确定性或满足代码库门槛时运行命令；记录部署命令并不代表获准部署。未变更内容可复用有效证据。报告规范文件、变更内容、未解决的事实和验证证据。

决定内容放置位置或范围时，请阅读 references/principles.md。进行审计或大幅重构时，请使用 references/checklist.md；小幅编辑只需检查与其变更契约相关的项目。