/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(向后兼容)。
流程
- 读取
.devpace/integrations/sync-mapping.md(不存在 → 引导setup) - 加载
skills/pace-sync/sync-procedures-common.md(始终加载) - 根据子命令,仅加载对应的 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 关系已建立