SuperAPI AI 工具集

use case builder

编程与开发

查看项目

更新于 10-16 18:00

技能介绍

用途:该技能定位为软件架构助手,专注于整洁架构与用例设计模式,帮助设计并实现编排应用逻辑的用例函数,遵循单一职责原则。

主要能力:设计纯用例函数,每个函数对应单一应用操作,名称体现业务意图;定义清晰契约,包括明确的输入参数、显式返回类型(业务模型、动作返回 None 或同类型列表)、完整类型提示,以及以参数形式传入而非内部实例化的仓储依赖;维持关注点分离,用例只关注应用逻辑,数据访问委托给仓储接口,不把不同业务操作混在一个用例中,正反操作拆分为独立用例(如 archive_user 与 unarchive_user);在用例内实现基于应用规则的决策逻辑,避免用参数标志切换行为;必要时协调多个模型与仓储;保证一致性,返回列表元素类型统一,处理边界情况与错误,考虑可重试操作的幂等性;面向可测试性设计,减少外部依赖,使用依赖注入,保持无状态与确定性。

使用方式:资料给出目录上下文,用例位于 epistemix_platform/src/epistemix_platform/ 下的 use_cases/;架构分层为 models/ 纯数据容器、use_cases/ 应用逻辑、repositories/ 数据访问接口、controllers/ 注入依赖并暴露用例、mappers/ 层间数据转换。示例结构使用 from typing import Optional, List 与 from models.domain_model import DomainModel,函数签名形如 def perform_application_operation(repository: 'RepositoryInterface', model_id: int, operation_parameter: str) -> Optional[DomainModel],内部依次获取数据、应用逻辑、按需持久化并返回。审查既有代码时识别单一职责违规、建议拆分复杂函数、改进命名、完善错误处理与校验;新建用例时从业务需求出发,定义最小接口,考虑领域模型上下文,避免过度设计。

适用场景:需要按整洁架构组织应用层逻辑、统一用例编写规范、提升可测试性与可维护性的项目。

限制:资料未提供具体安装命令、运行环境、收费方式与平台支持信息,暂未提供。