用途:更新 GitLab 合并请求(MR)的描述。通过检查 MR 的变更内容,生成简洁的要点式摘要并写回描述。优先使用 glab MCP;MCP 不可用时使用 glab CLI。
主要能力与工作流程:
- 获取 MR 差异。MCP:使用可用工具获取当前或指定 MR 的 patch。CLI:在 MR 分支或仓库中执行 glab mr diff [MR_ID](上下文只有一个 MR 时可省略 MR_ID)。
- 过滤 docs:忽略项目根目录下 docs/ 路径中的所有改动,仅总结这些路径之外的变更。
- 生成摘要:写 3-8 条要点,描述改了什么以及为什么,而非仅列文件名。应从差异(新增函数、新增字段、重命名、修复)推断意图。示例好写法如“Add login endpoint and JWT validation”“Extend task model with priority field and migration”“Fix date formatting in report export”;差写法如逐条列出“Changed src/auth.py”。
- 展示并确认:把拟定的描述呈现给用户,等待明确确认后才写入远程。
- 更新描述(仅在确认后):MCP 使用 MR update 工具的 description(或等效)字段设置为新内容;保留或替换现有描述依用户偏好,不明确时以新的要点摘要替换。CLI 用法:glab mr update [MR_ID] --description "$(cat <<'EOF' ... EOF )",需正确转义或引号以保留换行与要点。
限制与注意事项:必须先展示拟定描述并获得用户明确确认,确认前不得调用更新工具或 CLI。docs/ 下的改动一律排除在摘要之外。上述命令与代码须保持原样。关于权限、配额、价格、适用平台或其他细节,资料未提供。