--- name: git-sweep description: "收敛并清除已合并远端分支(仅显式调用,写操作);/git-sweep BRANCH [--apply] [--push] [--help]." license: Apache-2.0 disable-model-invocation: true user-invocable: false metadata: short-description: "收敛并清远端分支;$git-sweep BRANCH [--apply] [--push] [--help]." --- # GitSweep Command adapter for the canonical `/GitSweep` command of the MAGOS (Multi-Agent Git Orchestrator) package. It is `/GitConverge` followed by a guarded sweep of merged remote branches. Use it only when the user explicitly invokes `/git-sweep` in Hermes or `$git-sweep` in Codex. ## Usage - Hermes: `/git-sweep [--apply] [--discard-ignored] [--push] [--remote ] [--lang ] [--help]` - Codex: `$git-sweep [--apply] [--discard-ignored] [--push] [--remote ] [--lang ] [--help]` - ``: Required local branch that receives everything. Matched exactly (case-sensitive); it must not be `main`. - `--apply`: Run `/GitConverge --apply` first (merge every local branch's unique commits into ``, delete the merged local branches and their clean worktrees), then delete the remote branches that are already merged into a branch the remote keeps. A conflict or failed check stops the command before any deletion. It never moves or deletes `main`, and it pushes commits only with `--push`. Each remote deletion closes the open pull requests that use the branch as their head, and on some hosts closes or retargets those that use it as their base; the preview cannot see them. - `--discard-ignored`: Passed through to the converge phase: also allow removing worktrees that hold ignored files (for example `.env`). Without it those worktrees and their branches are kept. - `--push`: With `--apply`, after the converge phase and before the remote deletions, publish `` with one fast-forward push, exactly `git push --recurse-submodules=no --no-follow-tags refs/heads/:refs/heads/` (never forced, never `--no-verify`), so remote branches merged only into the local `` are deleted in the same run instead of needing a manual push and a second run. The push is refused when the remote's `` is not an ancestor of the local one, when `` is `main` or the remote default, when the converge phase stopped or its validation failed, or when the remote sweep is `UNKNOWN`. When the remote's `` already equals the local one nothing is pushed (`PUBLISH_NOT_NEEDED`); otherwise the push runs even when no remote branch depends on it. The preview counts the existing commits it would publish; the apply adds at most one merge commit per branch it merges, and its report gives the exact range and count. Without `--apply` the preview only predicts the push, and it gives that prediction whether or not `--push` was typed. A published branch cannot be undone by this command. - `--remote `: The remote whose merged branches are swept (`origin` when absent). It must be listed by `git remote`; otherwise the command stops before anything is changed and names the remedy. - `--lang `: Language of the reply, as a name or code (for example `English`, `ja`); Chinese when absent. Command names, options, branch names, paths, SHAs, and status codes stay untranslated. - `--help`: Show this inline usage and argument description, then stop without inspecting or changing the repository. - Default: Preview the converge plan and the remote branches that would be deleted, then a readiness verdict (`ONE_SHOT`, `PARTIAL` or `BLOCKED`) with the recommended command and the remedy for everything that remains; nothing is changed and the network is not contacted. A remote branch is deleted only when its tip is already contained in the remote's own copy of `` or its default branch. A branch merged only into the local `` is `PUSH_THEN_DELETE` while the push is predicted to run, in the preview with or without `--push`: with `--push` the run publishes `` first and then deletes it, and without `--push` the run leaves it on the remote and reports "kept: `--push` not typed" (rerun with `--push`, or, once local `` holds its tip, push `` yourself and run `$git-sweep` again). It is `PENDING_PUSH` when the push is not predicted to run (for example `` is the remote default, or the remote's `` is not an ancestor of the local one) or when the run skipped the push, or the push failed or was not confirmed: clear the condition the report names, then rerun (with `--push`, except when `` is the remote default, which the command never pushes). To rerun after a remedy is to run the preview again and then the apply, because a remedy changes the repository and an apply whose plan is older than the repository stops with a new preview. A source branch, or a remote branch that is not `NOT_TOUCHED`, whose name holds a character outside ASCII letters, ASCII digits and `.` `_` `/` `+` `-`, or starts with `-` or `+`, is never passed to a command: such a source is `UNKNOWN` (rename it) and such a remote branch is `BLOCKED_BAD_NAME` (delete or rename it on the host). A remote with several URLs, or a push URL that differs from the fetch URL, makes the remote sweep `UNKNOWN`, because a push goes to every URL. A preview that is not `BLOCKED` ends with the recommended command, which carries exactly the flags that lift something (`--discard-ignored` when ignored files are the only blocker of a worktree, with the files it deletes listed, and `--push` when a branch is `PUSH_THEN_DELETE`, whether or not you typed it, or when you typed `--push` and the publish prediction says the push will run, with the commit count printed next to the line) and carries `--remote` and `--lang` as you gave them; a typed `--push` that cannot run is dropped from the line and the report says why. The verdict judges that command, not the one you typed: a preview shows the state that command reaches, and an apply uses the flags it was given. The end state is only `main` and `` as local branches, the worktrees of the deleted branches removed, and every remote branch deleted or `NOT_TOUCHED`; a worktree the command never touches (a detached one, or one that holds `main` or another kept branch) is listed in the report. An apply report ends with the run state `COMPLETE` or `PARTIAL`. A `PARTIAL` report ends with two lines, in this order: `Next preview:`, the same line without `--apply`, to run once the remedies are done so that the preview becomes the earlier plan, and `Next command:`, the line to run after that preview (when that preview recommends another line, run the recommended one). Both are built the same way, with the flags in the order `--apply`, `--discard-ignored`, `--push`, `--remote`, `--lang` (`--remote` and `--lang` as you gave them), and both are left out when no rerun would change anything. The `Next command:` line carries `--push` when some remote branch ended `PUSH_THEN_DELETE` or `PENDING_PUSH` for a reason that a rerun with `--push` can clear, or when `--push` was typed and the publish prediction says the push would still run; it never carries `--push` when the only reason is that `` is the remote default; with phase 2 `UNKNOWN` it carries `--push` only when it was typed. Examples: `/git-sweep agent/release`, `$git-sweep agent/release --apply`, `$git-sweep agent/release --apply --push`, `$git-sweep agent/release --apply --remote upstream`, `$git-sweep --help`. ## Arguments - Codex: the arguments are the text that follows `$git-sweep` in the user's message. - Plugin installs prefix the name with the plugin name: `/magos:git-sweep` in Hermes, `$magos:git-sweep` in Codex; Claude Code hides this adapter and offers the command `/magos:GitSweep` instead. The arguments follow the name the same way. - Hermes: the arguments are the instruction Hermes appends after the skill content, introduced by "The user has provided the following instruction alongside the skill invocation:" (single command) or `User instruction:` (stacked commands). An empty instruction means no arguments. If `--help` is present, even with other arguments, answer from the inline Usage section above and stop before any tool call, file read, or repository inspection. If the branch is missing, show this help and ask for it; for an unknown option, explain the error and show this help. Do not inspect or change the repository in these error cases. Read the shared files below only for a normal invocation. ## Explicit invocation only A semantic match or automatic skill selection is not authorization to write. Claude Code keeps the model from invoking this adapter through `disable-model-invocation: true` in its frontmatter, and Codex disables implicit selection for it through `agents/openai.yaml`; Hermes has no per-skill switch, so this rule applies there by instruction. An explicit invocation is the user's `/git-sweep` command (Hermes renders it as "The user has invoked the "git-sweep" skill" followed by the arguments) or `$git-sweep` in Codex. With a plugin install, the user's `/magos:git-sweep` (Hermes) or `$magos:git-sweep` (Codex) is the same explicit invocation; Claude Code hides this adapter, and there the user's `/magos:GitSweep` command is the explicit invocation. If this adapter was selected without such an invocation, preview at most and merge, delete, and push nothing. ## Shared files This adapter belongs to the MAGOS package. The shared files are in the package root, two directories above this skill's directory: 1. `../../SKILL.md`: shared orchestration rules and safety invariants. 2. `../../references/commands.md` sections **7. GitSweep** and **6. GitConverge**: command contract, classifications, gates, and apply procedure (GitSweep reuses the GitConverge procedure unchanged). 3. `../../references/reconnaissance.md` and `../../references/decision-matrix.md`: inspection steps and cleanup criteria. Locate them as follows: - Codex: resolve the paths relative to the directory that contains this `SKILL.md`. - Hermes: take the absolute path from the `[Skill directory: ...]` line (when the skill was loaded with `skill_view` instead of a slash command, from the `skill_dir` field it returns), go up two directories, and read the files with the file or terminal tool. The skill viewer rejects paths that contain `..`. Alternatively, load the skill `multi-agent-git-orchestrator` (`magos:git-orchestrator` under a Hermes plugin install) and view its files under `references/`. - Other hosts: resolve the paths relative to this file. Do not use `commands/*.md` for this adapter. Those files are Claude Code slash-command wrappers with Claude-specific loading steps. If `../../SKILL.md` or `../../references/commands.md` cannot be read, name the missing path, report that the MAGOS installation is incomplete, and do not merge, switch, delete, or push anything; a read-only preview is still allowed. ## Execution Execute the canonical `/GitSweep` command only when the user explicitly invoked this command skill. Preview by default; merge and delete only when the explicit command includes `--apply` and every gate still passes, and record the converge plan first; after the converge phase, record every remote candidate with its SHA, classified against the actual `` tip, before the first remote write; include both in the final report. Stop on a conflict and delete nothing, locally or remotely. The only pushes allowed are the deletion of one named, fully merged remote branch at a time, guarded by `--force-with-lease` on its recorded SHA, and, only with `--push`, the one fast-forward push of ``, run only after the converge phase finished and its validation did not fail; a skipped or failed push is reported and never retried with another command. Never push other commits or tags, never force-push, never use `--no-verify`, `--mirror` or `--prune`, never run `git remote prune` or `git fetch --prune`, never use `git branch -D` or `git worktree remove --force`, never run a repository-wide `git worktree prune`. A push never reaches a repository other than the remote and never recurses into submodules; git commands run as argument lists, never as shell strings. Ask for a branch if none is provided. Reply in the language selected by `--lang` (Chinese when absent); never translate commands, options, branch names, paths, SHAs, or status codes. Remove `--lang` and its value from the arguments before parsing the rest.