agentleFS
zhu-xiaoweizhu-xiaowei/Baton/.agents/skills/testflight/SKILL.md

testflight

Skill14 starsChanged 11 days agoMITView on GitHub

Automatically publish a Baton iOS TestFlight build, create or reuse a PR from release/testflight, merge after required checks pass, and delete the branch after merge. Use the macOS release script or Xcode Cloud on Linux. Check readiness without publishing when the user only asks a question.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. everpcpc/KMReader★ 118same name
    2. Sassy-Dog/skills★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 3 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Very specific:

    Follow .claude/commands/testflight.md.

    line 8
  2. Distinctive:

    Do not create a new branch for each build number or force-push this branch.

    line 25
  3. Very specific:

    Run node scripts/release-ios-cloud.mjs --dry-run as a preflight, then run npm run release:ios:cloud on that same branch in the same …

    line 27
  4. Very specific:

    If a protected-branch push fails after the script creates its bump commit, preserve that commit.

    line 34
  5. Distinctive:

    If creating an Xcode Cloud run returns an unexplained HTTP 500, first remind the user to check for an updated Apple Developer Program …

    line 47
  6. Very specific:

    Wait until the TestFlight upload finishes, App Store Connect marks the build VALID, and the internal Test group is IN_BETA_TESTING.

    line 52
  7. Distinctive:

    Wait for its required CI checks and repository review requirements, resolve relevant failures within the release scope, and merge …

    line 57
  8. Very specific:

    After confirming the PR is merged, delete release/testflight remotely and locally.

    line 65

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Baton TestFlight

Follow .claude/commands/testflight.md. A request to publish authorizes the release's source commits, branch creation, pushes, build-number bump, cloud run, TestFlight group assignment, the PR and merge after a successful release, and deletion of the release branch after the merge is confirmed. Perform these steps without asking for additional approval. Before publishing, inspect git status --short, including untracked files. Commit changes within the requested release scope automatically; preserve unrelated work, using an isolated checkout when needed.

On macOS, run npm run release:ios.

On Linux, publish from the fixed, unprotected release/testflight branch, not main:

  • Reuse release/testflight for every release. Fetch and merge the latest origin/main into it while preserving its release commits. If it does not exist, create it from the prepared release commit or latest origin/main. Do not create a new branch for each build number or force-push this branch.
  • Push the release source commit to Xcode Cloud's connected GitHub repository. Run node scripts/release-ios-cloud.mjs --dry-run as a preflight, then run npm run release:ios:cloud on that same branch in the same invocation. The cloud script commits and pushes its build-number bump before starting Xcode Cloud; a protected branch would reject that push.
  • Finish and verify the release before the automatic PR workflow below. Preserve branch protection.

If a protected-branch push fails after the script creates its bump commit, preserve that commit. Move it onto release/testflight automatically and push the branch. Rerun the dry-run and release on that branch; let the script decide whether the prepared build number is reusable instead of manually bumping again. No cloud run starts when that push fails.

For readiness questions, only inspect state and use the dry-run on Linux. Report the final build number, cloud run ID, and upload status; include a PR URL only if one exists. The cloud script adds valid builds to the internal Test group; confirm that state before saying testers can install the build. If group assignment fails after upload, report the existing build instead of starting another release.

If creating an Xcode Cloud run returns an unexplained HTTP 500, first remind the user to check for an updated Apple Developer Program License Agreement awaiting acceptance. Follow the agreement check in .claude/commands/testflight.md before further start attempts.

Wait until the TestFlight upload finishes, App Store Connect marks the build VALID, and the internal Test group is IN_BETA_TESTING. Only then automatically create or reuse a PR from the existing release/testflight branch to main, including the build-number bump and release changes. Do not create a temporary PR branch or ask for separate approval. Wait for its required CI checks and repository review requirements, resolve relevant failures within the release scope, and merge automatically when allowed. Use the repository's supported merge method and never bypass branch protection. Continue monitoring until the PR is actually merged and branch cleanup below is complete; starting an upload, opening a PR, or enabling auto-merge is not completion. Report the build number, upload and group status, PR URL, and merge result. Do not merge a PR whose release failed.

After confirming the PR is merged, delete release/testflight remotely and locally. If GitHub already deleted the remote branch, verify that it is gone. Switch the working tree to main before deleting the local branch. Do not restore the branch after merge; the next release recreates the same fixed branch name from the latest origin/main. Keep the branch if publication or merge fails so the release can be resumed.

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.