--- name: git-analyze description: "分析目标(只读);/git-analyze TARGET [--remote] [--help]." license: Apache-2.0 disable-model-invocation: true user-invocable: false metadata: short-description: "分析目标;$git-analyze TARGET [--remote] [--help]." --- # GitAnalyze Command adapter for the canonical `/GitAnalyze` command of the MAGOS (Multi-Agent Git Orchestrator) package. Use it when the user explicitly invokes `/git-analyze` in Hermes or `$git-analyze` in Codex. ## Usage - Hermes: `/git-analyze [--remote] [--lang ] [--help]` - Codex: `$git-analyze [--remote] [--lang ] [--help]` - ``: Required branch name or worktree path to analyze. - `--remote`: Refresh remote-tracking refs before analysis; it does not change branches, worktrees, or commit history. - `--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 the repository. - Default: Read-only analysis using existing local refs; no remote refresh. Examples: `/git-analyze feature/auth`, `$git-analyze feature/auth --remote`, `$git-analyze --lang English`, `$git-analyze --help`. ## Arguments - Codex: the arguments are the text that follows `$git-analyze` in the user's message. - Plugin installs prefix the name with the plugin name: `/magos:git-analyze` in Hermes, `$magos:git-analyze` in Codex; Claude Code hides this adapter and offers the command `/magos:GitAnalyze` 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 target is missing, ask for it and show this help; for an unknown option, explain the error and show this help. Do not inspect the repository in either error case. Read the shared files below only for a normal invocation. ## 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` section **2. GitAnalyze**: command contract and output format. 3. `../../references/reconnaissance.md`: repository inspection steps. 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 `references/commands.md` and `references/reconnaissance.md` files. - 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 a shared file cannot be read, name the missing path, report that the MAGOS installation is incomplete, and continue read-only with the safety defaults below. ## Execution Execute the canonical `/GitAnalyze` command with the supplied arguments. Inspect the target's current state, ancestry, unique commits, dependencies, and worktree cleanliness before assessing operations. Keep the analysis read-only; `--remote` only permits refreshing remote-tracking refs. Ask for a target 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.