首次创建定制

通过一次对照试验理解 custom instructions、prompt files 和 custom agents 的不同用途。

This page has not been translated into English yet. The original Chinese version is shown below.

先选择要反复使用的内容：长期行为约定使用 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?} 收集代码和目标读者。

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

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

该教程的 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。