Agentic Workflows

使用 Markdown 定义在 GitHub Actions 中运行的代理任务，并提交可审查的编译产物。

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

GitHub Agentic Workflows 在 Markdown 中定义任务，通过 GitHub Actions 运行 AI coding agent。当前为 public preview，可用于 Issue 分类、CI 调查、文档维护和周期性报告。

与 Automations 的区别

项目	Cloud Automations	Agentic Workflows
配置位置	GitHub 或 app 的 Automations 界面	`.github/workflows/` 中的 Markdown
版本管理	不提交到 Git，配置只创建者可见	`.md` 和编译得到的 `.lock.yml` 一起提交，可经 PR 评审
执行	启动 cloud agent 会话	运行 GitHub Actions 工作流
引擎	该自动化选择的 Copilot 模型	Copilot、Claude、Codex、Gemini
仓库前提	private 或 internal，并启用 cloud agent 和 Automations	启用 Actions，满足所选引擎认证与仓库权限

不要把 cloud Automations 的 public 仓库限制或 Agents secret 保存位置直接套到 Agentic Workflows。

YAML frontmatter 定义触发器、权限、工具和允许写操作；Markdown 正文说明任务目标。随后编译为强化限制的 .lock.yml 工作流，提交两份文件，再按触发器或手动运行。

代理默认使用只读仓库权限，在隔离且有防火墙的 Actions 环境中执行。写动作通过明确声明的 safe-outputs 处理，拟输出会经过威胁检测；敏感凭据放在隔离的后续 job，而不是直接开放给代理运行时。

这些机制仍需要合理配置：任务说明、允许工具与写操作应一致。需要人为验收的结果，可以作为 Issue、评论或 PR 输出，再按仓库流程处理。

engine 省略时为 copilot，也支持 claude、codex、gemini。只在选择 Copilot 时需要相应 Copilot 计划；其他引擎有自己的认证和推理费用。

本文组覆盖 GitHub Docs 的主要工作流入口与配置。更深的 frontmatter 语法、网络与运行器参考以官方 Agentic Workflows 文档为准。