--- name: git-recommend description: "给出 Git 建议(只读);/git-recommend [goal] [--remote] [--help]." license: Apache-2.0 disable-model-invocation: true user-invocable: false metadata: short-description: "Git 建议;$git-recommend [goal] [--remote] [--help]." --- # GitRecommend Command adapter for the canonical `/GitRecommend` command of the MAGOS (Multi-Agent Git Orchestrator) package. Use it when the user explicitly invokes `/git-recommend` in Hermes or `$git-recommend` in Codex. ## Usage - Hermes: `/git-recommend [goal] [--remote] [--lang ] [--help]` - Codex: `$git-recommend [goal] [--remote] [--lang ] [--help]` - `[goal]`: Optional natural-language question or desired outcome; omit it for general next-step recommendations. - `--remote`: Refresh remote-tracking refs before recommending; 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: Advisory recommendations using a fresh local reconnaissance snapshot; no remote refresh. Examples: `/git-recommend`, `$git-recommend 哪些分支应该先合并 --remote`, `$git-recommend --lang English`, `$git-recommend --help`. ## Arguments - Codex: the arguments are the text that follows `$git-recommend` in the user's message. - Plugin installs prefix the name with the plugin name: `/magos:git-recommend` in Hermes, `$magos:git-recommend` in Codex; Claude Code hides this adapter and offers the command `/magos:GitRecommend` 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. Treat `--remote` as an option only when it is a standalone argument, and keep the remaining text as the goal; for an unknown option, explain the error, show this help, and stop. 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 **3. GitRecommend**: command contract and output format. 3. `../../references/reconnaissance.md`: repository inspection steps and recommendation rules. 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 `/GitRecommend` command with the supplied arguments. Inspect the current repository first, and run or reuse a fresh reconnaissance snapshot before recommending. Recommendations are advisory and must not mutate repository topology. 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.