Worktree recycle (platform skill — single source)

Who runs: the coding agent, not the human.
Never tell the user to copy-paste worktree-task recycle as the primary path — load this skill and run the co-located runner.

Hard git ops stay in worktree-task recycle (dirty check, optional delivered gate, allowlisted clean, branch align to slug, reset --hard origin/HEAD, sync origin/<branch>).
This skill owns soft preflight and readiness hints. Project bootstrap is not part of recycle — the next task initializes what it needs.

When to load / run

Skip / redirect:

• Short-lived task-* / hotfix-* end-of-life → worktree-task reclaim / Ctrl+k g r (not this skill)
• Pure git reset without this skill → do not bypass; still use the runner

wezdeck policy: worktrees = isolation; delivery = direct mainline (no PR).
Invariant: idle dev/* tip must equal origin/HEAD. After landing on mainline (or when mainline moved while the workstation sat idle), immediately recycle — do not leave dev/* behind. See docs/workspaces.md → Maintenance loop.

Resolve TOOL_HOME (first hit wins)

1. $WORKTREE_RECYCLE_HOME
2. directory of this SKILL.md if run.sh is co-located
3. $HOME/.agents/skills/worktree-recycle
4. $WEZDECK_ROOT/skills/worktree-recycle
5. $HOME/github/wezterm-config/skills/worktree-recycle

TOOL_HOME=…   # dir that contains run.sh
R="$TOOL_HOME/run.sh"

Install / refresh discovery (idempotent, from wezdeck):

./scripts/dev/link-platform-skills.sh

Who runs what

Agent procedure

1. Resolve TOOL_HOME; confirm "$R" is executable. Cwd may be a linked dev-* worktree or the primary checkout (or pass --cwd).
2. Preflight (optional glance; recycle also runs it):

   "$R" preflight --cwd "$PWD"

   Soft signals only. task-* / hotfix-* are real blockers (use reclaim). Dirty trees need --force or a clean tree.
3. If the user already named the next task, keep it for --task.
4. When the user already said 重置 / recycle: do not re-ask about squash / push / init. Proceed:

   "$R" recycle --cwd "$PWD" -y [--task "…"] [--fresh-agent] [--dry-run]

   Prefer -y when the user explicitly asked to reset. Do not invent a “先 push / 手动 reset / 先 bootstrap” fork.
5. Do not run init unless the user asked or you pass --with-init. Leave deps/codegen/services to the follow-up task.
6. Report briefly: new HEAD, branch (after slug align), remote sync result, next step (including /clear when --fresh-agent).

Preflight covers (skill layer)

Desired end state

After a successful recycle:

• Local tip == origin/HEAD (default branch tip)
• Branch name matches the worktree slug mapping (dev-agent → dev/agent); primary uses the default branch (master / main)
• origin/<same branch> tip == that same commit (unless --no-sync-remote)
• Upstream is origin/<branch> (linked never tracks the default branch)
• Project bootstrap not required by recycle itself

Fast path defaults

Don't

• Don't ask the human to run CLI as the main path
• Don't re-ask squash / push / manual-reset questions after the user already said 重置开发分支
• Don't use recycle for short-lived task-* / hotfix-* (use reclaim)
• Don't --force away dirty trees without an explicit user override
• Don't treat attention / ledger / delegate shipped as proof of merge
• Don't run sync-runtime or package installs just because recycle finished
• Don't auto-bootstrap the project inside the skill runner
• Don't delete Claude transcripts; use --fresh-agent + /clear when a blank session is wanted
• Don't maintain a second SKILL.md body outside this directory (link only)

Related

• Runner: run.sh, lib/preflight.sh, lib/init.sh (opt-in)
• Hard ops: scripts/runtime/worktree/worktree-task recycle
• Docs: docs/workspaces.md (Recycle), docs/daily-workflow.md (closing a round)
• Link: scripts/dev/link-platform-skills.sh
• Offline: "$TOOL_HOME/test.sh"