推动团队采用代理式 GitHub Copilot

在开发者开始使用 Copilot 后，有针对性的推广可以帮助成熟的团队将 GitHub Copilot app 和 Copilot CLI 纳入日常工作。 这些工具补充了 IDE 聊天和代理模式。 目标是使用最适合每个任务的工具帮助团队构建可重复的代理工作流。

本行动手册适用于为成熟团队协调 Copilot 采用工作的人员。 它指导你完成为期两周的载入冲刺，以测试工作流是否适合和建立使用习惯。 为期两周的冲刺提供了采用的早期信号，没有足够的证据来证明长期生产力或成本影响。

冲刺之前

确定部署协调器和负责策略、许可证、指标、安全、支持和支出的人员。 如果发现意外的策略、安全性或成本问题，请同意谁可以暂停冲刺或禁用访问权限。

选择并装备初始团队

先从一个团队或一小组成熟团队开始。 参与者更有可能相互学习，你可以将团队实践与个人偏好区分开来。

选择符合以下条件的团队：

• 能够以身作则示范使用方式并在团队会议上进行讨论的经理或团队负责人
• 一位或多位经验丰富的个人贡献者，能够测试高级工作流、支持同事，并将成功的试验转化为团队指南
• 适合代理工具的工作，例如调查代码库、跨文件进行协调更改、运行测试或准备拉取请求
• 可以用作基线的稳定交付指标

避免只选择爱好者。 纳入具有代表性的不同经验水平组合，以便在冲刺过程中暴露出常见的配置、信任和工作流障碍。

选择一个真实项目，其中包含足够多的合适工作内容，供参与者在冲刺期间多次使用智能体工具。 然后准备访问权限：

1. 确认每个参与者都通过将管理冲刺策略的组织接收其 Copilot 许可证。
2. 请与相关企业和组织的所有者合作，为 GitHub Copilot app 和 Copilot CLI 启用单独的策略。
3. 在启用策略之前，请确认范围。 组织策略适用于通过该组织接收其许可证的每个人，而不仅仅是所选团队。 企业策略还可以限制组织所有者可以更改的设置。 有关详细信息，请参阅“针对企业和组织的 GitHub Copilot 策略”。
4. 在启动之前，要求参与者安装和登录这两个工具。 请参阅 GitHub Copilot 应用入门 和 设置 GitHub Copilot CLI。
5. 确认每个参与者都可以访问项目并使用预期策略和托管设置下的工具。
6. 向负责衡量冲刺的人员授予对 Copilot 使用指标的访问权限。 有关所需角色，请参阅 GitHub Copilot使用情况指标。

如果首次启用这些工具，请将冲刺视为更广泛的功能试点的一部分。 在项目开始前，先估算按使用量计费的成本，设置适当的预算并设定符合预期的停止方式，同时计划在冲刺期间监控支出。 有关完整过程，请参阅 在企业中试点新的Copilot功能或模型。

定义激活和结果目标

为载入冲刺设置 激活 目标。 例如，为每位参与者设定一个目标：在冲刺期间的每周，至少在三个不同的日子使用Copilot app或Copilot CLI中的任意一种。 重复使用可让参与者有时间尝试不同任务的工具，并确定它们适合日常工作的位置。

将激活目标与一两个对团队重要的结果对应起来。 例如：

• 缩短从开始工作到发起拉取请求的时间。
• 完成更多维护任务，而不会延迟计划的功能工作。
• 缩短调查不熟悉的代码所用的时间。
• 在提高拉取请求吞吐量的同时，保持或提高评审质量。

在冲刺开始前记录结果基线。

不要将生成的代码量用作成功目标。 生成的更多代码不一定能创造更多价值，并且可能会增加评审或维护工作。

准备工作流、跟踪和保护措施

为团队提供两三个与当前工作匹配 的已批准工作流 ，而不是要求参与者“更多使用 AI”。 例如：

• 使用 Copilot CLI 排查故障、规划多文件更改、运行测试或查看本地更改。
• 使用 Copilot app 基于议题开展工作，在代理会话中进行更改，并创建拉取请求。
• 在有帮助时，可在各工具之间切换，例如使用 Copilot app 从 Copilot CLI 打开 copilot app。

对于每个工作流，记录所需的人工评审、测试和审批步骤。 如果企业使用自定义说明、代理、托管设置或批准的模型上下文协议 （MCP） 服务器，请在冲刺之前对其进行配置。

确定团队将如何共享示例并跟踪进度。 您可以：

• 添加临时拉取请求标签，例如 copilot-pilot，以便参与者可以找到并讨论相关示例。
• 向相关提交消息添加一致的标记，例如 Copilot-Assisted: true，如果组织已分析提交元数据。
• 准备一个团队仪表板，显示每周有三天或更多天在任一工具上活跃的参与者占比。
• 选择一个现有的团队会议或频道，参与者可以在其中共享任务、工作流和结果，而无需共享可能包含敏感信息的提示。

标签和提交消息标记提供自报告上下文，而不是权威使用情况数据。 使用它们查找示例并启动对话。 使用 Copilot 使用情况指标来衡量活动情况。

在启动之前，请记录：

