kingdee-dev-plugin

金蝶苍穹开发助手 — 为金蝶开发者提供 SDK 知识蒸馏、代码生成、规范检查、工作流管理等一站式开发工具。

---

核心特性

• SDK 知识蒸馏 — 36 个模块、3280 条证据标注的蒸馏知识库，让 AI 代码生成更精准
• 代码生成 — /kd:gen 一键生成表单/工作流/操作/报表插件代码
• SDK 约束生成 — kd-gen 从 SDK 文档自动生成带蒸馏知识引用的约束文件
• 5 阶段工作流 — 新建→讨论→计划→执行→验证
• 统一搜索 — 整合 SDK 文档与社区知识库 (18K+ 条目)
• 智能推荐 — 基于需求推荐 SDK 类和最佳实践
• MCP 服务 — 元数据查询和常量类生成
• 多运行时支持 — 支持 Claude Code、OpenCode、Gemini CLI、Cursor 等

---

命令总览

CLI 命令

命令	说明
install	安装到 AI 运行时
kd-gen <类名>	生成 SDK 约束文件（.prompt.md + .schema.json，含蒸馏知识）
kd-gen-constant <实体>	为实体生成常量类
kd-search <关键词>	统一搜索 SDK 和社区内容
kd-search-entity <关键词>	搜索实体
kd-recommend <需求>	智能推荐 SDK API 和最佳实践
kd-analyze <需求>	需求分析 + SDK 搜索 + 约束生成
kd-research <需求>	研究 SDK，推荐相关 API
kd-list [模块]	列出 SDK 模块和类
kd-check <文件>	规范检查
kd-setup-mcp	配置 MCP 数据库连接
kd-mcp-server	启动 MCP 服务
kd-new-project [名称]	新建项目
kd-discuss <阶段>	需求讨论
kd-plan-phase <阶段>	制定计划
kd-execute-phase <阶段>	执行开发
kd-verify <阶段>	需求校验
kd-next	自动推进到下一阶段
kd-progress	查看项目进度
kd-roadmap	查看/生成路线图
kd-new-milestone <名称>	开启新里程碑
kd-complete-milestone <版本>	完成里程碑
kd-ship	创建 PR，推送分支
kd-undo	安全回滚
kd-stats	项目统计
kd-cleanup	归档清理
kd-audit-uat	UAT 审计
kd-thread <操作>	跨会话上下文线程管理
kd-workspaces <操作>	工作空间管理
kd-debug [问题]	调试
kd-quick [任务]	快速任务执行
kd-do <描述>	自动路由命令
help	显示帮助

AI 聊天命令

在支持 Skill 的 AI 客户端（Claude Code、OpenCode）中可直接使用：

命令	说明
/kd:gen	生成金蝶插件代码（表单/工作流/操作/报表/单据）
/kd:analyze	需求分析 - 搜索 SDK + 推荐 + 约束生成
/kd:research	研究 SDK，推荐 API 和用法
/kd:list	列出 SDK 模块、类或方法
/kd:check	检查代码是否符合金蝶开发规范
/kd:discuss	需求讨论，捕获设计决策
/kd:spec	规格定义
/kd:plan-phase	制定阶段执行计划
/kd:execute-phase	执行开发阶段
/kd:verify	验证交付物
/kd:next	自动推进到下一步
/kd:distilled	加载蒸馏知识库（36 模块，3280 条证据）
/kd:init	初始化项目
/kd:doc	生成文档
/kd:template	复制开发模板
/kd:roadmap	查看路线图
/kd:ship	发布 PR
/kd:stats	查看统计
/kd:undo	回滚
/kd:cleanup	归档清理
/kd:spike	技术验证
/kd:explore	苏格拉底式构思探讨
/kd:autonomous	自主执行所有剩余阶段
/kd:mcp	MCP 服务
/kd:thread	线程管理
/kd:workspaces	工作空间管理
/kd:code-review-fix	代码审查自动修复
/kd:uat	验收验证

---

安装

# 全局安装
npm install -g kingdee-dev-plugin

# 安装到 AI 运行时
kingdee-dev-plugin install

安装后 AI 客户端即可使用 /kd:* 命令。

---

蒸馏知识库

项目内置 SDK 蒸馏知识库，覆盖 36 个金蝶苍穹核心模块：

skills/kd-distilled/
├── 36 个知识模块
│   ├── 10 个 ServiceHelper 类
│   ├── 8 个插件基类
│   ├── 6 个基础设施类
│   ├── 5 个数据实体类
│   ├── 3 个服务类
│   ├── 3 个工具类
│   └── 23 个关键事件
├── 3280 条证据（verbatim 1754 / artifact 1113 / impression 413）
└── SKILL.md（AI 加载入口）

应用场景：

• /kd:gen 代码生成时自动加载蒸馏知识
• kd-gen <类名> 生成的约束文件自动引用蒸馏最佳实践
• /kd:distilled 手动加载知识库

---

工作流

5 阶段开发流程

kd-new-project    → 新建项目
kd-discuss <N>    → 需求讨论
kd-plan-phase <N> → 制定计划
kd-execute-phase <N> → 执行开发
kd-verify <N>     → 验证交付
kd-next           → 自动推进

快速开始

# 1. 新建项目
kingdee-dev-plugin kd-new-project

# 2. 需求讨论
kingdee-dev-plugin kd-discuss 1

# 3. 生成执行计划
kingdee-dev-plugin kd-plan 1

# 4. 执行开发
kingdee-dev-plugin kd-execute 1

# 5. 验证UAT
kingdee-dev-plugin kd-verify 1

# 自动推进到下一阶段
kingdee-dev-plugin kd-next

---

项目结构

├── bin/           # CLI 入口 (cli.js + install.js)
├── lib/           # 核心库 (40+ 文件)
│   ├── kd-constraint-generator.js  # 约束生成器（含蒸馏知识集成）
│   ├── unified-search.js           # 统一搜索
│   ├── intelligent-recommender.js  # 智能推荐
│   └── ...
├── engine/        # 引擎层
│   ├── workflows/ # 14个工作流文件
│   ├── templates/ # 代码模板
│   └── scripts/assemble-distilled.js  # 合成引擎
├── skills/        # AI Skills (29个)
│   ├── kd-gen/    # 代码生成技能
│   ├── kd-distilled/  # 蒸馏知识库 ★
│   └── ...
├── sdk/           # SDK 知识库 (105模块, 783方法)
├── community/     # 社区知识库 (18K+ 条目)
├── standards/     # 金蝶开发规范 (13个文件)
├── constraints/   # SDK 约束 schema
└── tests/         # Jest 测试 (705+)

---

相关文档

• COMMANDS-GUIDE.md — 完整命令参考
• docs/DATABASE-CONFIG-GUIDE.md — 数据库配置
• docs/MCP-GUIDE.md — MCP 服务指南

---

License

MIT