WorkBuddy AppBuilderSkill — Development skill for Claude Code

WorkBuddy App Builder Skill

[简体中文](README.md) | [English](README_EN.md)

一个面向 WorkBuddy 的本体驱动应用构建技能。它从一段业务想法或需求文档出发，通过多轮需求探索和人工确认，建立十一类领域本体模型，并生成一个可安装、可运行、自包含的新领域技能。

生成的领域技能不是只有一组提示词。它同时包含完整需求文档、本体 YAML/JSON、SQLite 数据库运行引擎、REST API、对象录入表单、自然语言查询能力和离线知识图谱。

技能内部名称为 `ontology-app-builder`。安装时请使用这个目录名，因为当前技能说明中的工具路径以 `~/.workbuddy/skills/ontology-app-builder/` 为基准。

它解决什么问题

传统的业务应用建设通常需要依次完成需求访谈、领域分析、数据建模、接口设计、表单开发、数据库开发和查询开发。本项目把这些工作组织成一条由 WorkBuddy 执行、由用户在关键节点确认的生成流水线：

flowchart LR
    A[业务想法或需求文档] --> B[九阶段需求探索]
    B --> C{用户确认}
    C --> D[十一模型本体建模]
    D --> E[YAML 转 JSON]
    E --> F[知识图谱生成]
    F --> G{用户确认}
    G --> H[生成领域技能]
    H --> I[SQLite + REST API]
    H --> J[独立 HTML 表单]
    H --> K[自然语言查询]
    H --> L[需求文档与本体图谱]

核心目标是让业务判断保持可追溯、可确认，同时让最终产物可以直接运行，而不是停留在需求文档或模型文件阶段。

核心能力

• 交互式需求探索：严格按九个阶段逐步澄清范围、对象、功能、规则、事件、流程、报表、角色、接口和可选 UI 原型。
• 人工确认门禁：所有需要业务判断的内容都会停下来确认；需求未清零前不生成本体，模型未确认前不生成领域技能。
• 十一模型建模：生成 M1~M7、ME、MU、MM、MI 十一类标准 YAML 模型。
• 自包含领域技能：将需求文档、本体、运行引擎、表单和知识图谱打包到新的 WorkBuddy 技能目录。
• 本体驱动建库：运行时读取 M1 JSON，自动创建 SQLite 主表、子表和数据字典表。
• 通用 CRUD API：按聚合根提供新增、列表、按 ID 修改和删除/作废能力。
• 独立录入表单：为每个聚合根生成独立 HTML，支持数据字典、对象引用、枚举、自动编号和一层主从明细。
• 自然语言查询：WorkBuddy 根据模型元数据把自然语言转换成只读 SQL，再通过本地 API 执行。
• 离线知识图谱：将本体节点和关系输出为自包含 ECharts HTML，无需联网即可查看。
• 零第三方运行时依赖：生成后的领域技能只使用 Python 标准库和内置 SQLite。

十一模型

模型	文件	作用
M1 对象模型	m1-object-model.yaml	聚合根、子实体、值对象、属性、数据字典、关联、不变量；当前运行时建库的权威来源
M2 行为模型	m2-behavior-model.yaml	对象原子行为和查询行为
M3 规则模型	m3-rule-model.yaml	跨对象、事件驱动或可复用规则
ME 事件模型	me-event-model.yaml	领域事件、生产者、订阅者和载荷
M4 场景模型	m4-scenario-model.yaml	跨对象事件协同场景
M5 主体模型	m5-actor-model.yaml	参与者、角色和权限
M6 流程模型	m6-flow-model.yaml	端到端协同流和可选审批流
M7 查询报表模型	m7-report-model.yaml	查询、统计、固定报表和参考 SQL
MU UI 模型	mu-ui-model.yaml	屏幕、元素、导航、UI 事件和调用链
MM 映射模型	m-mapping-model.yaml	对象、表、列和外键的显式映射
MI 接口模型	`mi-interface-