用途：为代码仓库生成或整理一份精简的指令层，只收录经过验证、会实质改变智能体行为的项目事实；通用工程知识不应放入常驻指令。默认在主对话中运行，如需使用子代理，须先就代理数量和范围获得明确批准，超出批准范围需再次询问。
主要能力：先探查现有指令、归属、作用域与符号链接。保留可用的共享来源（如 AGENTS.md 指向 CLAUDE.md），不因偏好文件名而替换；仅在需要所请求的工具支持时添加兼容文件。对不熟悉的或多工具仓库，可用内置探测器定位指令路径与框架/工具信号： "<skill-directory>/scripts/detect-agent-context" --root "<repository-root>" --format json Windows 下使用 scripts/detect-agent-context.cmd，参数相同。脚本路径相对本技能解析，而非目标项目。探测器只索引公开清单与指令/配置路径，不读取凭证、环境文件或指令内容；应把它当索引，持久化前需回到来源核对指令与命令。
规则取舍：保留非显而易见、有项目证据、跨任务有用且足够具体的规则，例如确切的命令运行器、生成文件归属、特殊业务边界、必需检查、仓库专属部署或审批约束。删除或改写通用建议、人设、重复规则、过时命令、详尽清单、强制问卷、无依据评分及与当前项目意图冲突的流程。不要虚构新的审批门槛或削弱已有明确门槛。详细设计、API、测试与部署指南留在原归属处并用清晰读取条件链接。排除机密、家目录路径、提示记录、任务日志与全局工具清单。
写入与核对：默认使用单一紧凑的共享指令来源；嵌套文件仅用于目标工具支持的有意义作用域差异，且不重复父级规则。Codex 需先检查同目录 AGENTS.override.md 的优先级。根文件建议约 80–150 行，超过 200 行或 16 KiB 应检查重复与细节错位，但不为凑目标行数而填充，也不为省编辑而提高全局上下文限制。用受跟踪的差异便于恢复，保留否则会丢失的未跟踪内容，不例行创建备份、不改历史。
验证：检查引用的路径与命令、作用域/优先级、符号链接、重复规则和未解决的占位符，测量行数/字节数并确保指令链适配目标工具，适用时运行仓库校验器。静态查看命令不代表已执行，不要为验证拼写而运行破坏性命令。最后报告保留、变更、移动或移除的重要规则、所用证据及未解决的冲突。