SuperAPI AI 工具集

solid-astro

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:这是一个跨领域的代码质量技能,用于在 Astro 项目中应用 SOLID 原则与模块化架构。它不教授 Astro API 本身(相关内容参见 astro-7、astro-content、astro-i18n、astro-styling),只规范使用这些 API 的代码结构。

主要能力:提供组件、布局、服务、接口的现成模板;给出 SOLID 原则、文件行数限制、接口组织、目录结构、DRY 与 JSDoc 的参考文档。

使用方式:实施前须先并行启动三个 agent(fuse-ai-pilot:explore-codebase、fuse-ai-pilot:research-expert、mcp__context7__query-docs),并分析 src/ 目录、阅读相似文件、用 Grep 查找重名函数或组件;实施后运行 fuse-ai-pilot:sniper 验证。写新代码前先 Grep 相似逻辑,检查 src/lib/ 与 src/components/,逻辑出现 2 处以上则抽取到 src/lib/,类型出现 2 个文件以上则移到 src/interfaces/。

绝对规则:源文件不超过 FUSE_SOLID_MAX_LINES,按职责拆分;所有类型放 src/interfaces/,不得写在组件文件;所有导出函数必须有 JSDoc;src/pages/ 不放业务逻辑。禁止:超行数文件、在 .astro 组件中写 TypeScript 接口、在 pages 中写业务逻辑、组件内直接调用 CMS/API(应使用 src/lib/ 服务)、复制粘贴逻辑、导出函数/组件/类型缺少 JSDoc、使用 any 类型。

限制:具体行数上限由 FUSE_SOLID_MAX_LINES 环境变量决定,资料未给出具体数值;未提供安装命令、收费与平台信息。