日常工作知识库

Appearance

igit-mr-skills 与 /igit-mr-review 安装使用手册 ​

归类：开发工具 / AI 技能分发 / CLI 入口 发生时间：2026-03-30 状态：✅ 两种安装方式已重新验证通过

一、当前结论 ​

截至 2026-03-30，/igit-mr-review 的推荐形态已经不是“IDE 里预先注册 MCP 后再直接调用工具”的旧入口，而是：

text
/igit-mr-review

对应的最新说明重点是：

  • 它是高频快捷入口
  • 默认走 igit-mr-bootstrap 的 Plan B 本地 CLI
  • 不要求 IDE 预先注册 MCP
  • 底层仍复用现有 iGit / GitLab 工具能力
  • /igit-mr-review-mcp 仍保留，用于并行调试和对照问题

同时，当前已经重新验证下面两种安装方式都能拿到最新版 /igit-mr-review：

  • mds skills igit-mr-review
  • 团队提供的在线 shell 安装脚本

如果你只是普通使用者，记住这一条就够了：

text
优先装 /igit-mr-review，用 MR 链接直接触发审查。

二、推荐安装方式 ​

1. 直接使用 mds skills ​

安装单个 skill：

bash
mds skills igit-mr-review

只装到指定工具：

bash
mds skills igit-mr-review --tool codex,cursor

如果需要覆盖本地已有副本：

bash
mds skills igit-mr-review --force

适合下面这些场景：

  • 已经装了 mds
  • 只想安装或覆盖某一个 skill
  • 更偏好“通过 registry 拉最新内容”的分发方式

2. 使用团队提供的在线 shell 安装脚本 ​

安装最新 /igit-mr-review：

bash
curl -sSL <team-install-script-url> | bash -s -- --skill-name igit-mr-review

只验证动作、不真正安装：

bash
curl -sSL <team-install-script-url> | bash -s -- --skill-name igit-mr-review --dry-run

补充说明：

  • 这条方式通常会自动探测常见的 skills 目录
  • 也可能顺带做 best-effort MCP 客户端配置补齐
  • 如果你只想先观察行为，优先加 --dry-run

适合下面这些场景：

  • 本机还没装 mds
  • 希望一条命令完成 skill 安装
  • 需要兼容更多 IDE / AI 工具目录

三、安装后如何确认拿到的是最新 CLI 入口版 ​

安装完成后，打开本地 igit-mr-review skill，确认里面至少出现下面这些关键词：

text
/igit-mr-review
igit-mr-bootstrap
Plan B 本地 CLI
不依赖 IDE 预先注册 MCP

如果你看到的仍然是这类旧描述：

text
基于 igit-mr-mcp 生成标准化代码审查报告

那说明你拿到的还不是最新 CLI 入口版，需要重新安装或检查远端缓存。

四、安装完成后怎么用 ​

安装完成后，推荐直接从高频入口开始：

text
/igit-mr-review https://<your-igit-host>/<group>/<project>/-/merge_requests/<iid>

如果没有完整链接，也可以这样输入：

text
/igit-mr-review
项目：group/project
MR：1234

如果只想分析、不想真正发评论，推荐让 Agent 走只读模式：

text
使用 /igit-mr-review 分析这个 MR，但不要提交评论。

如果你要排查新旧链路差异，可以显式切到：

text
/igit-mr-review-mcp

五、和 igit-mr-skills 的关系 ​

推荐的使用心智可以很简单：

  • /igit-mr-review：给一个 MR 链接，直接完成审查
  • /igit-mr-skills：查询、统计、管理类任务的总入口
  • /igit-mr-report：日期范围报表的高频入口

如果只是普通审查场景，优先 /igit-mr-review 即可，不必先理解完整能力集。

六、常见问题 ​

1. 安装成功了，但执行时还是报鉴权或找不到项目 ​

优先检查：

  • GitLab / iGit 访问令牌
  • 对应 host 配置
  • 团队要求的最小权限等级或项目搜索范围

安装 skill 只解决“让 IDE / AI 工具认识这个入口”，不等于业务侧认证一定已经补齐。

2. 为什么我已经装了 /igit-mr-review，还会看到 /igit-mr-review-mcp ​

这是故意保留的并行入口：

  • /igit-mr-review 走推荐的 CLI 路径
  • /igit-mr-review-mcp 用来做对照调试和排障

3. 为什么 shell 脚本安装后动作比 mds skills 更多 ​

这是正常现象。

mds skills 的职责更偏向“从 registry 拉 skill 并安装到目标目录”，而 shell 脚本通常还会附带：

  • 目录自动探测
  • 多工具兼容安装
  • best-effort MCP 配置补齐

如果你希望先看清楚它会做什么，优先用 --dry-run。

七、推荐对外说明文案 ​

可以直接复用下面这段用户说明：

text
现在安装最新版 /igit-mr-review 有两种方式：
1. 执行 mds skills igit-mr-review
2. 执行团队提供的在线 shell 安装脚本

这两个入口都已经过重新验证，安装后拿到的是最新 CLI 入口版 /igit-mr-review。
它默认走本地 CLI 路径，不要求 IDE 预先注册 MCP。
如果你只是想拿一个 MR 链接直接完成审查，优先使用 /igit-mr-review。
如果你要做查询、统计、管理类任务，再使用 /igit-mr-skills。

八、使用建议 ​

  1. 对“查看、分析、总结”类任务，直接让 skill 先读项目、MR、diff 和评论。
  2. 对“发评论、关 MR、发通知、提交报表”这类写操作，要明确告诉 AI 可以直接执行。
  3. 如果用户输入了“今天、昨天、最近一周”这类相对时间，输出中最好转成实际日期范围。
  4. 如果用户只知道项目名，不知道 project_id，先做项目搜索，再继续 MR 级操作。
  5. 如果用户已经有完整 MR 链接，优先直接使用 /igit-mr-review <MR_URL>。
  6. 如果用户明确是“日期范围报告并提交”，优先直接使用 /igit-mr-report。