用途:分析任何现有代码库,生成向 SpecWeave 结构迁移的计划,支持 Quick Start(增量)与 Comprehensive(前期全量)两条路径。Quick Start 适合 50k+ LOC、小团队和快速迭代,先做 1-3 小时初步扫描并立刻开工,之后按增量边改边补文档;Comprehensive 适合 <50k LOC、团队协作和受监管行业,先做 1-4 周全量分析、记录全部模块与业务规则、建基线测试再开始增量。工具会根据项目规模给出建议:<10k 行推荐 Comprehensive,10k-50k 由用户选择,50k 以上推荐 Quick Start。
主要能力:统计文件数、代码行数、模块数与测试覆盖率;扫描并分类文档为 PRD、HLD、ADR、Spec、Runbook 及图表;检测 Jira、Azure DevOps、GitHub Issues 等外部工具引用;发现 ESLint、Prettier、tsconfig、测试配置等编码规范;将现有目录映射到 .specweave 结构,并输出迁移清单与分阶段计划。
使用方式:先用 find、grep、wc 等命令扫描项目,再按所选路径执行;迁移中可运行 specweave init,增量用 /sw:increment,外部同步用 /sw-jira:sync --import、/sw-ado:sync --import、/sw-github:sync --import,并可用 cat .specweave/skill-memories/brownfield-analyzer.md 查看项目特定学习记录。
适用场景:遗留系统迁移到 SpecWeave、补建文档与架构决策记录、梳理业务规则和测试基线。限制:具体收费、价格、平台支持及实施效果资料暂未提供;工具不删除既有文档,也不建议对大型项目做强制的全量前期迁移。