ship-wt
Spawn a fresh fir agent in a new worktree that ships itself — does the work, then runs ship-it (review-and-fix loop, ff-merge, release, worktree cleanup) when done. Use when you want a worktree task to finish and merge on its own.
- License 许可
- MIT
- 所属仓库
- kfet/fir
- 最近更新
- 2026-11-12
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- ship-wt
- builtin
- true
- override
- true
- description
- Spawn a fresh fir agent in a new worktree that ships itself — does the work, then runs ship-it (review-and-fix loop, ff-merge, release, worktree cleanup) when done. Use when you want a worktree task to finish and merge on its own.
03 SKILL.md 正文
ship-wt — spawn a self-shipping worktree agent
wt plus ship-it. The spawned agent owns the task end-to-end: implement, then
invoke ship-it once implementation is complete and make all passes. Plain
wt is untouched — this is the explicit, opt-in shipping variant.
The work happens over there. Don't draft designs or touch code here.
Recipe
-
Pick a short kebab-case feature name from the whole task.
-
Build the task text. Start from the user's full task, ensure it carries a
Mode: do.tag, prepend "Before exploring, run therecallskill for this repo.", and append the ship-it instruction verbatim:"When implementation is complete and
make allpasses, invoke theship-itskill to finish: it loops review-and-fix until clean, ff-merges to main, cuts and publishes a release, and removes the worktree. Do not ask permission. Never skip the review-and-fix loop, even if the task is urgent." -
Spawn via
wt's script (reused —ship-wtadds no spawn logic of its own):bash "$(dirname "$SKILL_DIR")/wt/scripts/spawn.sh" <feature-name> "<task text including mode tag and the ship-it instruction>" -
Tell the user the worktree path, branch, and window name (the script prints them). Then stop.
04 同仓库更多 Skills
wt
Spawn a fresh fir agent in its own tmux session on its own git worktree. Use whenever the user wants the work — or the conversation about the work — to happen over there, not here. If the user points at this skill, or has directly loaded it in the context, that alone is the cue — spawn, don't inline.
wrap-up
Wrap up work on a project branch — review, fix, and simplify in a loop until clean, then ff-merge to main.
tmux-observer
Attach a tmux window to an already-running fir session — observe its transcript and drive its input via tmux send-keys. Use when you need to watch or steer another fir agent.
tmux-driver
Drive interactive CLIs (python, gdb, etc.) via named tmux sessions with multi-window support. Falls back to fir's built-in PTY driver when tmux is unavailable.
telegram-bot-setup
Set up a new Telegram bot channel for a fir project — install the telegram MCP, create a per-project state dir, drop in the bot token, wire .fir/mcp.json with TELEGRAM_STATE_DIR, pair the user, and verify. Use when the user asks to add, configure, or onboard a Telegram bot for a fir worktree/project.
sync
Sync with an upstream source repo — detect changed files, apply equivalent downstream edits, update the baseline, and report any new features or non-trivial changes picked up.