TencentBlueKing

蓝鲸 MagicBox 3.0 组件专家规则

设计稿还原规则。先输出布局分析报告,再按需加载模版

TencentBlueKing 833 260 Updated 4mo ago
GitHub

Install

npx skillscat add tencentblueking/bk-bcs/magicbox-3-0

Install via the SkillsCat registry.

SKILL.md

蓝鲸 MagicBox 3.0 组件专家规则

⚠️ 绝对禁令

  1. 禁止手写布局: 严禁用 div 自创 sidebar/header/menu
  2. 强制组件化: 页面骨架 必须<bk-navigation>
  3. 禁止原生标签: 严禁 <table>, <button>,必须用 bk-table, bk-button

🔥 还原流程

Step 1: 分析设计稿 - 判断:主题深/浅色?表格/表单页?菜单有图标?

Step 2: 加载模版 (FetchMcpResource, server: user-BKUI-Knowledge)

判断结果 URI
深色侧边栏 skill://bkui-builder/assets/layouts/admin-layout-dark.vue
浅色侧边栏 skill://bkui-builder/assets/layouts/admin-layout-left.vue
表格页+Tab skill://bkui-builder/assets/pages/table-page.vue
有图标 skill://bkui-builder/references/visual-mapping.md

Step 3: 参考模版生成代码

基础结构

<bk-navigation navigation-type="left-right" need-menu default-open>
  <template #menu>
    <bk-menu :active-key="activeMenu" :opened-keys="['group-1']">
      <bk-menu-item key="home">首页</bk-menu-item>
    </bk-menu>
  </template>
</bk-navigation>

⚠️ 属性名是 opened-keys,不是 default-open-keys

Icon 导入

// ✅ 正确
import { Search, Plus, Close } from 'bkui-vue/lib/icon';
// ❌ 错误: import { Search } from '@bkui-vue/icon';

📦 更多资源

  • skill://bkui-builder/references/code-snippets.md - 代码片段
  • skill://bkui-builder/references/checklist.md - 质量检查

📦 可用资源

  • skill://bkui-builder/references/checklist.md
  • skill://bkui-builder/references/code-snippets.md
  • skill://bkui-builder/references/visual-mapping.md
  • skill://bkui-builder/assets/layouts/admin-layout-dark.vue
  • skill://bkui-builder/assets/layouts/admin-layout-left.vue
  • skill://bkui-builder/assets/layouts/admin-layout-top.vue
  • skill://bkui-builder/assets/pages/dashboard-page.vue
  • skill://bkui-builder/assets/pages/detail-page.vue
  • skill://bkui-builder/assets/pages/table-page.vue
  • skill://bkui-builder/assets/pages/wizard-form.vue

根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载