用途:在创建大量文件之前,为产品级原型或应用仓库规划基础结构,使设计师、工程师与智能体后续无需反复自创约定。适用于全新项目(greenfield),不适用于已存在的仓库。
主要能力:确认框架、项目类型、包管理器、样式方案和部署目标;推荐功能就近(feature proximity)结构;区分基础 UI 组件与组合式功能组件;定义 TypeScript 严格度、lint、格式化、测试与 CI 基线;定义环境变量策略(含 .env.example 与校验要求);指定 tokens、全局样式、工具函数、校验 schema 与文档位置;识别所需智能体上下文文件;产出有序搭建清单。
使用方式:先运行框架适配评估($framework-fit-advisor)确定框架后再使用本技能。输出采用固定格式,包含技术栈假设、包管理器、部署目标、仓库结构、工具默认项、TypeScript 期望、环境策略、设计系统位置、测试基线、智能体上下文文件、有序搭建清单与待确认决策。示例输出结构为 src/ 下区分 app(路由与布局)、components/ui(仅基础组件)、components/features(每功能一个文件夹)、lib(数据访问、校验 schema、工具)与 styles(tokens 与全局 CSS),并配置 Biome、严格 TS、Vitest、Testing Library、Playwright、.env.example 与 zod 校验 env.ts,以及 AGENTS.md。
限制与边界:不适用于已有仓库(需先审计);不提倡为假想规模提前抽象;禁止将功能组件放入基础 UI 目录;环境变量不得无文档或无校验;需避免智能体日后自行推断设计 token 位置。最终需校验计划已明确基础组件、功能组件、tokens、环境配置、测试与智能体文档的位置,且搭建清单可按顺序执行。