SuperAPI AI 工具集

w-ship

编程与开发

查看项目

更新于 10-15 15:20

技能介绍

用途

w-ship 用于执行一条完整的“实现到 PR”路径:实现所请求的改动、验证、提交、推送,并创建对应的 PR。它明确不是单独的提交操作(/w-commit),也不负责合并或部署。

主要能力

  • 读取任务或计划、仓库说明、分支状态、受影响的文档以及脚本。
  • 遵循 git publish 流程;除非该 Git 步骤被阻塞,否则不打开子 SKILL.md。
  • 遵循 git-publish 分支规则:工作区脏时停止(不使用 stash)。每个新分支都先执行 git fetch origin,再执行 git switch -c <name> --no-track origin/main;绝不跳过 fetch,绝不基于过期的本地 main。
  • 以完整的切片方式实现改动。文档处理方式与 /w-build 一致:当行为、命令或约定发生变化时,同步更新匹配的 MDX 和最近的 README,否则用一行说明为何不更新。
  • 运行仓库完整的推送前门禁(在 Basilic 中为 pnpm qa,或使用方仓库中记录的等价命令)。这是唯一要求该门禁的 playbook。发布前先诊断失败原因。
  • 提交属于任务范围内的改动,然后推送已检查的上游。
  • 创建或更新 PR,并返回提交、分支、PR 链接与检查结果。

使用方式

调用该技能即请求完整的“实现到 PR”路径。它会按上述流程读取上下文、创建分支、实现、更新文档、运行门禁、提交、推送并创建或更新 PR。

适用场景

适用于需要把一项改动从实现推进到可审查 PR 的完整流程,包括分支创建、文档同步、推送前验证与 PR 创建或更新。

限制

  • 不负责合并或部署。
  • 不等同于仅提交的 /w-commit。
  • 工作区脏时停止,不使用 stash。
  • 若门禁失败,应报告阻塞项与已完成的本地工作,不得把未发布的改动当作已交付。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。