菜单
【KWC KS Controller 开发阶段 Skill】仅当 app/ks/controller/ 目录存在时激活。专注于 KingScript 脚本控制器的 .kws 元数据编写和 TypeScript/KingScript 代码实现。不负责工程创建、构建或部署（交由 kwc-project-scaffold）。涉及 KingScript 语言规范和 SDK 使用时，引用 kingscript-code-generator 技能包。若任务涉及 kd CLI、构建、部署，必须切换到 kwc-project-scaffold。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/kingdee/kwc-skills --skill kwc-ks-controller-development命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | kwc-ks-controller-development |
| description | 【KWC KS Controller 开发阶段 Skill】仅当 app/ks/controller/ 目录存在时激活。专注于 KingScript 脚本控制器的 .kws 元数据编写和 TypeScript/KingScript 代码实现。不负责工程创建、构建或部署（交由 kwc-project-scaffold）。涉及 KingScript 语言规范和 SDK 使用时，引用 kingscript-code-generator 技能包。若任务涉及 kd CLI、构建、部署，必须切换到 kwc-project-scaffold。 |
当项目中需要开发 KingScript 脚本控制器（后端 REST API）时，本 Skill 负责控制器的 .kws 元数据配置和脚本代码实现。
必须严格遵守本 Skill 目录下的 rule.md 中定义的硬性约束。
必须同时满足以下条件才能使用本 Skill：
.kd/config.json 文件app/ks/controller/ 目录kwc-project-scaffold 完成初始化以下场景必须交由 kwc-project-scaffold：
kd project init / kd project create）.js-meta.kwc / .page-meta.kwp 元数据kd env / npm run build / kd project deploy / kd debug）若当前不满足上述前置条件，请立即停止并切换到 kwc-project-scaffold Skill。
app/ks/controller/<Name>/）.kd/config.json，获取 isv、app 等字段的真实值，后续 .kws 中的 <isv>、<app>、<url> 必须基于这些值拼装，禁止猜测或硬编码meta-query-api.mjs 获取真实字段结构，禁止猜测字段名/{isv}/{app}/...），定义 HTTP 方法和权限./reference/脚本控制器防坑指南.md，确保不使用不存在的 API、不踩已知运行时陷阱；SDK 调用前先在索引中确认存在| 类别 | 资源 | 路径 |
|---|---|---|
| 本 Skill | .kws 元数据配置规范 | ./reference/kws-metadata-reference.md |
| Controller 集成工作流 | ./reference/controller-scaffold-workflow.md | |
| 常见模式和代码示例 | ./reference/controller-patterns.md | |
| 前端 adapterApi 调用指南 | ./reference/frontend-integration.md | |
| KingScript | 脚本控制器开发指南 | ../kingscript-code-generator/references/docs/custom-development/脚本控制器开发指南.md |
| 脚本控制器防坑指南 | ./reference/脚本控制器防坑指南.md | |
| 语言基础 | ../kingscript-code-generator/references/language/kingscript/README.md | |
| SDK 类索引 | ../kingscript-code-generator/references/sdk/indexes/class-index.md | |
| SDK 方法索引 | ../kingscript-code-generator/references/sdk/indexes/method-index.md | |
| SDK 场景索引 | ../kingscript-code-generator/references/sdk/indexes/scenario-index.md | |
| SDK 策略和降级链路 | ../kingscript-code-generator/references/sdk/strategy.md | |
| Java-KS 类型桥接 | ../kingscript-code-generator/references/sdk/docs/java-kingscript-bridge.md | |
| Scaffold | 实体字段查询工具 | ../kwc-project-scaffold/references/meta-query.md |