该技能面向仓库中「每次必读」的智能体指令文件,如 AGENTS.md、agents.md、CLAUDE.md、Copilot 指令、Cursor 规则等。核心目的是让这些文件保持精简、稳定、面向行动,视其为未来智能体会话的启动指令,而非会话笔记、决策日志、入职文档或通用参考文档。
核心规则:只保留应改变未来会话中智能体行为的内容。值得保留的通常涉及命令选择、安全边界、仓库特定工作流、行动前应先查看的位置、代码或工具不易体现的项目约定。
分类方式:对每一行候选内容判断其归属——保留(稳定的行为规则、安全边界、工作流规则或简短路由指令);命令(日常工作中反复需要的安装、构建、测试、生成或校验命令);入职(首次运行安装、本地引导或仅人工准备的环境);参考(架构、命名、归属、仓库或服务边界等更适合他处说明的稳定事实);交接(当前状态、临时迁移状态、下一步、未完成工作、阻塞项或会话特定上下文);强制(已由脚本、钩子、CI、测试、linter、类型检查、生成检查或策略机械执行的规则);删除(重复、过时、含糊、历史性、被否决的方案、决策痕迹或元评论)。非 AGENTS 内容应使用仓库既有的展示面,除非用户要求,不要自创文档结构。
编辑规则:优先使用正面指令;负面指令仅用于稳定的安全、安保、归属或破坏性变更边界;不要因为临时状态在编辑时重要就保留它;不要在必读文件中记录被否决的方案、反转或「我们决定不做」的历史;不要重述工具已强制的内容,除非在工具运行前智能体行为会不安全;当智能体只需知道去哪看时,用简短指针替代详细参考事实;日常智能体工作所需的重复命令应保留;首次运行安装与本地环境引导说明移到入职或安装展示面;文件应短到行动前可快速浏览;避免「写干净的代码」「遵循最佳实践」「小心一点」等含糊规则。
去重检查:保存前将拟写内容与现有必读指令文件、README、docs、scripts、CI 配置、已有技能或规则文件比对;若同一指令已存在于他处,仅在指针会改变智能体行为时保留简短指针。
保存前审查:编辑必读指令文件前,先产出简短审查,包含保留行、移动行及其目标、删除行、发现的重复或过时内容、拟议 diff。除非用户明确要求直接编辑,或所需变更不经编辑无法完成,否则在用户批准前不要保存。
最终门禁:保存前,每一保留行必须至少对一个问题的答案为「是」:这应改变智能体未来会话中的行为吗?这能防止可能的不安全或破坏性操作吗?这告诉智能体日常工作时该运行哪条命令吗?这告诉智能体行动前该去哪看吗?这是仓库特定且不易从代码、工具或既有文档看出的吗?