SuperAPI AI 工具集

soia-dev-github-ops

通用与其它

查看项目

更新于 10-16 04:53

技能介绍

用途:当用户要求查看或操作 GitHub 状态时使用本技能,覆盖 issue、pull request、checks、review、workflow run 日志、标签、release 以及 PR 生命周期动作。仅做本地 git 工作(提交、rebase、分支清理、worktree 管理)且不涉及 GitHub 操作时不适用。

主要能力:用 gh CLI 完成查询与操作,输出结构化 JSON;提供合并前规则审查流程;支持协作者权限的查询、授予与撤销;CI 失败分类排查;release 创建与验证。

使用方式:用自然语言说明目标并提供必要输入(文件、URL、repo、workspace 等)。Agent 先判断是否命中技能,再检查依赖、配置、权限与风险动作。可 dry-run 或预览的动作先给预览;涉及删除、覆盖、发送、发布、写远端状态时先征求确认。执行后需验证真实输出,并给出客户可见总结(做了什么、日志摘要、文件变化、问题与下一步)。

安装:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-github-ops -y

配置:~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-github-ops/config.yml,或通过 SOIA_DEV_GITHUB_OPS_CONFIG_FILE 指定路径。无私有配置时可不创建。密钥、cookie、session 只能放私有配置、进程环境或 provider 登录态,不得写入仓库、vault 正文或日志。

安全模型:只读查询在目标仓库已知后可执行;变更操作需当前请求中有明确意图;高影响操作(gh pr merge、gh release create、删除分支/标签、对生产 workflow dispatch、授予或撤销协作者权限等)需显式最终确认。协作者权限变更最敏感,不得仅凭历史对话推断仓库、用户名或权限级别,必须在当前对话中重述三者并获确认。操作前用 gh auth status 检查认证,缺失或过期则停止并告知用户。

仓库解析顺序:--repo 参数、当前 git remote、GITHUB_REPOSITORY 环境变量、私有配置,仍不明确则询问用户。

限制:合并前规则审查只给建议,不触发合并;即使原请求预授权合并,也须先给出分档发现清单,等用户下一条消息确认。撤销协作者只移除直接协作者权限,不关闭其 PR/分支,也不影响组织 Team 授予的访问。授予后需核实返回值,201 表示待接受邀请,204 表示立即生效。资料未提供具体收费、价格或平台支持范围。