Skip to content

rockscy/shipcrew

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

shipcrew

Six AI subagents that handle the boring repo-maintenance work for you. Drop-in for Claude Code.

License: MIT Agents

English | 简体中文

curl -fsSL https://raw.githubusercontent.com/rockscy/shipcrew/main/install.sh | bash

The crew

Each agent is a single Markdown file with a focused, opinionated system prompt. Drop into ~/.claude/agents/ and Claude Code will route the right work to the right agent automatically.

Agent What it does
pr-reviewer Deep review of a single pull request — line-cited findings, no bikeshedding.
issue-triager Classifies a new issue into one of seven buckets and drafts a reply.
release-notes-writer Turns a tag range into user-facing release notes + a launch blurb.
test-failure-investigator Investigates one failing test, names a root cause, proposes a one-line fix.
dep-updater Reads dependency manifests and produces a triage table (safe / risky / breaking).
flake-hunter Scans CI history, identifies flaky tests, recommends quarantine + tracking issues.

Why?

Most "agent" repos give you a framework to build agents. shipcrew gives you the agents themselves — pre-written, scoped, opinionated.

Agent frameworks (jcode, etc.) shipcrew
You write The agent Nothing — install and use
Output style Free-form Structured (tables, line citations, fixed sections)
Boundaries Implicit Explicit "what NOT to do" in every agent
Calibration Confidence not addressed Each agent emits high/medium/low confidence
Composability Custom integration Drops into Claude Code's built-in subagent system

Each agent in the crew is single-purpose, line-cited, and uncertainty-aware. They tell you when they don't know something instead of inventing answers — that's the difference between a useful subagent and an agent that wastes your time.


Install

Option 1: One-liner (recommended)

curl -fsSL https://raw.githubusercontent.com/rockscy/shipcrew/main/install.sh | bash

Drops six .md files into ~/.claude/agents/. Existing files of the same name are skipped — never overwritten.

Option 2: Manual

git clone https://github.com/rockscy/shipcrew.git
cp shipcrew/agents/*.md ~/.claude/agents/

Verify

In Claude Code, ask: "What subagents are available?" You should see pr-reviewer, issue-triager, etc.


How to invoke

Most agents trigger automatically when you describe a matching task. You can also call them by name:

> Review PR #1247 in this repo.
[Claude routes to pr-reviewer]

> Triage this issue: <paste body>
[Claude routes to issue-triager]

> Why is test_checkout_flow_with_coupon failing in CI?
[Claude routes to test-failure-investigator]

> Draft release notes for v1.4.0 (previous tag was v1.3.2).
[Claude routes to release-notes-writer]

You can also explicitly invoke an agent: "Use the dep-updater agent to look at requirements.txt."


Design principles

  1. Single-purpose. Each agent does one thing. If you find yourself wanting to make pr-reviewer do triage, that means triage needs its own agent.
  2. Line citations. Every finding includes <file>:<line>. Vague claims are worse than no claims.
  3. Honest uncertainty. Each agent emits confidence: high / medium / low. Wrong-but-confident is the worst output.
  4. Boundaries first. Each agent explicitly states what it won't do — never approves PRs, never disables tests as a fix, never invents file paths.
  5. Output formats are concrete. Tables, code blocks, fixed sections. No "let me give you some thoughts" prose.

Composing the crew

Agents in shipcrew are designed to hand off to each other. Examples:

  • flake-hunter finds flaky tests → emits a list of candidates → user feeds a candidate to test-failure-investigator for deep dive.
  • release-notes-writer runs at release time → references PRs that were already reviewed by pr-reviewer.
  • dep-updater produces a PR list → each PR is then reviewed by pr-reviewer before merge.

The handoffs are documented in each agent's prompt — Claude knows when to escalate.


Contributing

PRs welcome. Read CONTRIBUTING.md. The bar:

  • Solves a maintainer's problem (not a developer's — that's solo-skills territory).
  • Is single-purpose and could not reasonably be split further.
  • Has explicit "what NOT to do" rules.
  • Emits a fixed output format, not vibes.
  • Includes confidence calibration and abort conditions.

License

MIT — copy, modify, ship, sell. No attribution required, but appreciated.


Related

  • solo-skills — Claude Code skills for building/shipping. shipcrew is for maintaining.

About

6 Claude Code subagents that handle repo maintenance: PR review, issue triage, release notes, test failure investigation, dep updates, flake hunting. Bilingual EN+中文.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages