gitlab-board-sync

GitLab ボード同期

ローカルの SDD 計画・実行状態を既存の GitLab イシューに反映します。イシューは作成しません。

前提条件

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 イシュー IID が記載されている場合：

1. 説明と最近のコメントを確認するため read_issue を実行します
2. アクセスできない場合も処理はブロックせず、警告を記録して続行します
3. このフローではイシューを変更しないでください

フロー A — 計画後の一括処理

マップ内の各イシューについて（exclude_issues を除く）：

1. マイルストーンを検証します（プロジェクトおよびグループ）
2. milestone_id を指定して update_issue を実行します
3. 1 回の set_issue_labels で remove_labels と add_labels をまとめて実行します（RF、ステータス、チーム）
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
1 つの状態遷移に対してラベル呼び出しを 2 回行う	1 回のアトミックな 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	ツールスキーマとゲート