SuperAPI AI 工具集

gh-aw

智能体与模型

查看项目

更新于 10-16 04:35

技能介绍

用途:为 Prowler 仓库创建和维护 GitHub Agentic Workflows(gh-aw),覆盖新建 .github/workflows/.md 工作流、修改 frontmatter(触发器、权限、safe-outputs、工具、MCP 服务器)、创建或导入 .github/agents/.md Copilot 自定义智能体、调试 gh aw compile 错误与警告,以及配置网络访问、速率限制和页脚模板。

主要能力与结构:采用两文件架构,工作流文件只放配置与上下文,智能体文件放推理逻辑,通过 imports: 引入,路径相对导入文件解析(如 ../agents/my-agent.md)。智能体不得硬编码代码库布局、路径、技能名或版本,应指示其在运行时读取 AGENTS.md;单体仓库可用路由表指明按上下文读取哪个 AGENTS.md。

安全模式:工作流默认只读权限,写入通过 safe-outputs 完成;上下文须用 ${{ needs.activation.outputs.text }} 而非原始 issue/PR 正文;网络在 network.allowed 显式列出域名;MCP 服务器用 allowed 限制工具;可配置并发、速率限制、威胁检测(嵌套在 safe-outputs 下)与公开仓库的 lockdown 模式。strict: true 为默认,禁止自定义域名,使用自定义 MCP 域名时须设 strict: false。

常用命令:gh aw compile;gh aw compile --actionlint --zizmor --poutine;gh aw compile --strict;gh aw status;gh aw add owner/repo/workflow.md;gh aw run workflow-name;gh aw logs workflow-name;gh aw audit <run-id>。修改工作流后需重新编译并提交 .lock.yml 与 actions-lock.json。

限制:.lock.yml 为自动生成,禁止手动编辑;自动生成文件中的扫描告警可忽略,只需处理自身配置中的问题。具体收费、平台支持范围等资料暂未提供。