SuperAPI AI 工具集

solid-python

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:在编写或重构 Python 代码、组织 modules/[feature] 分层模块,或定义基于 Protocol 的接口时使用,目标是落实 SOLID 原则与模块化架构。

主要能力与要求:实现前必须做 DRY 检查,先 Grep 代码库中相似的接口、服务或逻辑;查看共享位置 core/services/、core/interfaces/。若已有相似代码则扩展复用而非重复;若代码会被 2 个以上功能使用则放到 core/。架构上强制使用 modules/[feature]/ 分层,包含 routes/、services/、repositories/、interfaces/、models/;共享代码放 core/{services,interfaces,models}/;禁止使用扁平的 src/ 结构。

关键规则:文件行数受 FUSE_SOLID_MAX_LINES 限制;routes 保持轻薄并委托给 services;接口只放 interfaces/ 目录;每个公开函数写 docstring;所有签名必须有类型标注;接口使用 typing.Protocol,且接口要小,最多 1-3 个方法。

工作流(强制):任何实现前并行启动 3 个 agent,每次 Agent 调用各带一个名称:fuse-ai-pilot:explore-codebase 分析现有架构,fuse-ai-pilot:research-expert 通过 Context7 核对 Python 文档,fuse-ai-pilot:sniper 做实现后验证。

参考指南:SOLID 五原则见 principles.md;目录布局、测试与类型约定见 patterns.md。

禁止项及修正:文件超过 FUSE_SOLID_MAX_LINES 需按职责拆分;接口写在实现文件中要移到 interfaces/ 目录;臃肿接口(4 个以上方法)拆成小 Protocol;扁平 src/ 结构改为 modules/[feature]/;具体依赖改为 Protocol 加依赖注入;缺失类型标注要补齐。

适用场景与限制:适合需要清晰分层、可测试、可复用接口的 Python 项目;具体文件行数上限值、安装方式与更多细节资料暂未提供。