/pace-sync

description: Use when user says "同步/sync/同步到GitHub/关联Issue/unlink/Gate同步/sub-issue/全量同步/增量同步" or /pace-sync. Syncs Epic/BR/PF/CR to GitHub Issues. NOT for internal state (use /pace-dev).
argument-hint: "[子命令] [参数]"
allowed-tools: AskUserQuestion, Read, Write, Edit, Glob, Grep, Bash
model: sonnet

/pace-sync — 外部工具同步

将 devpace 全部实体（Epic/BR/PF/CR）与外部项目管理工具同步。支持 GitHub（当前），设计为 Linear/Jira 可扩展。

与现有机制的关系

• /pace-dev 管理 CR 内部状态转换 → /pace-sync 将状态变化推送到外部
• /pace-change 管理变更操作 → /pace-sync 同步变更后状态到外部
• /pace-release 管理发布流程 → /pace-sync 同步发布状态到外部
• /pace-review Gate 2 结果 → /pace-sync Gate 结果自动推送（Comment + 标签）
• /pace-status 展示内部状态 → /pace-sync status 展示同步状态和外部链接

推荐使用流程

首次配置：`setup` → 日常同步：`/pace-sync`（智能同步）→ 查看状态：`status`

输入

`$ARGUMENTS` 解析为子命令 + 参数。

子命令

| 子命令 | 参数 | 说明 | |--------|------|------| | sync | [--dry-run] | **智能同步**（默认行为）：自动检测变更，呈现摘要，确认后执行。无参数时等价。 | | link | 实体ID [#外部ID] | 关联实体与已有外部 Issue（支持 EPIC-xxx/BR-xxx/PF-xxx/CR-xxx；省略外部 ID 则智能匹配） | | unlink | 实体ID | 解除实体与外部的关联 | | status | [--all] | 查看同步状态（--all 显示全部实体类型，默认仅 CR） | | setup | [--auto] | 引导式同步配置（--auto 跳过交互确认） | | pull | 实体ID | 查询外部状态，提示用户是否更新 devpace（轻量检查） |

**无参数时默认执行智能同步（sync）。**

**实体 ID 格式**：`EPIC-001`、`BR-002`、`PF-003`、`CR-004`（前缀确定类型）。纯数字默认为 CR（向后兼容）。

流程

1. 读取 `.devpace/integrations/sync-mapping.md`（不存在 → 引导 `setup`） 2. 加载 `skills/pace-sync/sync-procedures-common.md`（始终加载） 3. **根据子命令，仅加载对应的 procedures 文件**（均位于 `skills/pace-sync/` 目录）：

| 参数 | 加载文件 | |------|---------| | `sync` / （空） | skills/pace-sync/sync-procedures-entity.md（智能同步主流程） | | `sync --dry-run` | skills/pace-sync/sync-procedures-entity.md（dry-run 模式） | | `link` | skills/pace-sync/sync-procedures-link.md + skills/pace-sync/sync-procedures-entity.md（§1 ID 解析） | | `unlink` | skills/pace-sync/sync-procedures-status.md + skills/pace-sync/sync-procedures-entity.md（§1 ID 解析） | | `status` [--all] | skills/pace-sync/sync-procedures-status.md [+ skills/pace-sync/sync-procedures-entity.md] | | `setup` | skills/pace-sync/sync-procedures-setup.md | | `pull` | skills/pace-sync/sync-procedures-pull.md + skills/pace-sync/sync-procedures-entity.md（§1 ID 解析） |

Gate 结果同步（被动触发）：skills/pace-sync/sync-procedures-push-advanced.md

Auto-link/create（Hook 触发）：skills/pace-sync/sync-procedures-auto.md

输出

智能同步输出格式：

同步检测：
- 3 个实体有变更（CR-003 状态→developing, EPIC-001 完成度↑, PF-002 新增验收）
- 2 个新实体未关联（BR-003, CR-008）
- 7 个已关联且无变化

[用户确认后]

| 实体 | 类型 | 外部链接 | 操作 | 结果 |
|------|------|---------|------|------|
| EPIC-001 | Epic | [#10](URL) | 更新标签 | ✅ |
| BR-003 | BR | [#15](URL) | 新建 Issue | ✅ |
| CR-003 | CR | [#42](URL) | 更新标签 + Comment | ✅ |

汇总：3 已同步 / 2 新建 / 7 无变化
层级：2 个 sub-issue 关系已建立