日常工作知识库

Appearance

igit-mr-skills CDN 发布后验收清单 ​

归类：开发工具 / AI 技能分发 / 验收清单 发生时间：2026-03-27 状态：✅ 可直接复用

一、适用场景 ​

当 igit-mr-skills 完成下面任一发布动作后，建议执行这份验收清单：

  • 私有 npm 上发布了新的 installer 版本
  • CDN 上更新了远程一键安装脚本
  • 新增了高频快捷入口，比如 /igit-mr-review、/igit-mr-report

二、验收目标 ​

本次验收至少要确认四件事：

  1. 远程安装脚本已经指向最新 installer 版本
  2. 一键安装后会同时安装 3 个 skill
  3. IDE 中能够发现这 3 个入口
  4. 高频快捷入口的输入方式符合预期

三、推荐验收顺序 ​

1. 先做 dry-run ​

先不要直接落盘，先看脚本“准备做什么”：

bash
curl -sSL <your-private-cdn>/igit-mr-skills-install.sh | bash -s -- --dry-run --verbose

重点检查输出里是否同时出现：

  • igit-mr-skills
  • igit-mr-review
  • igit-mr-report

如果输出里仍然只有 igit-mr-skills，说明：

  • 要么 CDN 脚本还是旧版本
  • 要么 installer 包还是旧版本

2. 检查 installer 版本 ​

如果团队维护了私有 npm，也建议确认当前版本号已经更新：

bash
npm view @epfe/igit-mr-skills-installer version --registry <your-private-registry>

预期结果：

  • 返回最新发布版本
  • 该版本对应的 bundle 内已包含 3 个 skill

3. 执行真实安装 ​

bash
curl -sSL <your-private-cdn>/igit-mr-skills-install.sh | bash

预期结果：

  • 安装日志中明确出现 3 个 skill 名称
  • 安装完成后提示用户重启会话

4. 检查目标目录落盘结果 ​

至少随机抽查一个目标工具目录，例如：

  • ~/.codex/skills/
  • ~/.cursor/skills/
  • ~/.openclaw/skills/

预期至少能看到：

text
igit-mr-skills/
igit-mr-review/
igit-mr-report/

每个目录里都应包含：

text
SKILL.md

5. 检查 slash 发现结果 ​

重启或新开一个支持 skills 的 IDE / AI 工具会话后，检查是否能看到：

  • /igit-mr-skills
  • /igit-mr-review
  • /igit-mr-report

如果安装目录已经落盘，但 slash 搜不到，优先排查：

  1. 工具是否需要重启会话
  2. 工具是否只在启动时扫描 skills 目录
  3. 该工具当前是否真的支持自定义 skills 发现

四、功能级验收 ​

场景一：主 skill 总入口 ​

输入示例：

text
/igit-mr-skills
搜索项目 ep-fe，然后列出 open 状态 MR。

预期结果：

  • 能走项目搜索
  • 能继续列 MR
  • 不要求用户记底层工具名

场景二：MR 审查快捷入口 ​

输入示例：

text
/igit-mr-review https://igit.example.com/group/project/-/merge_requests/123

预期结果：

  1. 能从链接中解析项目路径和 MR IID
  2. 能继续读取 MR 详情、diff、评论
  3. 能进入标准化 review 流程
  4. 默认目标是生成 review 并追加评论

场景三：日期范围报告快捷入口 ​

输入示例：

text
/igit-mr-report
开始日期：2026-03-01
结束日期：2026-03-27

预期结果：

  1. 能识别日期范围
  2. 能进入 review report 生成流程
  3. 默认目标是提交到 Git 仓库中的报告目录

五、常见失败信号 ​

下面这些现象通常说明还没完全发布到位：

1. dry-run 只显示一个 skill ​

说明：

  • CDN 脚本或 installer 包有一个还是旧版本

2. 安装日志正确，但 IDE 里搜不到快捷入口 ​

说明：

  • 目标 IDE 可能尚未刷新 skill 列表
  • 或当前工具只识别主 skill，不识别新增别名入口

3. /igit-mr-review 存在，但无法直接处理 MR 链接 ​

说明：

  • alias skill 的 prompt 还不够清晰
  • 或该 IDE 对 slash 输入参数的传递方式和预期不一致

4. skill 可见，但调用时报鉴权或找不到项目 ​

说明：

  • 不是安装问题，而是 igit-mr-mcp 的配置问题
  • 应优先检查：
    • MR_MCP_GITLAB_TOKEN
    • MR_MCP_GITLAB_HOST
    • MCP server 是否已接入

六、推荐验收结论模板 ​

验收通过时，可使用类似结论：

text
CDN 发布验收通过：
1. 一键安装脚本已指向最新 installer 版本
2. 安装后可同时落盘 igit-mr-skills、igit-mr-review、igit-mr-report
3. 目标 IDE 中可发现 3 个快捷入口
4. /igit-mr-review 与 /igit-mr-report 的高频场景输入已符合预期

如果部分通过，可用类似结论：

text
私有 npm 包已更新成功，但 CDN 线上脚本仍是旧版本。
当前 curl | bash 可以拉到最新 installer 版本号，但实际安装行为仍未包含全部快捷入口。
需要先完成 CDN 脚本发布，再重新执行一轮 dry-run 与真实安装验收。