测试与发布 Custom agents

组织或企业共享角色影响多人的工作流。GitHub 提供先在配置仓库内测试、再移动到共享目录发布的方式；当前测试发布能力标为 public preview。

准备测试版本

先完成组织或企业配置。在对应 .github-private 仓库创建：

.github/agents/

将新 profile 放在这里，或复制已有角色作为测试版本，再合入默认分支。此目录中的角色只对有该仓库访问权限的人可用，而且只能在以该仓库为任务目标时使用。

这与根 agents/ 目录的共享行为不同。仅把配置仓库设为 private，不能保证已放进共享目录的角色只对少数人可用。

执行测试

1. 打开 Agents 页面，选择 .github-private 仓库。
2. 在 agent 菜单选择测试角色，提交代表性任务。
3. 从 Recent sessions 打开结果，检查工具范围、输出和验证行为。
4. 修改 profile，重复测试，直到符合要求。

测试任务应对应角色实际职责，例如规划角色是否仅返回计划、文档角色是否控制修改范围。若需要验证具体项目的真实依赖，仍需在相应项目环境中安排测试，不能把配置仓库的一次成功直接当作所有项目均可用。

发布

把 profile 从 .github/agents/ 移动到根目录的 agents/，合入默认分支。角色随后面向对应组织或企业的用户共享。

发布范围由 .github-private 所承担的组织或企业来源角色决定。企业来源必须已经在设置中指定；不是任意组织下同名仓库都会自动成为企业来源。

发布后检查

检查 agent 选择菜单是否出现角色，并用新的任务验证版本。已有 PR 会继续使用原 profile 版本；不要拿旧 PR 的行为判断新版本未生效。

组织可用审计日志过滤器 actor:Copilot 查看相关活动；企业监控应按其 agentic activity 管理入口执行。