SuperAPI AI 工具集

gh-aw-workflow-authoring

办公与效率

查看项目

更新于 10-15 22:11

技能介绍

用途:该技能面向 GitHub Agentic Workflows 的编写,帮助用自然语言 Markdown 替代复杂 YAML 条件逻辑,构建 AI 驱动的仓库自动化。

主要能力:讲解工作流文件结构(.github/workflows 下的 .md 源文件与编译生成的 .lock.yml);YAML frontmatter 必填字段 on、permissions、tools、engine,可选 name、description、timeout-minutes、concurrency;工具配置包括 github toolsets(repos、issues、pull_requests、projects)、safeoutputs___issue/pull_request/comment/file/label/noop 等写操作、edit/view/create 文件操作、bash 受限命令、web-fetch、web-search、playwright 与自定义 MCP 服务器;自然语言指令写法与 Analyze→Decide→Act、条件指令、多步流程等模式;示例覆盖 issue 分类、PR 代码审查、文档同步、依赖更新审查、定时仓库健康检查;高级配置含并发控制、条件执行、超时与环境变量。

使用方式:安装编译器 npm install -g @github/agentic-workflows-compiler,用 aw-compile .github/workflows/issue-triage.md 编译,aw-validate 与 aw-lint 校验;也可在 GitHub Actions 中自动编译并提交 .lock.yml。

适用场景:issue 分类与打标、PR 审查、文档维护、依赖安全分析、定时仓库健康报告等。

限制:需遵循最小权限与工具最小化,注意速率限制、失败处理与单职责原则;具体引擎与平台支持范围资料未完整说明。