SuperAPI AI 工具集

solid-python

编程与开发

查看项目

更新于 10-26 16:21

技能介绍

solid-python 是一个面向 Python 代码编写与重构的 Claude 插件技能,出自 fusengine/claude-plugins 合集。

用途 该技能在编写或重构 Python 代码、按 modules/[feature] 分层组织模块、以及定义基于 Protocol 的接口时启用,目标是让代码遵循 SOLID 原则并保持模块化架构。

主要能力与强制约定

  1. 智能体工作流(强制):在任何实现之前,需并行发起三个各带名称的 Agent 调用:fuse-ai-pilot:explore-codebase(分析现有架构)、fuse-ai-pilot:research-expert(通过 Context7 核查 Python 文档)、fuse-ai-pilot:sniper(实现后校验)。
  2. DRY 复用优先(强制):写任何新代码前,先在代码库中检索相似的接口、服务或逻辑,检查共享位置 core/services/ 与 core/interfaces/;若已有类似代码则扩展或复用而非重复;若代码将被两个及以上功能使用,则放入 core/。
  3. 模块化架构(强制):路由放 modules/[feature]/routes/,服务放 modules/[feature]/services/,仓储放 modules/[feature]/repositories/,接口放 modules/[feature]/interfaces/,模型放 modules/[feature]/models/,共享代码放 core/{services,interfaces,models}/;禁止使用扁平 src/ 结构,始终采用 modules/[feature]/。
  4. 关键规则(强制):单个文件行数不得超过 FUSE_SOLID_MAX_LINES;路由保持轻薄,委托给服务;接口只放在 interfaces/ 目录;每个公开函数都要有文档字符串;所有函数签名必须有类型标注;接口使用 typing.Protocol;接口保持精简,最多 1–3 个方法。

参考文档 principles.md 提供 5 条 SOLID 原则速查;patterns.md 说明目录布局、测试与类型约定。

禁止事项与修正 文件超过 FUSE_SOLID_MAX_LINES 时按职责拆分;接口写在实现文件中时移入 interfaces/ 目录;接口臃肿(4 个以上方法)时拆成小型 Protocol;使用扁平 src/ 结构时改为 modules/[feature]/;依赖具体实现时改用 Protocol 加依赖注入;缺少类型标注时补全所有签名。

适用场景 适合需要在 Python 项目中维持分层模块结构、控制文件规模、统一接口与类型规范的开发与重构工作。

限制 资料未说明该技能的安装方式、支持平台、版本要求、收费情况或实际效果,相关内容暂未提供。