SuperAPI AI 工具集

architecture-best-practices

通用与其它

查看项目

更新于 10-15 19:52

技能介绍

用途:这是一个参考层技能,把具体的最佳实践映射到15个领域的Tech Stack Taxonomy,并输入到Stack Compatibility Oracle。适合在确定技术选型前评估、诊断技术栈组合问题、在设计阶段评审架构决策,以及提前回答“可能出什么问题”。

主要能力:支持四种查询模式。领域查询(如“数据存储有哪些最佳实践”)、组合查询(如“Next.js + Supabase + Vercel 的最佳实践”)、问题查询(如“我的API在高负载下很慢”)、对比查询(如“此场景下 PostgreSQL 与 DynamoDB 如何选”)。

使用方式:接收查询后,先映射到15个领域中相关的领域,再检索相关最佳实践,结合用户项目上下文(规模、团队人数、约束)过滤和排序,最后输出结构化结果,包含实践、理由和跨领域影响。

覆盖领域与示例实践:语言与运行时(固定运行时版本、启用严格模式、匹配部署目标、优先标准库);框架与库(遵循框架约定、减少客户端JS、评估升级路径、业务逻辑与框架解耦);数据存储(按访问模式设计数据模型、无服务器连接池、版本化可逆迁移、按实际查询建索引、分离OLTP与OLAP);API与通信(从第一天起版本化、游标分页、显式超时与大小限制、谨慎使用GraphQL);认证与授权(使用成熟认证库、在数据层做授权、会话存HTTP-only Cookie);基础设施与部署(环境一致、零停机部署、设置资源限制);CI/CD与构建(流水线控制在10分钟内、本地与CI一致、固定版本);测试(测试金字塔、测行为而非实现、用工厂构造数据、在CI中跑完整迁移链);可观测性(从第一天起结构化日志)。

限制:资料仅展示到可观测性领域,其余领域内容暂未提供;具体命令、安装方式与收费信息暂未提供。