提高云端任务交付质量
从任务范围、仓库指令、依赖准备和集中反馈改善工作结果。
优先交付边界清楚、结果可验证的任务。比起只写“改进这个项目”,说明具体问题、预期行为和验收方式,更有助于代理找到合适实现。
写出完整任务
任务至少包含问题或目标、验收标准和已知代码线索。已有文件路径时直接提供;尚不清楚位置时,可以先让代理搜索和调查,避免把未经核实的猜测当作实现要求。
适合初次尝试的工作包括修复局部 bug、调整界面、补测试、更新文档、改善无障碍或处理明确的技术债。涉及广泛架构依赖、关键业务逻辑、生产事故或高度模糊的需求时,先由人明确方案和责任范围,再决定委派哪些可独立验证的部分。
先研究再实施
需要理解代码库或确认方案时,使用研究、规划与迭代,先让 Copilot 给出调查结论和计划,然后检查分支 diff,最后创建 PR。
这可以把“理解错了问题”与“实现不符合计划”分开评估,也便于在代码改动扩大前收敛范围。
固化构建与测试知识
官方列出的云端代理指令文件包括:
| 文件 | 用途 |
|---|---|
.github/copilot-instructions.md | 仓库通用说明、构建测试与约定 |
.github/instructions/**/*.instructions.md | 对特定路径或文件类型生效的说明 |
嵌套 AGENTS.md | 对应目录中的代理说明 |
仓库根目录 CLAUDE.md、GEMINI.md | 云端代理支持读取的其他指令文件 |
路径型指令通过 frontmatter 中的 applyTo glob 指定作用范围。该能力清单针对 cloud agent,不能据此推断所有 IDE 或 CLI 都读取同样的文件。
将真实的依赖安装、构建、格式和测试操作写入仓库指令;不要复制与项目无关的示例命令。组织指令也可参与工作,实践指南说明 cloud agent 优先考虑仓库级指令。
提前准备开发环境
代理有临时开发环境,但让它每次试错安装依赖可能慢且不稳定。官方支持用 copilot-setup-steps.yml 预装所需工具与依赖;具体工作流位置、权限和执行结构见开发环境配置。
同时说明哪些测试必须运行、如何判断通过,以及已知的环境限制。环境能启动与任务已验收是两个阶段。
按工作流扩展能力
GitHub MCP 和 Playwright MCP 默认启用;还可配置本地或远程 MCP,为任务提供所需工具。Custom agents 用专门的说明和工具范围处理反复出现的任务,如测试、文档或语言专项工作。
自定义 agent 默认继承仓库已配置的 MCP 工具,也可进一步限制工具范围。选择工具时应围绕实际任务所需能力,不把“工具更多”视为结果必然更好。
集中反馈并复核
把相关评审意见集中提交,再通过 @copilot 或批量修复入口要求调整。自己也可以直接向工作分支提交代码;最终仍需检查合并后的行为和测试,见PR 协作与评审与验收。