Ontology Driven Dev — Development skill for Claude Code

ontology-driven-dev

一套「需求探索 → 本体建模 → 应用构建」三步法的**本体驱动业务系统开发技能**。 基于七模型本体 YAML（M1/M2/M3/M5/M6/M7/MU）与内置 `code-paas` 技术底座，强制每个需求探索阶段人工确认，最终产出**严格对齐需求文档、本体模型与代码**的可运行浏览器前后端（BS）系统。

[English version → README_EN.md](./README_EN.md)

---

一、这个技能能做什么

把一段业务需求（一句话或一段描述）变成一套**可运行的管理系统**，且保证：

• 需求可追溯：每个功能都能回溯到需求文档的某个条目；
• 模型即语义来源：数据库表、接口、菜单、权限、流程、规则全部由七模型 YAML 生成，杜绝"模型一套、代码一套"；
• 人工门禁不可跳过：需求探索的 8 个阶段，每一阶段都必须暂停等人确认后才推进；
• 开箱即用的技术底座：内置 code-paas（Flask + SQLite + React/TS 单体应用，含系统管理、流程引擎、工作台、本体注册表），复制即可扩展；
• 强制 AI 对话框：生成的应用右侧自带 AI 对话（本体注册表注入 + 工具调用 + SSE 流式 + 只读 SQL 安全边界）。

---

二、包含内容

ontology-driven-dev/
├── SKILL.md                      # 技能核心指令（方法论 + 三阶段管线 + 纪律）
├── references/                   # 5 份方法论文档（强制规范）
│   ├── AI需求探索与确认提示词V9.0.md      # 含《软件需求编写规范 V9.0》全文
│   ├── ontology_modeling_framework_v9.md  # 七模型元规范 + YAML 模板
│   ├── 本体模型业务功能开发指导书.md        # 模型→实现映射、开发流水线 10 步
│   ├── AI原生应用技术架构设计文档.md        # 技术栈 / 语义注册表 / AI 编排 / SSE
│   └── UI-UE界面设计规范.md               # 配色 token / 布局 / 完整 CSS 库
├── reference-example/            # 黄金范例（销售合同执行管理跑通实物）
│   ├── 合同管理需求规格说明书-V9.md
│   ├── m1-object-model.yaml … m7-report-model.yaml + mu-ui-model.yaml
│   └── manifest.json
├── techbase/                     # code-paas 干净源码（复制到 code-app 后扩展）
    ├── backend/                  # Flask + SQLite 后端（流程引擎 / 本体注册表 / 服务层）
    ├── frontend/                 # React + TypeScript 前端（Vite）
    ├── models/                   # 示例七模型 YAML（正式使用时替换为你的模型）
    ├── requirements.txt
    └── README.md                 # 底座运行说明
└── code-app-example/             # 基于七模型生成的销售合同执行管理完整应用样例
    ├── models/                   # 合同领域七模型 YAML + manifest
    ├── backend/                  # 业务服务、流程、报表、AI 助手及测试数据库
    ├── frontend/                 # 合同、开票、收款、审批及报表页面
    └── README.md                 # 样例功能、账号、启动与自测说明

完整应用样例

`code-app-example/` 展示了从需求规格、七模型本体到可运行系统的完整落地结果。样例业务为销售合同执行管理，覆盖合同登记与分级审批、开票审批、收款及冲销、跨对象状态联动、固定报表、系统管理和右侧 AI 智能助理。

样例自带 SQLite 测试数据和默认测试账号