SuperAPI AI 工具集

fable-architecture

编程与开发

查看项目

更新于 10-24 16:18

技能介绍

Fable Architecture(微服务强制引擎)是一个面向 AI 编码工作流的架构决策技能,归属于 immamdouhaboammar/get-fable。其核心用途是在任何目录脚手架或实现工作开始之前拦截项目规格,确定性地判断该项目是否应当采用分布式微服务架构,并在触发阈值时以硬约束方式限制编码代理与下游子代理在解耦的微服务范式内工作。

用途与激活条件:当项目规格描述高并发(≥5,000 并发用户/连接,>10,000 RPS/TPS)、包含 ≥2 个解耦的业务域(如身份认证、计费/Stripe、转码、AI 推理、分析、消息),或工作负载同时包含 CPU 密集型内核与 I/O 密集型管道时激活;用户显式要求微服务评估、分布式架构设计或多语言技术栈分配时也会激活。简单命令行脚本、单文件工具、单域 CRUD 原型、静态博客、局部缺陷修复或单模块重构,以及已完成分解只需常规分步规划的工作,不适用本技能。

主要能力:一,三向量评估。Scale & Load 检测高并发、吞吐目标与延迟 SLA;Domain Decoupling 检测业务域边界;Resource Intensity 检测 CPU 密集与 I/O 密集瓶颈的混合程度。每项 0–10 分,综合分为 0.35×规模 + 0.40×领域 + 0.25×资源。二,裁决与单体锁定。任一向量 ≥7.0 或综合分 ≥6.0 时,判定为 microservices 并设置 allowMonolith: false,严格禁止生成单体脚手架;否则判定为 monolith 并允许单体。三,多语言技术栈分配。Category A:Go(Fiber、Gin、Go-Kit),负责高并发无状态路由;Category B:TypeScript(NestJS、Fastify 或 Elysia),负责 API 网关、BFF 与快速业务逻辑;Category C:Rust(Axum、Actix-web),负责高性能计算内核;Category D:Python(FastAPI,配合 PyTorch/TensorFlow),负责 AI 推理与数据工程;Category E:Elixir(Phoenix 与 LiveView),负责超高并发实时系统。API 网关固定为 Service #1(Category B),并要求至少两个独立的领域工作服务。四,通信标准契约。南北向采用 REST HTTP/JSON,配合 OpenAPI 3.1 与 TLS 1.3;东西向采用 gRPC(Protocol Buffers)或消息中间件(Kafka/RabbitMQ),禁止内部使用无类型 HTTP/JSON。五,输出架构清单。生成 microservices_manifest.toon 与配套 docker-compose.yml。

使用方式与规则:技能在执行时会先完成三向量打分并记录各项与综合得分,随后输出包含显式服务表的架构清单,设定单体锁定状态,并强制执行南北向 REST 与东西向 gRPC/消息中间件的通信契约,同时为每个拆分出的服务分配子代理角色与多语言栈。决策规则包括:allowMonolith 为 false 时,生成单目录应用或共享数据库即视为不变量违规;每个内部 RPC 接口须先以 .proto IDL 定义再实现;CPU 密集计算不得运行在 Node.js 事件循环上,须路由至 Rust 或 Python 服务;高吞吐无状态消息流交由 Go 服务;需要数十万持久 WebSocket 连接或实时消息编排时自动选择 Elixir;外部客户端不得直接调用内部 gRPC 服务,所有流量经 API 网关进入。

适用场景与限制:适用于金融科技高并发系统、AI 与媒体处理管道等需要分布式架构评估与强约束拆分的项目。技能附带渐进式资源,包括向量打分指南、技术栈矩阵、通信标准、子代理角色分布、示例演练、清单/compose/proto 模板以及评估脚本 scripts/evaluate-architecture.py。限制方面,该技能不面向小型单域项目或局部改动;具体运行环境、安装命令、收费模式与实际效果资料暂未提供。