mcpField
M
mcp-gitlab-usage

mcp-gitlab-usage

github.com/nextstage-brasil开发0166 次安装1 周前更新
代码仓库

关于 mcp-gitlab-usage

这是一项规定 GitLab MCP 工具调用方式的技能，涵盖需求、规划、问题执行和交付流程。它强调先行规划、确认门槛、项目发现，以及遇到严重错误时停止操作。

主要功能

  1. 01GitLab 请求前必须先规划
  2. 02GitLab 技能版本检查
  3. 03项目发现与确认门槛
  4. 04问题状态同步规则
  5. 05交付报告与错误处理

适用场景

  1. 01规划 GitLab 需求与问题
  2. 02经明确确认后创建问题
  3. 03执行期间同步问题状态

MCP 相关

提供调用 GitLab MCP 工具的流程指引，包括必需参数、调用前的架构检查和工作流门槛。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nextstage-brasil/skills --skill mcp-gitlab-usage

安装后在 Claude Code 中输入/mcp-gitlab-usage确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
flows.md
tool-catalog.md

详细介绍

MCP GitLab 使用指南

GitLab MCP 工具调用的约束规则。工具架构和详细流程见参考资料——调用工具前请先阅读。

Harness 发现

参见 ../../ns-harness/references/harness-discovery.md。对于 GitLab 产品配置（状态标签、项目 ID），如果 {product_root}/docs/context/gitlab-sync-config.md 存在，请阅读该文件。

首要操作（关键）

当用户询问 GitLab 中的需求、规划或问题时：

  1. 你的首要操作必须是调用 start_execution_planning 并使用推断出的参数。在工具返回之前，不要输出规划文本、RF 建议或问题描述。
  2. **如果 MCP 工具不可用：**请原样说明 GitLab MCP is not available in this context。不要输出无法执行的载荷。

首次访问和版本检查

连接到提供 get_mcp_gitlab_skill 的 GitLab MCP 服务时：

  1. 仅使用 check_version: true 调用。
  2. 将服务端版本与本地 MCP 技能副本（如有）进行比较。
  3. 仅在缺少副本或版本不同时，使用 for_update: true 调用。
  4. 不要同时传入 check_version 和 for_update。

必须遵守的实践

  • 始终传入 arguments——绝不要使用空的必填字段调用工具。
  • 每次进行不熟悉的调用前都要阅读工具架构。
  • 绝不要跳过规划——运行完整的 MCP 流程；不要返回“供你应用的载荷”。
  • 发现项目：git remote get-url origin → 将路径发送给 MCP → 在用户确认完整三元组（id、name、path_with_namespace）后使用数字形式的 project_id。

确认关卡（不可妥协）

无法从上下文推断：

标志仅在以下情况设为 true
requirements_confirmed用户同意验证需求
projects_confirmed用户确认所有项目三元组（主项目、后端、前端）
issues_creation_confirmed用户对“要我在 GitLab 中创建这些问题吗？”回答是

宽泛的请求（“全部处理”）不代表确认。

执行同步（状态标签）

每个问题执行三步循环——绝不要跳过中间步骤：

status_backlog → status_in_progress → status_done

从 gitlab-sync-config.md 读取标签名称，或通过 list_project_labels 发现。完整流程：references/flows.md。

**问题执行的 SOURCE_BRANCH：**由 ns-execution-gitlab-issue Gate 1 确定——发现里程碑/版本，并在必要时回退到 develop（../ns-execution-gitlab-issue/references/source-branch-resolution.md）。将工作委派给该技能时，不要临时选择基础分支。

交付报告

  1. 确认问题目标（project_id + issue_iid 或 URL）。
  2. 总结相对于约定基础分支的差异。
  3. 使用 internal: true 调用 add_issue_comment。

SDD 交付单元

当 docs/versions/{version_san}/delivery-units.md 存在且 Gate 4 发布 = yes 时：执行 references/flows.md 中的 SDD 交付单元发布 流程。每个单元对应一个问题——绝不要按 task-NNN 创建问题，也不要为整个版本创建一个问题。

相关技能

  • 实现期间的看板同步：ns-gitlab-board-sync（不要在此重复状态同步规则）。
  • 问题执行工作流：ns-execution-gitlab-issue。

参考资料

文件阅读时机
references/tool-catalog.md任何工具调用前——必需参数和示例
references/flows.md规划、创建问题、执行同步、交付报告
../ns-spec-driven/references/gates.mdSDD 规划关卡
../../ns-harness/references/artifact-layout.mdrequirements.md 和版本路径

错误处理 — STOP

遇到 Plan limit exceeded 或类似的严重 MCP 错误时：停止所有 GitLab 操作，告知人工人员，并等待指导。不要尝试绕过限制。

评论

支持 Markdown