用途:指导在 GitHub 托管代理(Copilot 云代理、自定义代理、Copilot 代码审查、GitHub Agentic Workflows)与本会话编排之间做分工,把范围明确、可独立验证的任务交给代理,把需要判断、设计或协调的工作留在会话内。
主要能力:委派方式包括 assign_copilot_to_issue(把已有 issue 交给代理)、create_pull_request_with_copilot(按描述的任务生成 PR)、get_copilot_job_status(轮询进度)、request_copilot_review(对 PR 发起审查)。适合委派的场景是范围明确且可独立测试、机械性批量修改、可并行、验收标准清晰、影响面小;需留在会话内的是涉及判断或设计、触及人工审查路径、需对话澄清、跨仓库或系统、安全敏感或不可逆的任务。代理产出的 PR 仍走同样审查、CI 与合并门槛。
使用方式:仓库级 AGENTS.md 提供构建、测试、风格与架构约定,嵌套 **/AGENTS.md 可限定子树;仓库缺少且反复开发时值得补写。Agentic Workflows 用 gh extension install github/gh-aw 安装,gh aw init、gh aw compile 将 Markdown 编译为 lock.yml,可加 --actionlint --zizmor --poutine 运行安全扫描;gh aw run <name>、gh aw logs、gh aw audit <run-id>、gh aw status 用于运行与审计。Markdown 与 lock.yml 应一同提交,改了 .md 未重新编译会运行旧行为。写回 GitHub 通过声明式 safe outputs 在独立作业中执行,而非授予代理写权限。可考虑定时分类新 issue、每日活动摘要、依赖更新分类、按 diff 打标签、陈旧工作清理、文档漂移检查等读多写少的形态。
限制:不要把有确定行为的任务交给代理,例如定时格式化应由确定性工作流完成;单次代码审查不能替代人工审查;价格、平台与效果等细节暂未提供。