SuperAPI AI 工具集

musubix-best-practices

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

用途:本技能指导如何应用 MUSUBIX 从 14 个以上虚拟项目实践中总结的 17 条最佳实践,适用于被问及 MUSUBIX 推荐的编码模式、设计模式或测试模式时使用。

主要能力:分为三类。代码模式 5 条:实体创建使用输入 DTO 而非多参数(BP-CODE-001);ID 采用 PREFIX-YYYYMMDD-NNN 格式以便排序追溯(BP-CODE-002);领域概念使用值对象(BP-CODE-003);值对象用接口加工厂函数而非类(BP-CODE-004);可能失败的操作使用 Result<T, E>(BP-CODE-005)。设计模式 7 条:用 Map 定义合法状态流转(BP-DESIGN-001);仓储接口异步化以便后续迁移数据库(BP-DESIGN-002);服务层使用依赖注入(BP-DESIGN-003);用 version 字段实现乐观锁检测并发编辑(BP-DESIGN-004);用 AuditService 记录数据变更(BP-DESIGN-005);提供计数重置函数以隔离测试(BP-DESIGN-006);用 expiresAt 字段表达限时实体的过期逻辑(BP-DESIGN-007)。测试模式 5 条:在 beforeEach 重置 ID 计数器(BP-TEST-001);写测试前先确认 API 签名(BP-TEST-002);为 Vitest 配置 ESM(BP-TEST-003);Result 类型需同时测试成功与失败分支(BP-TEST-004);用参数化用例覆盖全部合法与非法状态流转(BP-TEST-005)。

使用方式:可通过命令行查看,如 npx musubix learn best-practices;按类别筛选使用 --category code、--category design、--category test;仅看高置信度使用 --high-confidence。相关技能包括 musubix-code-generation、musubix-test-generation、musubix-sdd-workflow。

适用场景:在遵循 MUSUBIX 规范的项目中进行领域建模、服务设计、测试编写与代码评审时参考。

限制:资料仅给出上述模式示例与命令,未提供支持语言版本、运行环境要求、依赖安装细节或收费信息,暂未提供。