SuperAPI AI 工具集

gh-aw-safe-outputs

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

用途:该技能讲解 GitHub Agentic Workflows 中的 Safe Outputs 模式,即 AI 智能体执行写操作(创建/更新文件、issue、PR)的唯一受控通道。核心原则是写隔离、显式声明、自动净化、可审计,AI 不能直接写入。

主要能力:提供六类安全输出。safeoutputs___issue 创建或更新 issue;safeoutputs___pull_request 创建 PR,可配置 base_branch、auto_merge;safeoutputs___comment 为 issue/PR 添加评论;safeoutputs___file 创建或更新文件,可配置 allowed_paths 与 max_file_size;safeoutputs___label 增删标签;safeoutputs___noop 仅输出信息不执行动作。

使用方式:在工作流 tools 段声明所需工具,例如 tools: safeoutputs___issue、safeoutputs___file 并设置 allowed_paths: ["docs/**"]。AI 以 JSON 形式输出工具名与参数,经模式校验、HTML/URL 净化、密钥扫描、路径校验、大小限制后执行并记录审计日志。

适用场景:issue 分类、文档更新、代码审查、受控自动化 PR 等。

限制:所有输出均经净化,路径受 allowed_paths 约束,禁止目录穿越与二进制文件,单文件默认上限 1MB,受保护标签被阻止;建议最小权限、先用 noop 测试、关键操作保留人工审批。具体实现细节以官方文档为准。