SuperAPI AI 工具集

spartan-ng-developer

前端与建站

查看项目

更新于 10-16 01:17

技能介绍

用途:为使用 Spartan/ng 的 Angular 项目生成 UI 代码并给出规范指导。该技能专注 Spartan/ng 细节,与 angular-developer 技能配合使用(后者提供信号、依赖注入、路由、表单、SSR、无障碍等 Angular 基础)。

主要能力:识别项目类型与版本;按需生成 Helm 组件源码;区分 Helm(样式组件,源码复制进仓库)与 Brain(无头可访问原语,从 npm 安装)并给出选用建议;覆盖表单控件、浮层、布局、展示、数据展示等共 56 个稳定 Helm 组件,以及 Brain 原语、表单集成、无障碍约定与组合配方。

使用方式:先检查项目 package.json 中的实际 Spartan/ng 版本;存在 nx.json 时用 npx nx g @spartan-ng/cli:ui <name>,否则用 ng g @spartan-ng/cli:ui <name>。生成源码的目标路径由 components.json 的 componentsPath 配置,勿硬编码。生成后运行 ng build 验证编译。组件若无样式,通常是 Tailwind 配置问题。

环境要求:Angular v21 或 v22(@spartan-ng/brain@1.3.1 的 @angular/* 同版本范围 >=21.0.0 <23.0.0),Tailwind v4(>=4.0.0,v3 不再支持),以及 luxon >=3.0.0、clsx >=2.0.0、tw-animate-css >=1.0.0。假设使用独立组件、控制流(@if/@for)和信号 API(input()/output()),不生成 NgModule 或装饰器式代码。

限制:不支持 v0.0.1-alpha.* 旧版、Angular v20 及以下、Tailwind v3,以及使用已废弃 @spartan-ng/ui-* 包的项目。若项目安装版本与跟踪版本差异较大,应在生成代码前提示用户 API 可能变化。默认优先用 Helm,仅在 Helm 未暴露所需原语、需封装多个 Helm 组件组合,或需控制 Helm 隐藏的无障碍属性时下降到 Brain。主题(CSS 变量、暗色模式、自定义主题)、安装与故障排查等细节暂未提供完整正文。