用途:在 Python 项目中按既有 CQRS 模式创建命令处理器(写操作)或查询处理器(读操作),实现写读分离、ServiceResult 返回约定与依赖注入。适用于新增用例、添加功能、创建 API 端点或构建应用层逻辑。
主要能力:区分命令与查询;创建命令/查询请求对象(dataclass,继承 Command 或 Query);编写处理器(命令返回 ServiceResult[None],查询返回 ServiceResult[TResult]);查询结果可创建 DTO 并在其中提供 to_dict 与 from_entity;在 DI 容器注册处理器;接入 MCP 工具;另提供模板(templates/command_handler.py、templates/query_handler.py)、参考文档、要求清单,以及生成处理器、列出手处理器、校验 CQRS 分离的辅助脚本。
使用方式:先判断写入用 Command、只读用 Query;再建请求对象;实现处理器,构造函数校验依赖并注入,使用 @traced 与 get_logger(name);查询需 DTO;随后在 src/{{PROJECT_NAME}}/interfaces/mcp/container.py 注册 providers.Singleton,并在 server.py 用 @mcp.tool() 接线。所有处理器与请求对象须继承对应基类,返回类型始终为 ServiceResult[T]。
限制:具体项目名称、路径、命令与价格等信息暂未提供;该技能面向特定项目模式,非通用框架。