用途:从 StackShift 逆向工程文档中提取技术无关、可复用的组件规格,用于任意项目复用或跨生态迁移业务逻辑。前置条件:需先完成 Gear 2(Reverse Engineer)并生成全部 11 份文档;若缺失,先运行 /stackshift.reverse-engineer 或减少覆盖范围。输出:在 _portable-extract/ 下生成 2 个可移植产物。
主要能力:读取 11 份逆向工程文档,提炼为 epics.md(BMAD 格式史诗,含抽象角色、验收标准、业务规则引用)与 component-spec.md(业务规则、数据契约、边界情况、错误状态、交互模式、可访问性与性能等功能性要求)。包含核心业务逻辑、抽象角色 [User]/[Admin]/[System]、数据契约、边界与错误、交互流程等;排除技术搭建、CI/CD、技术债、源平台集成细节、测试基础设施五类内容。
使用方式:提供三种模式。YOLO 全自动,约 10 分钟,无用户输入,适合快速或批量提取;Guided 推荐模式,约 15-20 分钟,提出 3-7 个针对性问题,兼顾速度与质量;Interactive 交互模式,约 20-25 分钟,逐步评审,适合关键组件。流程包括校验前置文档、加载文档、选择模式、抽象角色、提取业务规则与数据契约、生成可移植史诗、写入产物并生成可移植性报告。产物带 YAML frontmatter,含源项目、提取日期、模式、角色映射、排除项与可移植性评分。
适用场景:Gear 1 选择 portable-extract 框架、需要跨项目复用规格、跨生态迁移业务逻辑、需要摆脱源平台细节的抽象史诗与规格。
限制:依赖 Gear 2 全部 11 份文档,缺失需先补全或降级;较新文档在旧运行中可能缺失;抽象与排除结果可能需要人工复核,输出中会标记 [REVIEW];实际效果受源文档质量影响。