用途:AI 引导文件是仓库本地的上下文文档,用来告诉编码代理如何在项目中工作。本技能适用于为 AI 编码代理新增或修订仓库指令、在 AGENTS.md 与各工具专用指令文件及产品/技术上下文文件之间做选择、审计仓库是否给代理提供了足够的命令、约束与示例,以及引入需要自身记忆、语法或范围规则的新代理工具。不适用于一次性聊天指令、临时实现笔记或与仓库无关的通用建议。
主要能力:提供文件选择器,按用途区分各类文件。AGENTS.md 用于适用于任意编码代理的仓库级、厂商中立规则,含项目摘要、工作流、确切的安装/测试/构建命令、分支策略、评审期望与需审批的高风险操作;PRODUCT.md 提供产品上下文;ANALYTICS.md 定义指标、事件与属性模式、身份与归因、隐私边界等度量契约;TECH.md 记录技术栈与集成约束;STRUCTURE.md 说明目录结构、归属边界、导入与命名规则;VISION.md 承载长期愿景与非目标;DESIGN.md 提供设计系统指导;CLAUDE.md、GEMINI.md、.github/copilot-instructions.md、.cursor/rules/*.mdc 分别对应各工具专用或路径范围的规则。
使用方式:先盘点已有引导文件,再为指令选择最窄且持久的归属位置;写入确切的命令、路径、可靠示例、已知约束与评审期望;优先用链接和简短摘要而非复制第三方长文档;编辑时清理过时或重复内容,避免文件间冲突;核实所提及的命令与路径,无法本地运行时在文件中说明原因。
限制与质量要求:文件应说明自身控制范围与读者,包含可运行命令而非模糊偏好,指向仓库内已有示例,点明安全、数据、性能、可访问性、产品与部署相关约束,并保持足够简短以便实际工作中重读。常见错误包括把偏好塞进每个文件、写通用建议、复制外部长文档、为临时工作新建文件、留下文件间冲突。完成前需确认所选文件与指导范围匹配、文件名与路径大小写准确、各类命令为最新、示例与链接可解析。