SuperAPI AI 工具集

backend-architect

编程与开发

查看项目

更新于 10-16 09:18

技能介绍

用途

该技能用于后端架构决策场景:当智能体需要选择、评审或记录生产级技术方向时启用。具体包括设计 API、认证、缓存、队列、持久化或可观测性;选择后端框架、数据库、ORM、向量存储或部署架构;以及从可扩展性、安全性或可维护性角度评审后端方案。它不适用于通用解释、文案编辑,或不影响架构与可复用实现模式的一次性代码改动。

主要能力

技能内置了硬性规则与决策门(Decision Gates),用于约束选型过程:

  • 在选择技术栈前,先发现仓库内权威的产品与约束来源(docs/product-charter.md 只是可能示例,并非必需路径)。若发现后仍缺少关键产品约束或质量属性,则把缺失决策作为问题返回并停止选型。
  • 优先选择“无聊”、可观测的架构,而非分布式复杂度。
  • 在关系型需求验证后,仅当数据形态、运行时、一致性和运维未确立更合适方案时,才把 PostgreSQL 作为初始候选。
  • 当集成风险是重点时,不要模拟生产基础设施行为,应使用容器或聚焦的集成检查。
  • 将运行时可移植性、依赖许可、托管服务条款和数据驻留作为架构输入;许可义务应获取法律审查而非自行推断。
  • 除非被测行为可证明等价,否则不要用嵌入式或 WASM 数据库替代生产集成测试。
  • 为可重放设计持久工作流:隔离非确定性、使副作用幂等、对长期执行版本化、限制重试。
  • 将 MCP 工具、A2A 智能体和模型输出视为不可信外部边界,需显式身份、授权、同意、验证和审计。
  • 保持 BFF 轻薄:仅做编排和协议转换,绝不拥有领域。
  • 主答案以决策为先,深度理由放入本地参考而非冗长内联叙述。
  • 在用于决策指导前,对版本或 API 敏感的主张需对照实时来源验证。

决策门包括:缺少或不足的关键约束时返回未解决问题、不推荐技术栈;公共 API 默认 REST + OpenAPI,除非消费者契约证明其他协议;仅 TypeScript 应用边界且同一团队拥有两端时 tRPC 可能胜出;高写入/事件工作流仅在一致性边界明确后才考虑队列或事件驱动;语义搜索在 PostgreSQL 已是权威时从 pgvector 开始,外部向量数据库仅因规模/运维原因使用;可移植边缘 TypeScript API 在 Web 标准和多运行时可移植性是约束时评估 Hono;嵌入式 PostgreSQL 语义评估 PGlite 用于浏览器/本地优先状态、开发或快速测试;共享内存基础设施按协议需求、模块、支持、许可政策和迁移证据比较 Valkey、Redis 和托管服务;长期运行或易失败流程仅在暂停/恢复、重放、人工输入或跨部署恢复证明其运维模型合理时使用持久执行;智能体互操作使用 MCP 处理智能体到工具/资源边界,A2A 处理独立部署的智能体到智能体边界。

使用方式

执行步骤为:先发现并阅读仓库内权威来源,涵盖产品约束、质量属性、团队能力、运行时、数据所有权、安全边界和验证路径;若这些关键输入不足以区分选项,则把缺失决策作为问题返回并停止;选择满足已验证 SoT 输入的最小架构;在需要详细矩阵、兼容性与许可门、反模式、命令或来源链接时阅读 references/technical-reference.md;说明所选模式、被拒替代方案,以及选择错误时运行时会出现什么问题;仅在实时来源验证后记录版本敏感决策。

输出契约要求:每条建议都给出证明其合理性的确切 SoT 约束或质量属性;列出被拒替代方案及具体权衡;说明运行时风险、失败触发条件和缓解措施;给出采用前所需的验证步骤或证据;当无法证明选型合理时,把缺失的 SoT 决策作为阻塞性问题返回。

适用场景

适用于需要做出或评审生产级后端架构决策的智能体任务,例如 API 协议选择、数据库与 ORM 选型、认证与缓存设计、队列与事件驱动架构、向量检索方案、部署架构评审,以及涉及 MCP/A2A 边界的智能体互操作设计。

限制

不适用于通用解释、文案编辑或一次性代码改动。技能本身不提供具体价格、收费或平台信息。部分技术判断依赖实时来源验证,且许可与数据驻留问题需法律审查而非自行推断。参考资料包括 references/technical-reference.md(v3.1.2 决策的技术依据)和 references/source-index.md(版本敏感主张的来源链接与验证状态)。