• 在冲刺期间，谁将负责审查访问权限、策略行为、代理活动、支持问题和支出
• 参与者如何报告意外或不安全的行为
• 会导致暂停或停止冲刺的情况，例如非预期的政策范围、反复出现不安全结果，或支出接近商定的上限
• 负责人将如何禁用这些工具或删除冲刺专用配置

在冲刺期间

在第一周，删除设置障碍并创建共享体验。 第二周，加强成功的工作流，并解决障碍。

第一周：启动并完成第一个工作流

1. 与整个团队一起启动。 说明要改进的结果、激活目标以及参与者必须遵循的护栏。
2. 演示实际工作。 让经理、团队主管或经验丰富的参与者完成团队代码库中选定的工作流之一。 显示仍需人工审查和批准的环节。
3. 一起完成第一个任务。 将参与者两两分组，以便每个人都从 Copilot app 或 Copilot CLI 中的一个会话开始，并完成一项小而低风险的任务。
4. 在正常工作期间使用这些工具。 要求参与者在激活目标中的天数内至少使用一个选定的工作流。 避免在完成第一个任务后设置人为练习。
5. 检查操作情况。 确认策略和托管设置是否按预期运行。 查看支持和安全报告，并根据商定的限制检查基于使用情况的支出。

第二周：强化有用的工作流

1. 讨论在现有会议中的使用情况。 询问这些工具在哪些方面提供了帮助、参与者何时选择了另一个 Copilot 工具或功能，以及是什么阻碍了他们。
2. 应对工作流程障碍。 使用以下操作：
   • 另一个工具更适合该任务：保留该任务的现有工作流，并将冲刺重点放在受益于所选工具的工作上。
   • 参与者不知道如何开始：为所选工作流之一提供经验证的起始提示词。
   • 代理缺少上下文或生成不良结果：改进存储库说明、任务说明或可用工具，然后再次测试工作流。
   • 参与者不信任结果：演示如何查看差异、限制权限、运行测试和放弃不需要的更改。
   • 该工具不可用或被阻止：验证许可证分配、策略、安装、身份验证、网络访问和批准的工具配置。
3. 调整工作流指南。 删除没有帮助、修复访问或配置问题的工作流，并从成功的会话中共享做法。
4. 再次检查操作。 查看安全报告、代理活动、策略行为、支持需求和支出。 如果满足某个停止条件，请暂停冲刺。
5. 查看初步结果。 第二周结束时，将激活和结果信号与基线进行比较。

不要阻止正常 IDE 使用。 目标是帮助团队在减少工作量或扩展其可完成的任务时选择代理工具。

冲刺结束后

测量结果，记录所学的内容，并确定是重复、扩展、重新设计、暂停还是停止推出。

度量持续使用情况

使用来自 Copilot 使用情况指标 API 的每个用户的每日报告：

• used_cli 并 used_copilot_app 显示一个人是否在给定的一天使用了每个工具。
• totals_by_cli 和 totals_by_copilot_app 提供会话、请求和提示词计数，以便进行更深入的分析。

检查激活目标：

1. 将每日数据行筛选到冲刺日期范围内。
2. 保留 used_cli 或 used_copilot_app 为 true 的行。
3. 按用户和周对行进行分组。
4. 统计每个组中不同的 day 值的数量。

当参与者每周的计数都至少达到 3 时，即视为达到三天目标。

若要按团队查看这些字段，请将用户-团队报告与按用户划分的使用情况报告关联。 请参阅“团队级Copilot使用情况指标”。

将影响力仪表板作为了解整体代理采用情况的方向性和长期性参考。 采用队列使用尾随的 28 天窗口，并可以反映来自此冲刺中两个工具之外的代理功能的活动。 请勿使用队列变更将影响归因于此次冲刺。 请参阅“查看 Copilot 影响力仪表板”。

衡量团队成果

使用如下度量值将冲刺期与基线进行比较：

• 每个开发人员合并的拉取请求
• 合并拉取请求的中值时间
• 维护或积压工作完成率
• 缺陷、返工或评审结果
• 简短调查中的参与者信心与满意度

结合团队反馈审查定量结果。 项目复杂性、人员配备和工作类型的差异可能会影响交付指标，因此不要将每次更改都归咎于 Copilot此。

确定如何扩展

汇总：

• 达到激活目标的参与者的百分比
• 哪些工作流参与者在不提示的情况下重复
• 最常见的设置、治理或信任障碍
• 所选团队结果中的更改
• 按使用量计费的成本以及为支持部署上线所需的任何运维工作
• 任何安全问题及其解决方法

当初始团队展现出可重复的工作流程，以及可接受的质量、安全性、支持需求和成本后，再将此做法扩展到另一个成熟团队。 如果激活较低，请确定并解决团队的特定障碍，例如设置问题或不适合的工作流。 对于已成功采用这些工具的团队，不要更改其推广安排。

如果为此冲刺启用了专用工具，请不要使用两周的数据作为长期成本影响的证据。 继续更广泛的试点，直到有足够的计费周期数据来做出可防御的扩展决策。

随着范围扩大，请保持相同的激活标准和结果定义，以便比较各个发布组。 在掌握足够的内部证据，能够为企业界定可持续且有价值的使用方式之后，重新审视这些目标。