agentleFS
gaoyu06gaoyu06/harness/skills/ship/SKILL.md

ship

Skill3 starsChanged 5 days agoMITView on GitHub

交付收尾:用户说提交、推送、开 PR、合并、部署、发版、收尾时调用,按口令执行对应步骤,部署后在真实环境核对,盘点遗留后再报完成。用于:「提交推送」、"commit push"、开 PR、合并、部署、发版、收尾、能发布了吗。线上报错排查转 ops-triage。

194 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use ios-sync, open-gstack-browser and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Saqlain-811Skill

    ios-sync

    Regenerate the iOS debug bridge against the latest upstream gstack templates. (gstack)

    Also in 6 projects that use this

  • seek888Skill

    open-gstack-browser

    Launch GStack Browser — AI-controlled Chromium with the sidebar extension baked in. Opens a visible browser window where you can watch every action in real time. The sidebar shows a live activity feed and chat. Anti-bot stealth built in. Use when asked to "open gstack browser", "launch browser", "connect chrome", "open chrome", "real browser", "launch chrome", "side panel", or "control my browser". Voice triggers (speech-to-text aliases): "show me the browser".

    Also in 10 projects that use this

  • ayudaySkill

    setup-deploy

    Configure deployment settings for /land-and-deploy. Detects your deploy platform (Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions, custom), production URL, health check endpoints, and deploy status commands. Writes the configuration to CLAUDE.md so all future deploys are automatic. Use when: "setup deploy", "configure deployment", "set up land-and-deploy", "how do I deploy with gstack", "add deploy config".

    Also in 19 projects that use this

  • ShreyRaviSkill

    landing-report

    Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

    Also in 9 projects that use this

  • zebbernSkill

    debug-fix

    Find and fix a bug or issue — from any source (GitHub issue, error message, user report, or observed behavior)

    Also in 4 projects that use this

  • ramybarsoumSkill

    document-release

    Post-ship documentation update. Reads all project docs, cross-references the diff, updates README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md to match what shipped, polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION. Use when asked to "update the docs", "sync documentation", or "post-ship docs". Proactively suggest after a PR is merged or code is shipped.

    Also in 23 projects that use this

The file

Files
SKILL.md

Ship

上下游

  • 前接:实现完成的改动;用户批准过审查时,review 已收敛。
  • 读取:全局规则的 Git 一节,推送和部署前的核对以它为准。
  • 分流:部署后出现线上报错,转 ops-triage。
  • 写入:项目的部署、迁移、发版步骤 → 持久规则。

口令

用户用短口令下达交付,口令决定执行范围。

口令步骤
提交提交前检查,按功能分组提交
推送提交,再推送
开 PR推送,再建 PR
合并合并 PR,删除已合并分支,切回主分支并同步
部署部署到口令所说的环境,未指明时用项目默认环境
发版升版本号、写更新日志、打 tag、构建并发布
收尾只做盘点和清理
  • 连写的口令按顺序全部执行,例如「提交推送合并部署」。
  • 「先不 X」「X 暂不」:跳过 X,以及只为 X 服务的步骤。
  • 口令只覆盖它说到的步骤:「提交推送」不包含部署。
  • 每个口令结束时都做一遍盘点。

步骤

1. 提交

从环境里找检查命令(package.json scripts、Makefile、CI 配置),提交前跑格式化、类型检查和测试。按功能分组提交,一个提交只含一个功能的改动。

完成判据:检查全部通过,每个提交能用一句话说清改了什么。

2. 推送与 PR

按全局规则推送。PR 描述写改动、验证方式和遗留项。

3. 部署

  1. 读项目的部署说明:持久规则、README、docs/、部署脚本。都没有时问用户部署方式,部署成功后写进持久规则。
  2. 列出本次需要的迁移。SQL 先在事务或副本上试跑,核对影响行数后再正式执行。
  3. 保持服务不中断:新实例就绪后再切流量,不动正在服务的旧实例。
  4. 在本机构建、上传产物,除非项目约定在服务器上构建。

4. 部署后核对

在真实环境确认本次改动生效:

  • 运行的版本或提交号等于本次提交;
  • 改动点实际可用:请求接口、打开页面截图、走一遍改动的操作;
  • 观察日志,直到有请求经过新代码,且没有新增报错。

完成判据:每一项都有证据(命令和输出、截图)。有新增报错时先止血(回滚或关开关),再转 ops-triage。

5. 发版

  • 版本号在上一版基础上加一,不跳号。
  • 更新日志用中文,只写用户能感知的变化,多个小修复合并成一条。
  • 有前后端依赖时,先部署后端和网页,再发客户端。

盘点

每次报完成前逐项检查:

  • git status、未推送的提交、本次开的未合并 PR;
  • 本次产生的分支、worktree、临时文件、[DEBUG-...] 日志;
  • 改动里的 mock、TODO、占位数据、被删掉入口的功能;
  • 用户在本会话提过、但还没做的要求:回看用户的消息逐条对照。

完成判据:每一项要么已清理,要么列进汇报并写明原因。

汇报

先给结果:提交号、PR 链接、部署环境和核对证据。再列盘点剩下的项。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.