菜单
【KWC KS Controller 开发阶段 Skill】仅当 app/ks/controller/ 目录存在时激活。专注于 KingScript 脚本控制器的 .kws 元数据编写和 TypeScript/KingScript 代码实现。不负责工程创建、构建或部署（交由 kwc-project-scaffold）。涉及 KingScript 语言规范和 SDK 使用时，引用 kingscript-code-generator 技能包。若任务涉及 kd CLI、构建、部署，必须切换到 kwc-project-scaffold。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
【由 kwc-project-scaffold 调度】仅负责 LWC 组件代码编写，不直接承接用户需求，不创建文件。所有 KWC 需求和文件创建必须先经 kwc-project-scaffold。
【KWC 工程唯一入口 Skill】负责 KWC 项目的脚手架初始化、组件/页面/Controller 元数据生成、环境配置与部署。当用户请求涉及 KWC 工程创建、kd CLI 使用、.page-meta.kwp / .js-meta.kwc / .kws 元数据文件、环境部署时，必须优先使用本 Skill。本 Skill 是 KWC 工作流的总入口，框架开发 Skill（react/vue/lwc-development）仅在脚手架初始化完成后、且明确需要编写组件实现代码时才被激活。禁止在元数据操作、工程初始化、部署阶段直接使用框架开发 Skill。
【由 kwc-project-scaffold 调度】仅负责 React 组件代码编写，不直接承接用户需求，不创建文件。所有 KWC 需求和文件创建必须先经 kwc-project-scaffold。
仅适用于非 KWC 工程的通用 React 项目。KWC 工程需求必须交由 kwc-project-scaffold。
仅适用于非 KWC 工程的通用 Vue 项目。KWC 工程需求必须交由 kwc-project-scaffold。
【由 kwc-project-scaffold 调度】仅负责 Vue 组件代码编写，不直接承接用户需求，不创建文件。所有 KWC 需求和文件创建必须先经 kwc-project-scaffold。
| 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 |