用途:在功能故事实现之前,生成并验证项目的架构脚手架——所有基类、接口、基础设施抽象与可复用基础代码,形成符合 OOP/SOLID 的架构基础,供后续每个功能故事复用。
主要能力:按后端与前端分类生成脚手架清单,覆盖领域层(实体基类、值对象、领域事件)、应用层(CQRS 处理器抽象、校验结果、DTO、分页、操作结果)、基础设施层(通用仓储、工作单元、消息总线、外部服务抽象、数据库上下文、DI 注册)、横切关注点(当前用户上下文、可测试时间提供者、异常层级、错误处理中间件、强类型配置);前端覆盖基础组件、表单/列表组件、状态存储、API 服务、设计令牌、布局与基础 UI 组件、设计系统文档。还要求为每种模式提供一份可编译的示例实现(.example.,放在隔离的 examples/ 目录,不进入生产构建),并搭建代码质量工具链。
使用方式:先检查激活守卫——仅在工作流为 workflow-greenfield-init 或 workflow-big-feature,且 grep 未发现既有基础抽象时执行,否则跳过并标记完成。随后按顺序:读取计划、生成脚手架清单、对照计划校验、请用户确认、生成代码、编译验证 OOP/SOLID 合规,再调用 $linter-setup 与 $harness-setup,最后交接。步骤不得跳过、重排或合并,每步需更新任务跟踪并给出证据。
适用场景:绿地项目初始化、大型功能工作流中功能实现之前,或既有项目中新服务/模块需要自身基础架构时。
限制:不用于功能实现;项目已有基类与基础设施时应跳过;若必需步骤或工具在当前环境无法运行,应停止并询问用户;示例不得包含真实密钥或端点。具体命令与配置细节资料未完整提供。