SuperAPI AI 工具集

ship

测试与质量

查看项目

更新于 10-16 03:15

技能介绍

用途:/ship 将已完成的代码工作经由 Pull Request 收尾,涵盖测试、提交、创建 PR。一条命令从“代码完成”到“PR 打开”。

主要能力与流程:

  • 步骤0 读取配置:从 CLAUDE.md 或 AGENTS.md 读取测试命令、tag 格式、发布偏好。
  • 步骤1 预检:运行 git pull 同步远端,运行项目测试/构建命令,失败则停止并报告;查看 git diff --stat、git log origin/{main}..HEAD --oneline 及当前分支。
  • 步骤2 加载经验:在 {learnings_dir} 搜索与改动文件相关的 pitfall 类型记录,命中则列出并要求确认。
  • 步骤3 范围检查:若有 brief,对比 Scope 与当前 diff,标记范围外改动与复查后新增文件,输出 Scope: ON TRACK 或 SCOPE DRIFT 等。
  • 步骤4 复查门:若当前 diff 未运行 /review,提示先运行。
  • 步骤5 分支:禁止直接推送 main/master,必须经 PR;在 main/master 时创建 fix/、feat/ 或 refactor/* 分支,分支门通过前不得提交。
  • 步骤6 提交:分析 diff,生成约定式提交信息,只暂存相关文件(不用 git add -A),暂存区为空则停止。
  • 步骤7 打标签(如配置)。
  • 步骤8 推送并创建 PR:使用 -u 推送分支及标签,用 gh pr create 创建 PR,返回 PR URL。
  • 步骤9 发布(如配置 release: true)。
  • 步骤10 提取经验候选(仅在出现具体工件时),仅建议不持久化。

限制:知识笔记生命周期与外部发布属宿主关注点;经验候选不持久化,存储归宿主/项目;缺陷修复仅建议,不在此处编辑目标技能;交付证据缺失时应说明缺口而非声称完成。具体命令与配置细节以源文档为准。