SuperAPI AI 工具集

coding-skill

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:为后端项目提供分层编码实现规范,指导从 API 路由到外部服务调用的全链路代码组织,强调每层职责边界,禁止跨层调用或职责混淆。

主要能力:定义五层结构——API Router → Service → Domain → Repository → DB,以及 Client → 外部服务。API 路由层使用 FastAPI Router 或 Django View,Pydantic 做请求/响应校验与序列化,异常由统一处理器转换,路由层不 catch、不写业务逻辑。Service 层负责业务逻辑编排与事务控制,一个方法对应一个完整业务用例,协调跨 Domain 对象。Domain 层承载核心业务逻辑与领域规则(状态机转换、金额计算),不感知外部服务与 HTTP 细节。Repository 层封装 SQLAlchemy 等持久化细节,对外提供领域友好接口。Client 层封装外部 HTTP/gRPC 调用,包含超时、重试与降级。

通用约束:价格字段用 Decimal,禁止 float;外部调用必须设置超时(≤5s)和降级方案;耗时操作委托 Celery/Dramatiq worker;关键链路使用 structlog 或 logging,异常场景打印完整 traceback;所有函数参数和返回值必须标注类型。

产出物:按 tasks.md 逐项完成代码变更,并输出编码报告 coding/coding_report_v1.md,包含变更文件列表、每个文件的变更摘要、未完成的 Task 及原因。

限制:资料未提供具体安装命令、依赖版本、运行方式及适用语言范围之外的平台信息。