用途:为一个具体仓库生成 GitHub Copilot 代码审查所需的指令文件集。Copilot 代码审查会读取 PR 仓库中的指令文件来指导分析,本技能生成 .github/copilot-instructions.md(全仓库通用审查标准)以及多个 .github/instructions/*.instructions.md(通过 applyTo frontmatter 限定到特定文件类型的细分规则)。
主要能力:先探查仓库结构与技术栈(package.json、tsconfig.json、requirements.txt、pyproject.toml、Cargo.toml、go.mod、.csproj、docker-compose.yml、.github/workflows/ 等配置);读取已有指令文件(copilot-instructions.md、.instructions.md、.cursorrules、CLAUDE.md、AGENTS.md 等)与现有 lint/format 配置,避免重复 linter 已强制的内容;再规划按语言(TypeScript/JS、Python、Rust、Go、C#)、按框架与领域(React、Next.js、API、数据库、测试、Docker、CI、安全、无障碍、monorepo 分包)切分的文件;随后撰写、验证并输出完整文件树与逐个文件内容。
关键设计:采用 micro-file 架构,每个文件控制在 Copilot 的 4000 字符处理窗口内,超出部分会被静默忽略;文件建议 2500–3500 字符,单文件仍不足则再拆分。规则要求具体、可度量、可执行、语义化,安全规则置顶,附仓库真实模式的示例;命名用 kebab-case.instructions.md。
限制与注意:*.instructions.md 必须放在 .github/instructions/,copilot-instructions.md 必须在 .github/ 根目录;applyTo 为单个 glob 字符串而非数组;applyTo 缺失或为空表示该文件不适用任何文件;Copilot 无法访问外部链接;指令无法改变注释格式、PR 概述或合并行为;行为具有非确定性,不会每次遵守全部指令;仓库通常生成 5–12 个指令文件,建议从 10–20 条规则起步并根据实际 PR 结果迭代。