定制机制速查
按持续规则、模板任务、专门角色、生命周期动作和外部系统选择定制机制。
This page has not been translated into English yet. The original Chinese version is shown below.
先区分需要“提供上下文”“让模型选择流程”还是“在某个事件执行代码”,再选择机制。同一项目可以组合多种定制,但它们的触发、权限和客户端支持不同。
按需求选择
| 机制 | 何时使用 | 触发与典型位置 |
|---|---|---|
| Custom instructions | 持续适用的项目规则与背景 | 在对应作用域加入上下文;如 .github/copilot-instructions.md |
| Prompt files | 重复发起、输入不同的单次任务 | 手动选择;如 .github/prompts/*.prompt.md |
| Custom agents | 专门角色、工具范围和任务阶段 | 手动选择或按客户端调用;如 .github/agents/AGENT-NAME.md |
| Subagents | 把子任务放入独立上下文 | 主 Agent 委派或提示引用;它是运行时任务,不是单独的通用文件类型 |
| Agent skills | 按需加载带脚本和资源的专项流程 | 根据相关性加载,使用 SKILL.md 目录结构 |
| Hooks | 在指定生命周期事件执行程序 | 如 .github/hooks/*.json,由事件触发 |
| MCP servers | 访问外部 API、数据库和工具 | 客户端配置、仓库 MCP 设置或角色 mcp-servers |
指令文字不会像 Hooks 一样成为确定执行的程序;Skills 的按需加载也不同于始终加入的规则。Hooks 的实际失败处理和权限取决于事件与客户端,不能把速查中的“保证执行”理解为所有错误都失败关闭。
支持范围与细节入口
Prompt files 在官方速查矩阵中不支持 GitHub.com 或 CLI;CLI 的 Skill、扩展命令等是其他机制。Hooks 的矩阵将 VS Code 标为 preview,并列出 GitHub.com 与 CLI 支持。其他 IDE、角色和 Skills 的状态应结合IDE 文档及具体功能页核对。
该速查把组织/企业 Custom agents 来源目录做了概括;实际部署应按共享角色管理和治理仓库选择当前支持的仓库,不能只按一张简表推断名称和权限。
JetBrains 的集中编辑器
在 Copilot Chat 右上角设置中选择 Customizations,可以集中管理 Custom agents、Skills、工作区/个人指令和 Prompt files。选择 Workspace 时面向当前项目,选择 Personal 时面向个人跨项目定制。
继续配置时,参阅CLI 定制、网页指令或IDE Prompt files,不要把同名设置的文件格式跨入口复制。