用途:这是 SpecWeave 的进度同步技能,围绕 /sw:sync-progress 命令实现任务、文档与外部工具之间的端到端同步。适合首次同步、完成一批任务后同步、关闭增量前的最终同步,以及修复“未关联 GitHub issue”等问题。
主要能力:分阶段编排同步流程,包括把 tasks.md 中已完成任务对应到 spec.md 中的验收条件并标记完成、把 spec 同步到 living docs 与用户故事、检查外部工具是否存在关联 issue,缺失时自动创建 GitHub/JIRA/Azure DevOps issue、与外部工具双向同步并更新状态行缓存。对已归档或已完成的增量,命令会为历史追踪创建 issue 并立即关闭。
使用方式:基本命令为 /sw:sync-progress,可显式指定增量 ID,如 /sw:sync-progress 0053,也可从活动增量自动检测。支持 --dry-run 预览、--no-create 跳过缺失 issue 的自动创建、--no-github、--no-jira、--no-ado 跳过对应外部工具、--force 跳过校验失败强制同步。若只同步验收条件或文档,可改用 /sw:sync-acs、/sw:sync-specs;仅同步 GitHub 且 issue 已存在时用 /sw-github:sync。
适用场景与限制:核心任务是任务到文档的同步,外部工具同步为尽力而为,GitHub/JIRA/ADO 同步失败只记录警告并继续;验收条件或文档同步失败则中止。仅会同步 .specweave/config.json 中已配置的工具。若出现未找到活动增量,需显式传入增量 ID;若验收条件缺失,可先执行 /sw:embed-acs 再重试。价格、收费、平台要求等资料暂未提供。