用途:统一管理 SpecWeave 规格与增量(increment)在多个项目或仓库间的组织与拆分,支持 GitHub、Azure DevOps、Jira 三种后端,取代旧的 sw:github-multi-project 与 sw:ado-multi-project,并新增 Jira 多项目支持。
主要能力:规格组织(存放于 .specweave/docs/internal/projects/{project-id}/);任务拆分(分析 tasks.md 并按项目拆分);跨项目协调(跟踪项目间依赖);双向同步(本地规格与远端工作项保持一致)。
使用方式:通过 --tool 选择后端,如 sw:multi-project --tool github、--tool ado、--tool jira。省略时读取 .specweave/config.json 的 integrations.primary,未设置则回退 github。同步命令示例:sw:multi-project --tool ado sync-increment 0014、sync-spec、sync-all。Jira 侧用 sw-jira 插件创建 Epic/Story,如 sw:jira-create --type epic --project PAY --summary "...",并用 --epic-link 保留跨项目关系。
适用场景:单仓库/单项目、多仓库(polyrepo)、父仓库、monorepo、按团队划分项目(ADO/Jira 推荐)、ADO 区域路径或 Jira 组件划分。ADO 支持基于关键词与文件模式的智能项目检测及置信度评分(阈值 >0.7 自动分配)。
限制:Jira 跨项目 Epic 链接需实例启用 Advanced Roadmaps / Jira Portfolio 插件,否则回退为 related to 链接。其余配置细节与版本信息以官方资料为准。