SuperAPI AI 工具集

ship-it

编程与开发

查看项目

更新于 10-16 01:10

技能介绍

用途:ship-it 是一个智能体技能,把「创建分支、提交、推送、开 PR」串成一条自动化流程。当用户说“ship it”“create a PR”“open a PR”“push and PR”等时触发。

主要能力:可选参数会作为提交信息主题、分支名前缀和 PR 标题;特殊关键字 help/--help/-h/? 会跳过流程并读取 references/options.md,draft 或 --draft 会创建草稿 PR。流程包括:预检(git status、未跟踪文件、当前分支、默认分支、diff、gh auth status);必要时创建分支(按 feat/、fix/、refactor/、docs/、chore/、test/ 前缀命名,重名则加 -2);暂存并提交(用 conventional commit,GPG 失败可加 --no-gpg-sign);推送前检查与默认分支的分叉;推送;创建或更新 PR。

使用方式:依赖 git 与已安装并认证的 GitHub CLI(gh)。PR 正文通过 --body-file 传入,避免正文出现在命令行。若分支已有 PR,会对比提交日志,必要时用 gh pr edit 更新标题与正文。

安全模型:把已有 PR 的标题与正文视为不可信数据,用 <untrusted_pr_body> 标签包裹并只作数据使用;标题与正文从提交日志重新生成,不沿用已有 PR 内容;插值值加双引号;参数仅作标题/分支文本,不作 PR 编号。

限制:不提交疑似密钥文件(.env、凭据、密钥、令牌、构建产物);需要访问系统钥匙串与凭据助手,沙箱环境需确保权限;临时文件用 mktemp "${TMPDIR:-/private/tmp}/<prefix>-XXXXXX";本地提交信息被视为与工作区同等可信,技能不做净化;Snyk Agent Scan 的 W011 会因 gh pr view 触发。具体收费、平台支持等资料暂未提供。