Issue 理由、置信度与建议审批

控制自动化如何应用 Issue 属性修改，并审核待处理建议。

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

自动化处理 Issue 时，可以为每个动作附带 rationale 和 confidence，并把需要复核的动作作为 suggestion。该能力目前为 public preview，仓库 automation level 设置正在逐步推出。

适用动作

支持 Issue 的标签、字段、类型、关闭和负责人变更。不适用于人手动修改，也不覆盖自动化创建 PR、推送代码等其他动作。

这套能力可由 Copilot cloud agent Automations、GitHub Agentic Workflows 或 REST / GraphQL 集成使用，不限于某个单一运行平台。因此 public 仓库的 Issue 建议能力，不能与仅 private/internal 仓库的 cloud Automations 可用性混为一谈。

Rationale 与 confidence

支持的动作会记录原因及 high、medium 或 low 置信度。已执行动作旁的图标可查看理由；待审批建议会展示拟改动和理由，供决定是否应用。

在 cloud agent 自动分类任务中，无需专门要求附带 rationale 和 confidence。Prompt 应说明分类目标和需要处理的属性；若某种修改总要先确认，应要求 suggest，即使置信度高也作为建议。

仓库 automation level

进入 Settings → Planning → Agent suggestions for issues，选择等级并保存。未看到入口时，可能尚未进入逐步推出范围。

等级	官方定义
Full control	所有修改都等候审核
Cautious，默认	仅高置信度修改自动应用，其余等待审核
Balanced	明确的常规修改自动应用，有歧义的等待审核
Full automation	自动应用修改，只有标记为不确定的才保留

官方没有在该表给出 Balanced 的固定数字或与 medium 的严格一一映射，不能自行补出阈值。

查找与处理建议

可搜索：

is:issue is:open has:suggestions

打开 Issue 的 approvals panel，检查拟修改的标签、类型、字段、负责人或关闭动作，以及其理由和置信度。

Accept 立即应用一条，Decline 丢弃而不修改 Issue；也可用 Accept all 或 Decline all 批量处理。

审批不是权限边界

官方明确：建议审批是工作流便利功能，不提供服务器端安全隔离。有 Issue 写权限的代理仍可能通过 REST 或 GraphQL 直接修改，而不提出建议。限制“允许做什么”应使用仓库、代理及工具权限，不能只选择 Full control。

在 Agentic Workflows 中使用

声明相关 safe-outputs，如 add-labels、set-issue-type、set-issue-field、assign-to-user、assign-to-agent、close-issue。issue-intent 控制是否要求理由和置信度：

safe-outputs:
  add-labels:
    issue-intent: true

省略时元数据可选，已有工作流继续运行；true 要求提供，缺失会使工作流失败；false 完全不携带这类元数据。修改后用 gh aw compile 编译，并提交 Markdown 与生成的 lock 文件。工作流主体结构见配置与维护。