SuperAPI AI 工具集

scalable-thinking

编程与开发

查看项目

更新于 10-16 06:51

技能介绍

用途:为 AI 在设计与编码过程中提供可扩展性与简洁性平衡的参考准则,来源页附有面向人类的说明文档路径 docs/architecture/HIERARCHICAL_PLANNING.md 及 docs/getting-started/。

主要能力与要点:主张数据模型规范化并加索引、使用简单查询;API 采用带版本号的 RESTful 路径,如 /api/v1/users/:userId/processes;代码结构按功能划分(src/features/{feature}/{hooks,components,api}/ 与 src/shared/),保持扁平层级;配置集中到单个对象并按环境取值。可扩展模式包括游标分页 ?limit=20&cursor=abc 并返回 { nextCursor, hasMore }、结构化错误(AppError 带 code 与 statusCode)。

反模式:为假想的百万用户提前设计、过早引入 Redis 预优化、为单一用例做抽象、第一天就上微服务;对应做法是先做简单单体、先用内存缓存并在有测量数据后再引入 Redis、直接实现并在出现两三个例子后再抽象、随团队与功能增长再拆分。

使用方式:作为 AI 执行时的参考清单使用。设计前自问模型能否支撑 10 倍增长、能否查询所需数据、是否有自然分区键、API 是否带版本、列表是否分页;过程中检查是否使用标准模式、是否是最简方案、初级开发者能否理解、是否在积累 3 个以上例子前不做抽象。

何时扩容:数据库查询超过 2 秒、API p95 超过 500ms、错误率超过 1%、三个月内增长 10 倍、团队超过 5 人;在此之前保持简单并持续度量。

限制:资料未提供安装命令、具体代码实现、收费或许可信息,暂未提供。