SuperAPI AI 工具集

external-sync-wizard

部署与运维

查看项目

更新于 10-16 05:00

技能介绍

用途:指导在 SpecWeave 与外部项目管理工具(GitHub Issues、Jira Epics、Azure DevOps Work Items)之间建立同步。核心原则是 .specweave/docs/specs/ 为本地唯一事实来源,外部工具只是镜像,不支持外部工具之间互相同步。

主要能力:支持四种同步方向——双向(本地↔外部,推荐团队使用)、仅导出(本地→外部)、仅导入(外部→本地,适合迁移已有项目)、手动同步(按需执行命令)。可配置是否在规划增量时自动创建外部议题。

使用方式:按向导完成认证。GitHub 需安装并登录 GitHub CLI(brew install gh、gh auth login、gh repo set-default);Jira 需域名、API token、邮箱与项目键;Azure DevOps 需组织 URL、PAT、项目名。密钥写入 .env(gitignore),同步配置写入 .specweave/config.json。常用命令包括 /sw-github:sync、/sw-github:create-issue、/sw-github:import-all、/sw-jira:sync、/sw-jira:create-epic、/sw-ado:sync、/sw-ado:create-workitem 等。

适用场景:团队协作、单人项目的外部可见性、从外部工具迁移到 SpecWeave、测试或一次性同步。

限制:自动同步仅作用于活跃增量,已完成或已放弃的增量不会自动同步;双向同步出现双方同时修改同一字段时需人工选择保留本地、保留外部或手动合并;避免在本地与外部同时手动编辑同一字段。具体收费、价格与平台支持范围资料未提供。