用途:在 KWC 项目已确认使用 Vue 框架后,本技能负责 Vue 组件代码的编写规范与组件使用指导,基于 Vue 3(Composition API 配合 script setup)开发。本技能仅负责代码编写,不直接承接用户需求,不创建文件;所有 KWC 需求与文件创建须先经 kwc-project-scaffold 调度。
前置条件(须同时满足):当前目录已存在 .kd/config.json;配置中 framework 字段为 vue;工程已通过 kwc-project-scaffold 完成初始化。不满足时须停止使用并切换回 kwc-project-scaffold。禁止使用本技能的场景包括:工程初始化(kd project init)、创建组件或页面(kd project create)、生成或修改 .js-meta.kwc 组件元数据、生成或修改 .page-meta.kwp 页面元数据、环境配置(kd env 相关命令)、部署(kd project deploy)、调试(kd debug,由 kwc-project-scaffold 以后台模式负责)。
主要能力与规范:统一使用 script setup,禁止 Options API;用 ref()/reactive() 管理响应式状态,禁用 this;向 Web Components 传对象/数组须用 camelCase 加 .prop 修饰符,且禁止 push/splice 原地修改,须重新赋值产生新引用;生命周期使用 onMounted/onUnmounted;模板中属性绑定 :prop、事件绑定 @sl-。组件导入示例:import '@kdcloudjs/shoelace/dist/components/input/input.js';,业务组件导入示例:import '@kdcloudjs/shoelace-biz/dist/components/lookup/lookup.js';。样式须使用 Shoelace Design Token(如 var(--sl-color-)、var(--sl-spacing-*)),禁止硬编码 hex 色值与 px 数值。
使用方式:新建组件须使用 CLI(kd project create [组件名] --type kwc),组件命名用 PascalCase,严禁手工创建文件;优先参考 app/kwc/exampleComponent;按项目入口更新 app/kwc/main* 引用;运行 npm run dev 验证。编写前须阅读并遵守本技能目录下 rule.md 的硬性约束,涉及扩展组件前须先阅读 reference/ 下对应文档。
适用场景:已初始化且框架为 Vue 的 KWC 项目中的组件开发、修改与维护。限制:不负责初始化、创建文件、元数据、环境配置、部署与调试;不得运行 ESLint/Prettier 修复命令,忽略 ESLint 格式报错。其他收费、价格、效果等信息暂未提供。