القائمة
本体模型服务平台开发最佳实践 — 文档闭环、Spec原子化、层级分工、测试策略、Worklog规范
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ontology-platform-best-practices |
| description | 本体模型服务平台开发最佳实践 — 文档闭环、Spec原子化、层级分工、测试策略、Worklog规范 |
| version | 1.0.0 |
| tags | ["ddd","spec-driven","spring-boot","mcp","java","nodejs"] |
US → PRD → Spec → Task → Test → Worklog
ontology-api/ Controller, DTO, 配置
ontology-application/ Service 接口+实现
ontology-domain/ Entity, Repository接口, Value Object
ontology-infrastructure/ Repository实现, MyBatis Mapper, Flyway
| 模块 | 端口 | 技术 |
|---|---|---|
| Spring Boot | :8080 | Java 25, DDD |
| MCP Server | :3001 | Node.js 22, Express, JSON-RPC 2.0 |
| 层 | 框架 | 测试什么 |
|---|---|---|
| Domain Unit | JUnit 5 + Mockito | 业务规则 |
| Controller | MockMvc | 契约测试 |
| Repository IT | Testcontainers | 真实 PG+AGE |
| MCP Unit | Vitest | Tool 逻辑+RBAC |
| MCP HTTP E2E | Vitest + Express | JSON-RPC 2.0 全链路 |
.hermes/ 计划 + User Stories
docs/shared/ PRD, TDD, API契约, 故事地图
docs/superpowers/specs/ 技术 Spec (版本化)
mcp-server/ Node.js 独立项目
WORKLOG-YYYY-MM-DD.md 变更日志 (根目录)
| 坑 | 症状 | 解法 |
|---|---|---|
| 审核产物隔离 | .trae/ 下有 review spec，主Spec还是旧的 | 审核结论直接合并进主Spec |
| 工作量不量化 | 只说"完成了" | 每阶段记 +N/-M 文件数 |
| 文档分散无索引 | 找不到对应文档 | 用 docs/README.md 做索引 |