用途
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。
- 若门禁失败,应报告阻塞项与已完成的本地工作,不得把未发布的改动当作已交付。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。