gitlab-board-sync

GitLab 看板同步

将本地 SDD 规划／执行状态镜像到现有 GitLab issue。不会创建 issue。

前置条件

1. GitLab MCP 可用——所有工具调用均遵循 mcp-gitlab-usage
2. 如果有多个 GitLab MCP 服务：询问用户要使用哪个
3. {product_root}/docs/context/gitlab-sync-config.md 已通过验证
4. 用于规划后批量处理时：gitlab-issue-feature-map.md 必须存在

配置

阅读 references/gitlab-sync-config.template.md，了解所需字段：

• project_id、milestone_id、assignee_default
• status_backlog、status_in_progress、status_done、status_blocked
• rf_label_format、base_branch、work_branch、mr_target_branch

通过 list_project_labels 查找未知状态标签——并与用户确认。

流程 C——实现前读取

当任务列出 GitLab issue IID 时：

1. 使用 read_issue 获取描述和近期评论
2. 无法访问时不阻塞流程——记录警告并继续
3. 在此流程中不要修改 issue

流程 A——规划后批量处理

对映射中的每个 issue（排除 exclude_issues）：

1. 验证里程碑（项目 + 组织）
2. 使用 milestone_id 调用 update_issue
3. 一次调用 set_issue_labels——原子性地执行 remove_labels + add_labels（RF、Status、Equipe）
4. 调用 assign_issue
5. 根据关联任务标题中的信息，通过 set_issue_estimate 设置预估时间（秒）

流程 B——按任务同步执行状态

任务开始（编码前）

remove: status_backlog
add: status_in_progress

记录开始时间，以便调用 add_issue_spent_time。

任务完成（验证后）

仅当状态已为 status_in_progress 时：

remove: status_in_progress
add: status_done, RF: NNN
add_issue_spent_time
add_issue_comment (internal=true)

绝不一步从待办转为已完成。

反模式

错误	正确
在 update_issue 中使用 assignee	使用 assign_issue
一次状态变更调用两次标签工具	原子性地调用一次 set_issue_labels
手动添加 Milestone: 标签	在 update_issue 中使用 milestone_id
用 set_issue_estimate 记录已用时间	使用 add_issue_spent_time
用公开评论记录内部备注	使用 internal: true

参考资料

文件	使用时机
references/gitlab-sync-config.template.md	初始化配置
mcp-gitlab-usage	工具模式和限制条件