用途:在代码“完成”后,用一次流程完成预检、创建 PR、CI、部署与验证,把改动推进到“生产已验证”。触发方式为 /ship。
主要能力:执行 ship/bin/pre-ship-check.sh 与 ship/bin/quality-check.sh,检查未提交改动、缺失测试、暂存密钥、分支状态、README 链接等;解析 review/security/qa 上游产物并确认阻塞项已解决;创建 PR 前强制展示标题、分支、改动文件、摘要与测试计划并等待确认;用 gh pr create 建 PR,gh pr checks <number> --watch 监控 CI;合并后校验合并状态、部署流水线,并对 staging/生产执行冒烟测试、错误与副作用检查、指标观察;出问题先回滚再调试,可用 git revert <merge-commit-sha> --mainline 1 快速回滚。支持本地模式(无 git 时跳过 PR/CI/部署,改为本地验证并给出运行命令)和本地 git 模式(跳过 PR,建议打 tag)。
用法要点:先读取会话状态中的 profile、run_mode、autopilot、plan_approval。当 run_mode == report_only 时只输出“Shipping report”,禁止 commit、push、gh pr create/merge、部署与回滚等任何写操作,并列出缺失的 review/security/qa 与下一步可执行命令。PR 标题需 70 字符内、以动词开头;body 含摘要与测试计划。
限制:运行前需有可用 git 环境;report_only 下不能落盘到 .nanostack/ 之外;遥测可通过 NANOSTACK_NO_TELEMETRY=1 或 ~/.nanostack/.telemetry-disabled 关闭。具体依赖命令与仓库级规范以项目实际文件为准。