本技能给出三类文件的格式规范,供生成工作流文件、编写蓝图或校验格式时使用。
用途:统一 Blueprint、gh-aw Markdown 和 GitHub Actions YAML 的写法。
主要格式:
- Blueprint:workflows/BLUEPRINT.md,Markdown 加 YAML frontmatter。frontmatter 供机器读取,含 agents(name、role、model、outputs)、routing(event、condition、agent、concurrency_group)、labels、human_gates、error_handling;正文写系统目的、智能体说明、路由理由与已知限制。
- gh-aw Markdown:gh aw CLI 的工作流定义,frontmatter 字段有 on、permissions、tools、engine、safe-outputs、concurrency、timeout-minutes,正文即智能体系统提示词。可用 gh aw compile workflows/triage.md 生成 workflows/triage.lock.yml,两者都需提交。
- GitHub Actions YAML:无 gh-aw 时直接编写,含 name、on、concurrency、permissions、jobs,并用 bot 角色守卫防止循环触发。
使用方式:Agent 提示词可存为独立文件后用 cat 读取,也可内联。生成的 YAML 建议附安全注释,说明无 safe-outputs 缓冲、智能体有完整网络访问,需以最小权限、fork PR 守卫和 bot 守卫缓解。模板存于 templates/,frontmatter 含 name、triggers、permissions、labels_required、conditions、concurrency、error_handling。
限制:资料未提供具体收费、平台或效果说明;安全性与实际行为需另行验证。