首次创建定制

先选择要反复使用的内容：长期行为约定使用 custom instructions，按需执行的一项任务使用 prompt file，持续承担特定职责的工作流使用 custom agent。官方模板适合作为起点，仍需按项目语言、约定和使用入口调整。

用个人指令做一次对照

官方入门教程先在 GitHub Chat 请求生成一个计算圆面积的 JavaScript 函数，再从左下角个人头像进入 Personal instructions，保存函数编写偏好后重试同一个提示。

偏好可以包括输入校验、易懂命名、错误路径提前返回、JSDoc 与用法示例。比较两次回答时，不仅看注释是否增加，也要核对行为是否改变。官方两个示例对零半径和错误输入的处理就不相同；不能把它们当作语义完全一致的代码。

需要团队共享时，使用仓库指令。首次定制教程把通用文件描述为根目录的 copilot-instructions.md，与专门操作页给出的 .github/copilot-instructions.md 不一致；本章采用后者，详见仓库指令。各客户端的路径专用指令支持范围也应查对应操作页。

在 VS Code 创建可调用提示

官方 prompt file 示例将文件存为 .github/prompts/explain-code.prompt.md，使用 agent: 'agent' 与 description frontmatter，并通过 ${input:code:Paste your code here}、${input:audience:Who is this explanation for?} 收集代码和目标读者。

可以按以下步骤完成第一次试用：

1. 创建该目录下的 prompt file，写明需要解释的内容和输出结构。
2. 在 VS Code 的 Copilot Chat 输入 /explain-code。
3. 根据提示提供代码与读者水平。
4. 核对概述、分步解释、术语和示例是否与实际代码一致。

该教程的 frontmatter 会选择 agent mode。若任务只需要解释，也应审阅实际使用的工具与权限。这里的命令调用步骤针对 VS Code；官方入门页的支持列表并未覆盖所有较新客户端条目，跨 IDE 使用见Prompt files及功能矩阵。

创建 README 专用 Agent

在 GitHub Agents 页面选择试用仓库和分支，打开 agent 选择菜单并点击 Create a custom agent。官方流程会创建 .github/agents 下的模板，示例将其命名为 readme-specialist.agent.md。

profile 包含 name、description 和 tools，README 示例将工具限制为 read、search、edit，正文说明只处理独立文档文件，避免修改源代码。按团队需要缩小职责、约定产物与明确范围。

将 profile 合入默认分支后，回到 Agents 页面刷新并选择该角色，提交改进 README 的任务。检查会话和生成的 PR，确认文档事实、相对链接及修改范围。profile 的自然语言要求并不替代工具权限或代码审查。

如何判断定制有效

保持输入任务相同，比较定制前后结果是否符合要求，并检查是否引入了不需要的行为。一次回答符合偏好不能证明所有请求都会遵守；逐步调整指令，并用项目中的代表任务复验。共享角色的完整字段和发布范围见云端 Custom agents。