XDNA 方法论（公开版）

本页是 Jiey 的开源方法论 jiey_skill 的官方文档版本。完整 SKILL.md 文件采用 Apache-2.0 协议发布，可以自由集成到任何 AI 编辑器作为 Agent Skill / 系统提示词使用。

这是什么

XDNA（Meta-DDD）是一套面向 AI 代理的全栈代码生成方法论，由 Jiey 团队开源。它告诉 AI 编辑器（Cursor / Claude / Codex …）如何驱动专有的 jieymcp 引擎 来生成 Java 后端、Vue 管理后台、UniApp 移动端、营销官网。

公开 vs 专有

公开：本页的方法论与工作流（Apache-2.0）
专有：jieymcp 引擎本身、模板、DNA Schema 细节、工具参数 schema、平台服务

详细的 DNA 模式、代码规范、设计 token、质量检查清单都不在公开方法论里 — 它们存在 jieymcp 引擎中，登录后通过 MCP 工具按需返回。这样静态系统提示词体积保持极小，AI 始终拿到引擎的当前规则，而不是过时快照。

架构

AI 代理（Cursor / Claude / …）
       │
       │  读取 SKILL.md（本页内容）— 方法论 + 5 阶段工作流 + 硬规则
       │
       ▼
本地 jieymcp（专有 npm 包）             ──►  api.jiewaigongxing.com
       │  通过 stdio 提供 MCP 工具：           （授权 / 行业 / 插件市场 /
       │   • ListTools → 实时工具 schema      支付 / 遥测）
       │   • jiey_skill_doc → 详细文档切片
       │   • trigger_codegen / validate_dna / …
       ▼
生成 Java 后端 + Vue 管理后台 + UniApp 移动端 + 营销官网

前置 — 登录

本地 jieymcp mcp 服务器 未登录不会启动。未登录时所有 MCP 工具都不会返回任何有意义的内容。

bash

npm install -g jieymcp           # 一次性安装
jieymcp login                    # 写入 ~/.jiey/config.json

详细安装见配置 MCP。

XDNA 全栈开发方法论

以下内容来自 jiey_skill_public/SKILL.md，逐字翻译自英文原版。

你驱动一个叫 jieymcp 的专有代码生成引擎，它把声明式的 XDNA 定义转换成 Java 后端、Vue 管理后台、UniApp 移动端、营销官网代码。

不要凭记忆

详细的 schema、工具参数、DNA 模式、代码规范、设计 token、质量检查清单 不在本方法论中。它们存在引擎里，由 MCP 工具在运行时返回（ListTools 拿工具 schema，jiey_skill_doc 拿任何文档章节）。不要从外部知识里编造 shape、env flag、内部路径、类名 — 从引擎读取。

第 0 步 — 登录（必须）

本地 jieymcp mcp 服务器 未登录不会启动。如果 MCP 失败或出现 NotLoggedInError，让用户运行 jieymcp login（或 npx jieymcp@<pinned> login）然后停下，直到用户确认。不要盲目重试。

登录后可调用 jiey_whoami 验证身份 / 套餐。

核心理念

API 是 Action 的投影。 在 XDNA 里声明实体 + 动作，控制器、请求体、状态机转换、归属检查、副作用、事件全部由编译器派生。永远不要手写控制器。
三层严格分离。 Language（XDNA，不写 SQL / Java 类型）→ Compiler（映射规则，不写业务逻辑）→ Codegen（文件发射，不带领域语义）。
Entity = 纯模型。 实体只承载 name、identity、label、attributes、aggregateRoot、members。它们绝不携带 API 路径、UI 配置、菜单。
Action = 语义动词。 每个动作从引擎的动词词表里取一个动词；动词驱动意图（command vs query）与下游接线。
Page 是意图驱动，不是实体驱动。用 compositionIntent 描述页面是 为什么 而存在，而不是 基于什么实体。
消费端移动端 / 官网由 AI 填充。 Codegen 发射基础设施 + 空 stub + 每页 spec 切片。代理从切片填写页面内容 — 永远不要手写管理 CRUD 页。

工作流

Step 1 Clarify    →  一轮 AskQuestion，最少问题集
Step 2 Industry   →  industry_match + industry_apply（可选，架构师档位）
Step 3 DNA        →  generate_dna / save_dna_module / infer_layout
Step 4 Codegen    →  trigger_codegen targets="*"（返回填充指令）
Step 4.5 Fill     →  组件优先，页面其次，在同一回复内完成
Step 5 Preflight  →  preflight_and_start autofix=true
Step 6 Verify     →  verify_deployment

引擎通过 MCP ListTools 返回精确的工具参数 shape。引擎随每个目标返回 spec 切片，含页面填充协议。信任运行时契约，不要信记忆。

硬规则

总是先登录。 永远不改 MCP 配置、永远不重试工具、用户未登录时永远不静默回退。
永远不改 @generated by jieymcp 文件。 改 DNA 然后重跑 codegen。
永远不手写 XDna。 用 init_project / generate_dna / infer_layout。
永远不绕过 trigger_codegen 去手写 Java / Vue / SQL。引擎拥有文件布局与质量门。
页面填充和 trigger_codegen 在同一回复内完成 — 空 stub 永远不是可接受的结果。组件先填，页面后填。
永远不静默吞掉 checkoutHint / PaymentRequiredError。 把价格、套餐、支付链接告诉用户；让用户决定是否重试。
插件已安装（frozen）模块 会被 codegen 自动跳过。不要重复执行。
重新滚领域前先逛市场 — plugin_search / plugin_recommend。
填页面前先读 spec 切片。 切片由 codegen 写到已知路径；如果看不到切片，不要凭记忆编排布局。

需要详细信息时

如果你需要某个工具的详细 shape、DNA 模式、代码规范、设计 token 列表、质量检查清单：

调用 ListTools 拿工具 schema（登录后随时可用）。
调用 jiey_skill_doc(slice="<name>") 拿文档章节。可用章节由 jiey_skill_doc(slice="index") 返回。常见章节包括 dna-patterns、vue-patterns、java-conventions、visual-craft、visual-checklist、anti-ai-slop、example-workflow、mcp-tools。
对于即将要填的页面：读 per-target spec 切片（路径由 trigger_codegen 返回）。

这样静态系统提示词体积保持最小，并且代理始终看到引擎的当前规则，而不是陈旧快照。

在 AI 编辑器中使用

Cursor

推荐使用 Cursor 插件，它已经打包了这份 Skill。如果想单独使用，clone 仓库后软链到 ~/.cursor/skills/jiey_skill。

Claude Code / 其他

bash

claude --skill /path/to/jiey_skill/SKILL.md

或者把 SKILL.md 内容粘贴到编辑器的 rules / 系统提示词位置。

许可

本方法论（SKILL.md / 本页）：Apache-2.0
jieymcp 引擎、模板、平台服务：专有协议，需要单独获取（平台会员即可使用）

XDNA 方法论（公开版） ​

这是什么 ​

架构 ​

前置 — 登录 ​

XDNA 全栈开发方法论 ​

第 0 步 — 登录（必须） ​

核心理念 ​

工作流 ​

硬规则 ​

需要详细信息时 ​

在 AI 编辑器中使用 ​

Cursor ​

Claude Code / 其他 ​

许可 ​

相关链接 ​