消费或集成 Fusion 后端 API…

当前端/客户端、集成方或架构师需要理解 Fusion 后端服务可用 API、集成点、契约与实现模式时使用。

适用场景

解决思路

1. 若可用，配合 Fusion MCP 使用；优先使用 mcp_fusion_search_backend_code 搜索后端参考代码；前端/客户端开发者还应安装 fusion-research 以获取更深架构上下文。
2. 先明确消费上下文：判断集成点类型——调用后端 API、读取事件消息、实现 webhook，还是集成外部系统。
3. 明确自身边界与角色：前端开发者、其他服务的后端开发者、外部集成方，还是架构师。
4. 明确范围：只要单个 API 契约、完整模式、参考实现，还是架构权衡。
5. 若用户意图不清，使用 assets/follow-up-questions.md 中的追问问题澄清。
6. 向用户确认必填输入：要做什么（集成点、用例或模式）以及角色/上下文。
7. 当用户在比较模式时，确认其正在权衡的两个选项。
8. 当用户要消费 API 时，确认操作/场景（CRUD、异步、实时等）。
9. 当用户要集成时，确认外部系统名称和数据流方向（调用外部 vs 被调用）。
10. 使用 mcp_fusion_search_backend_code 定位现有模式。
11. 用高层意图调用搜索，例如 “How People service exposes authorization” 或 “Cross-service API integration patterns”。
12. 初始先看 top: 3-5 条结果。
13. 捕获 metadata.repository、metadata.service、metadata.filePath。
14. 提取展示该模式的最小代码片段（方法签名、类型契约、授权检查）。
15. 若结果不清，只细化一次：加入具体服务名或接口。
16. 细化时缩小到特定层（controller、handler、client interface）。
17. 细化时换用聚焦结果而非实现细节的表述。
18. 基于第 2 步证据解释模式：清楚说明服务做什么、暴露什么契约。
19. 展示参考代码：引用相关片段，并给出文件路径和行范围。
20. 解释约束：前置条件、授权、错误处理、异步行为。
21. 关联到用户用例：说明如何应用该模式。
22. 如存在，提出权衡或替代方案。
23. 结束前验证完整性：用户理解契约（输入、输出、错误）。
24. 结束前验证完整性：用户看到真实代码引用（非编造）。
25. 结束前验证完整性：用户知道代码位置（repository、service、file path）。
26. 结束前验证完整性：用户知道先决条件（认证、配置、依赖）。
27. 结束前验证完整性：用户有足够上下文来实现或集成。
28. 若仍有不确定性，明确标出。
29. 查阅 references/api-contracts.md，获取 Fusion 服务 API 契约和版本管理。
30. 查阅 references/authorization-patterns.md，获取认证、授权要求、基于角色的访问。
31. 查阅 references/validation-patterns.md，获取输入验证、错误响应、业务规则。
32. 查阅 references/async-patterns.md，获取事件、service bus、领域通知、最终一致性。
33. 查阅 references/integration-patterns.md，获取跨服务调用、外部 API、webhook 处理。
34. 查阅 references/cqrs-reference.md，获取 CQRS handler、command、query、notification 结构。
35. 使用 assets/follow-up-questions.md 澄清模糊请求。
36. 使用 references/integration-patterns.md 判断常见集成场景适用哪些模式。
37. 绝不把真实后端 API 行为描述为事实，除非能在检索到的源代码或引用的 repo 文档中验证。
38. 搜索无证据时，绝不声称某模式存在。
39. 绝不把说明性伪代码当作检索到的源代码。
40. 绝不建议修改后端服务——这超出范围。
41. 当说明性示例不是检索所得时，标注为 examples/pseudo-code。
42. 对真实代码捕获并引用 repository、file path 和 line references。
43. 说明该模式来自哪个 repository。
44. 注明某模式存在于一个服务但不存在于其他服务。
45. 若用户想实现变更，提供升级到 fusion-services-developer agent 的选项。
46. 设置或部署新的独立后端 API（app registration、Roles V2、数据库、Radix/Kubernetes deployment、observability）时，指向 fusion-docs 上的 New Backend Service Checklist 链接，而不是即兴编排顺序。

适用边界 · 注意事项

• 创建或修改后端服务、添加新端点/API 操作、数据库 schema 变更或迁移、定义授权需求时不要用；应使用对应后端服务仓库 skill 或后端开发流程。
• 纯架构讨论且不需要代码引用时不要用；应改用 fusion-research 或 ADR 相关 skill。
• 在 Fusion Framework 替代方案之间选型时不要用；应改用 fusion-research 或 fusion-app-react-dev。