SuperAPI AI 工具集

fusion-backend-dev

通用与其它

查看项目

更新于 10-14 08:07

技能介绍

用途

该技能面向 Fusion 后端服务的消费方,而非后端开发本身。适用于以下情况:需要了解 Fusion 后端服务有哪些、暴露哪些 API、采用何种集成模式或架构决策。典型使用场景包括前端/客户端应用开发时需要理解后端契约、与 Fusion API 集成时需要参考模式、做架构设计时需要后端最佳实践,以及学习现有 Fusion 服务的实现方式。

主要能力

技能的触发场景覆盖了常见的后端消费问题,例如如何调用 People API、授权模式示例、Org 服务的契约、服务如何处理校验错误、使用了哪些异步/消息模式、CQRS 处理器的参考实现、如何集成外部 API、需要哪些认证/授权要求、事件如何在系统中流转、跨服务调用的模式、如何组织 API 客户端、应在何处调用 Context API,以及 Fusion 中 command 与 query 的区别。

技能的执行分为四步:

  1. 澄清消费上下文——先明确集成点(调用后端 API、读取事件消息、实现 webhook、集成外部系统)、你的角色边界(前端开发者、其他服务的后端开发者、外部集成方、架构师)和范围(单个 API 契约、完整模式、参考实现、架构权衡)。
  2. 搜索参考实现——通过 mcp_fusion_search_backend_code 定位既有模式,以高层意图搜索,先取前 3-5 条结果,记录 repository、service、filePath 元数据,并提取展示模式的最小代码片段。
  3. 解释模式——清晰陈述服务的作用与暴露的契约,引用相关代码片段并给出行号,说明前置条件、授权、错误处理、异步行为等约束,并关联到你的用例。
  4. 校验完整性——确认你已理解契约的输入输出与错误、看到了真实代码引用、知道代码位置、了解前置条件,并有足够信息去实现或集成。

使用方式

需要提供的信息中,必填项是你想做什么(集成点、用例或模式的清晰描述)和你的角色/上下文;条件性信息包括:比较模式时需说明两个候选项,消费 API 时需说明操作/场景,集成时需说明外部系统名称与流向。若意图不清晰,技能会使用追问清单进行澄清。

参考文档

技能附带参考文档以提供更深入的模式说明,包括:api-contracts.md(API 契约与版本化)、authorization-patterns.md(认证、授权要求、基于角色的访问)、validation-patterns.md(输入校验、错误响应、业务规则)、async-patterns.md(事件、服务总线、领域通知、最终一致性)、integration-patterns.md(跨服务调用、外部 API、webhook 处理)、cqrs-reference.md(CQRS 处理器、命令、查询、通知结构)。另有 assets/follow-up-questions.md 用于澄清模糊请求。

适用场景

适用于所有需要理解 Fusion 后端既有契约与模式的消费方与设计方,包括前端开发、外部集成与架构设计。

限制

技能明确划定了边界:不负责创建或修改后端服务(应使用服务专属仓库技能)、不负责新增端点或 API 操作、不负责数据库 schema 变更或迁移、不负责定义授权需求(该技能只展示已有内容,不制定新需求)。纯粹的架构讨论若无代码引用,应改用 fusion-research 或 ADR 相关技能;在 Fusion Framework 备选方案之间做选择时,应使用 fusion-research 或 fusion-app-react-dev。

在安全与约束方面,技能不得在无法从检索到的源码或仓库文档中验证时,将真实后端 API 行为描述为事实;不得在搜索无证据时声称某模式存在;不得将示意性伪代码当作检索到的源码;不得建议修改后端服务。同时,技能始终会为真实代码标注仓库、文件路径与行号,说明模式来自哪个仓库,注明某模式仅存在于某个服务而未见于其他服务,并在你需要实施变更时提议升级至 fusion-services-developer 智能体。若涉及新独立后端 API 的搭建或部署(应用注册、Roles V2、数据库、Radix/Kubernetes 部署、可观测性),技能会指向 fusion-docs 上的 New Backend Service Checklist,而非自行编排步骤。

该技能的完整安装命令、具体分类归属和官方补充说明在提供资料中暂未明确给出。