SuperAPI AI 工具集

backend-architect-lite

编程与开发

查看项目

更新于 10-16 09:17

技能介绍

backend-architect-lite 是一个聚焦生产后端架构决策的技能,定位为“简洁、决策优先”的指导,用于选择、评审或记录后端方向。其激活契约明确:它服务于 API、持久化、认证、缓存、队列、可观测性与部署架构的设计;也用于框架、数据库、ORM、向量存储或智能体边界的选型;以及从可扩展性、安全性、可运维性或可维护性角度评审后端方案。它不用于泛泛解释、文案编辑或与架构无关的一次性代码改动。

使用方式上,该技能要求在选型前先发现并阅读仓库内的权威来源,以获取产品约束、质量属性、团队能力、运行时、数据归属、安全边界与验证路径,docs/product-charter.md 只是可能示例之一。若材料输入不足以区分选项,它要求将缺失决策作为问题返回并停止选型。它要求把每个被点名的技术视为候选而非默认,优先选择满足已验证约束的最小、 boring、可观测的架构,并将运行时可移植性、许可、托管服务条款、数据驻留、保留期与法律义务视为架构输入;对未解决义务要求取得法律审查,不得自行推断。

主要能力体现为一套选型门槛与执行顺序:先从仓库原生事实来源发现,再在存在阻塞性产品、质量、安全、数据、驻留、工作负载或运维问题时停止;随后选择最小且与约束匹配的候选栈,并为每个选择引用确切的事实来源约束;在引入分布式组件前先定义 API、数据归属、信任、一致性、失败、可观测性与恢复边界;最后陈述被否决的替代方案、运行时失败触发条件、缓解措施、验证证据与回退方案,并在记录版本敏感指导前核验实时一手来源。

技能还给出运行时与数据选择、API/身份/安全、工作流/智能体/检索、可观测性/隐私/测试等方面的规则。例如:框架候选包括 FastAPI、Litestar、Django + DRF、Fastify、Hono、Elysia、Go 与 Rust/Axum,各自有附加条件;PostgreSQL 是可反驳的关系型基线,SQLite/PGlite、pgvector、MongoDB、TimescaleDB/InfluxDB、Valkey/Redis 等均需由测量与运维约束支撑;缓存不应默认添加;认证需在客户端类型、身份提供方、撤销延迟、威胁模型、合规与会话拓扑已知后再选;OAuth 是授权,OIDC 增加认证,JWT 是令牌格式;浏览器/原生授权码客户端使用 Authorization Code with PKCE,但不应盲目把 PKCE 用于 client_credentials。它强调 MCP 用于工具/资源边界,A2A 用于独立远程智能体边界,远程描述、身份、负载与工具结果默认不可信。

输出契约要求返回:为每项建议提供确切的事实来源约束或质量属性;选定模式与被否决替代方案及具体权衡;采用前的运行时风险、失败触发、缓解、回退与验证证据;适用的安全、隐私、许可、托管服务、驻留、保留与法律审查约束;以及当无法证明选型合理时,作为阻塞问题的缺失材料决策。限制方面:资料未提供具体收费、价格、平台或效果信息;其规则明确禁止用 mock、嵌入式引擎或 WASM 数据库证明生产行为,也要求对未解决的法律义务不做推断。