SuperAPI AI 工具集

project-architecture

前端与建站

查看项目

更新于 10-15 17:30

技能介绍

用途:这是一个项目架构护栏技能,针对 Next.js 或 Astro 应用,在改动 UI、布局、组件结构、状态流、主题、数据展示或服务端/客户端边界之前加载执行。

主要能力:从项目实际配置检测框架而非猜测;坚持服务端优先渲染,仅在交互无法用服务端实现时才添加客户端代码,并尽量缩小客户端面;改动框架 API 或项目结构前先读已安装框架的官方文档;若存在 DESIGN.md 则遵循其视觉与 UX 决策;优先基于已有 shadcn 原语和语义化 token 构建;为每处数据展示显式提供加载、空、错误状态;按风险比例使用项目已有测试工具补充测试。

使用方式:先读取 package.json 并列出根配置文件以检测框架。若依赖含 next 或存在 next.config.* 属 Next.js,参照 references/next.md;若依赖含 astro 或存在 astro.config.* 属 Astro,参照 references/astro.md。两者都有或都没有时停止并询问改动目标。之后加载匹配的参考并应用其边界规则,创建新内容前先搜索已有组件、路由和样式,用最小客户端面实现改动,最后回答收尾前检查清单并加载 project-min-evaluation(若已安装)或运行项目质量脚本。

适用场景:Next.js 或 Astro 项目中进行涉及 UI、布局、组件架构、状态流、主题、数据展示与服务端/客户端边界的改动。

限制:输出需报告检测到的框架、每一处新增或移动的服务端/客户端边界及原因和检查清单答案。具体参考文件内容和命令示例资料中未完整提供。