mm_ai 1.0.0

package/common/knowledge/agent/agent_collaboration_standards/knowledge.md

@@ -0,0 +1,208 @@
+# 智能体协作规范
+
+智能体间协作的通信协议、数据流转标准和协作规范。
+
+## 1. 通信协议规范
+
+### 1.1 智能体间通信方式
+
+| 通信方式 | 适用场景 | 说明 |
+|---------|---------|------|
+| call_agent | 一对一协作 | 向指定智能体发送消息，等待回复 |
+| call_agents | 一对多广播 | 同时向多个智能体发送消息，并行执行 |
+| assign_agent_work | 分配任务 | master向智能体分配具体工作 |
+
+### 1.2 消息格式规范
+
+- sender: 发送者名称（英文名）
+- receiver: 接收者名称（英文名）
+- content: 消息内容，支持Markdown格式
+- project_name: 项目名称（可选）
+- task_name: 任务名称（可选）
+- files: 文件清单（可选）
+
+### 1.3 通信原则
+
+- 不能呼叫master智能体
+- 不能呼叫当前对话的智能体
+- 消息内容清晰明确，避免歧义
+- 文件路径使用绝对路径
+
+## 2. 数据流转标准
+
+### 2.1 文件传递规范
+
+- 所有项目文件统一存放在 ./project/{project_name}/ 路径下
+- 文件路径需使用绝对路径
+- 文档类文件优先使用Markdown格式
+- 代码类文件使用对应语言的源文件格式
+
+### 2.2 数据一致性要求
+
+- 多智能体协作时，共享数据必须保持版本一致
+- 文件更新后需通知相关智能体
+- 避免多个智能体同时修改同一文件
+
+## 3. 协作流程规范
+
+### 3.1 任务发起涉及的关键环节
+
+| 环节 | 负责角色 | 说明 |
+|------|---------|------|
+| 需求分析 | master | 理解用户需求，评估工作量等级 |
+| 分级策略选择 | master | 根据工作量选择处理策略 |
+| 智能体调度 | master | 匹配合适的专业智能体执行 |
+| 进度监控 | master | 跟踪执行进度，协调资源 |
+| 质量验收 | master | 验证交付成果质量 |
+
+### 3.2 协作优先级原则
+
+- 找人优先：能委托专业智能体的任务优先委托
+- 工具其次：有现成工具的优先使用工具
+- 自己最后：以上两者都不满足时自己处理
+
+### 3.3 冲突处理
+
+- 内容冲突时，以master的协调结果为准
+- 多智能体产出冲突，升级给master协调
+- 资源竞争时，按任务优先级分配
+
+
+## 4. 角色权限对照表
+
+### 4.1 智能体角色与权限矩阵
+
+| 智能体角色 | 核心权限 | 可调用工具 | 可操作资源 | 约束边界 |
+|-----------|---------|-----------|-----------|---------|
+| master（行动指导员） | 项目决策、任务分配、质量验收 | 全部工具 | 所有项目文件 | 不直接执行技术任务 |
+| project_manager（项目经理） | 计划制定、进度跟踪、资源协调 | get_agent_*、set_task_*、call_agent | 项目文档、任务列表 | 不修改系统配置 |
+| task_manager（任务管理大师） | 任务分解、任务分配、状态跟踪 | set_task_status、assign_agent_work | 任务看板 | 不修改技能配置 |
+| skill_teacher（技能导师） | 技能创建、技能修改、技能赋予 | create_skill、set_skill、endow_skills | 技能文件、提示词文件 | 不修改系统核心配置 |
+| tool_maker（工具匠人） | 工具开发、工具维护、工具注册 | 开发工具相关 | 工具代码库 | 不修改智能体配置 |
+| hr_manager（人力资源管理师） | 智能体管理、能力评估、资源调配 | get_agent_*、set_agent_* | 智能体配置 | 不修改技能内容 |
+
+### 4.2 权限等级划分
+
+| 等级 | 描述 | 包含角色 |
+|------|------|---------|
+| L1-系统管理 | 系统级配置和决策权限 | master |
+| L2-项目管理 | 项目级管理和资源调配权限 | project_manager、hr_manager |
+| L3-专业执行 | 专业技能执行和工具使用权限 | skill_teacher、tool_maker、task_manager |
+| L4-协作参与 | 基础协作和信息获取权限 | 所有智能体 |
+
+### 4.3 敏感操作审批机制
+
+| 操作类型 | 需要审批 | 审批人 |
+|---------|---------|--------|
+| 删除已有技能 | 是 | master |
+| 修改系统核心配置 | 是 | master |
+| 删除智能体 | 是 | master |
+| 创建高风险技能 | 是 | master |
+| 修改普通技能 | 否 | skill_teacher自行决定 |
+| 创建普通工具 | 否 | tool_maker自行决定 |
+
+## 5. 异常处理机制
+
+### 5.1 异常分类与响应
+
+| 异常类型 | 典型场景 | 响应策略 | 升级条件 |
+|---------|---------|---------|---------|
+| 工具调用失败 | 工具不存在、参数错误、权限不足 | 重试1次，失败后切换备用方案 | 重试失败后通知master |
+| 文件操作异常 | 文件不存在、路径错误、权限拒绝 | 确认路径后重新操作 | 连续3次失败通知master |
+| 通信超时 | 智能体无响应、网络延迟 | 等待30秒后重试 | 重试2次仍超时通知master |
+| 数据不一致 | 版本冲突、数据丢失 | 回滚到上一个稳定版本 | 无法回滚时通知master |
+| 技能执行异常 | 技能提示词错误、依赖缺失 | 记录错误日志，尝试降级处理 | 降级失败通知master |
+
+### 5.2 异常处理路径说明
+
+| 处理阶段 | 操作内容 | 适用条件 |
+|---------|---------|---------|
+| 异常记录 | 记录异常信息到日志 | 所有异常 |
+| 类型判断 | 判断异常类型和可恢复性 | 所有异常 |
+| 自动恢复 | 执行预设的恢复策略 | 可自动恢复的异常 |
+| 恢复验证 | 验证恢复操作是否成功 | 自动恢复后 |
+| 降级处理 | 切换为备用方案继续执行 | 自动恢复成功 |
+| 升级上报 | 记录详细错误并通知master | 无法自动恢复或恢复失败 |
+| 等待指令 | 暂停当前操作，等待master协调 | 已升级上报 |
+
+### 5.3 降级处理策略
+
+| 场景 | 正常方案 | 降级方案 |
+|------|---------|---------|
+| 技能缺失 | 调用专业技能执行 | 使用基础能力手动处理 |
+| 工具不可用 | 使用专用工具 | 使用通用工具或手动替代 |
+| 数据源不可达 | 读取实时数据 | 使用缓存数据或默认值 |
+| 协作对象离线 | 请求协作智能体 | 自行处理或排队等待 |
+
+### 5.4 异常恢复检查清单
+
+- [ ] 异常是否已记录到日志
+- [ ] 是否已尝试自动恢复
+- [ ] 是否需要通知干系人
+- [ ] 数据一致性是否已验证
+- [ ] 恢复后功能是否正常
+- [ ] 是否需要总结经验形成预案
+
+## 6. 协作日志规范
+
+### 6.1 日志记录要求
+
+| 记录项 | 说明 | 格式要求 |
+|-------|------|---------|
+| 时间戳 | 事件发生时间 | YYYY-MM-DD HH:mm:ss |
+| 发起者 | 触发操作的智能体 | 英文名 |
+| 接收者 | 被操作的智能体/系统 | 英文名 |
+| 操作类型 | 执行的操作分类 | call/task/file/tool |
+| 操作内容 | 具体操作描述 | 简洁明确的文本 |
+| 执行结果 | 操作是否成功 | success/failed/partial |
+| 异常信息 | 失败时的错误详情 | 错误码+错误描述 |
+
+### 6.2 日志存储规范
+
+| 属性 | 规范 |
+|------|------|
+| 存储位置 | ./project/{project_name}/logs/ |
+| 文件命名 | {date}_{project_name}_collaboration.log |
+| 文件格式 | 纯文本（.log）或 Markdown（.md） |
+| 编码格式 | UTF-8 |
+| 日志轮转 | 按天分割，保留最近30天 |
+| 归档策略 | 月度打包压缩，保存6个月 |
+
+### 6.3 日志内容标准格式
+
+```
+[YYYY-MM-DD HH:mm:ss] [发起者] → [接收者] | [操作类型] | [操作内容] | [结果] | [异常信息]
+```
+
+日志示例：
+
+```
+[2026-07-06 10:30:00] [master] → [task_manager] | task | 分配任务"需求分析" | success | -
+[2026-07-06 10:31:00] [task_manager] → [skill_teacher] | call | 请求创建"需求分析"技能 | success | -
+[2026-07-06 10:35:00] [skill_teacher] → [tool_maker] | call | 请求开发需求分析模板工具 | failed | 工具已存在
+[2026-07-06 10:36:00] [skill_teacher] → [master] | call | 汇报：工具已存在，无需新建 | success | -
+```
+
+### 6.4 日志级别定义
+
+| 级别 | 标签 | 说明 | 示例 |
+|------|------|------|------|
+| INFO | [信息] | 常规操作记录 | 任务分配、状态变更 |
+| WARN | [警告] | 潜在问题提示 | 资源接近上限、重试操作 |
+| ERROR | [错误] | 操作失败需关注 | 工具调用失败、通信异常 |
+| CRITICAL | [严重] | 系统级严重问题 | 数据丢失、配置损坏 |
+
+### 6.5 日志分析要点
+
+- 统计各智能体的协作频率和成功率
+- 识别频繁失败的协作模式
+- 追踪异常事件的根因和恢复时间
+- 评估协作效率，优化协作流程
+- 定期生成协作质量报告
+
+### 6.6 日志安全要求
+
+- 日志中不得记录敏感信息（密码、Token、密钥等）
+- 敏感信息需脱敏处理后再记录
+- 日志文件设置合理的访问权限
+- 日志传输过程使用加密通道

package/common/knowledge/agent/agent_config_registration_standards/knowledge.json

@@ -0,0 +1,20 @@
+{
+    "name": "agent_config_registration_standards",
+    "title": "智能体配置注册规范",
+    "description": "智能体agent.json配置文件的注册规范，确保提示词文件被正确加载",
+    "prompt_file": "./knowledge.md",
+    "group": "agent",
+    "tags": [
+        "master",
+        "skill_teacher",
+        "hr_manager",
+        "agent_development"
+    ],
+    "main": "",
+    "func_name": "main",
+    "scope": "sys",
+    "sort": 10,
+    "state": 1,
+    "show": 0,
+    "end": false
+}

package/common/knowledge/agent/agent_config_registration_standards/knowledge.md

@@ -0,0 +1,95 @@
+# 智能体配置注册规范
+
+智能体 agent.json 配置文件的注册规范，确保提示词文件被正确加载。
+
+## 1. agent.json 配置文件字段说明
+
+| 字段名 | 类型 | 必填 | 说明 |
+|-------|------|------|------|
+| name | string | 是 | 智能体唯一标识（英文名，小写蛇形命名） |
+| title | string | 是 | 智能体中文标题/名称 |
+| description | string | 是 | 智能体职责描述，50字以内 |
+| group | string | 是 | 所属分组，如 master/develop/design/media/agent |
+| tags | string[] | 是 | 标签数组，用于技能匹配和知识关联 |
+| main | string | 否 | 主入口文件路径 |
+| scope | string | 否 | 作用域：sys（系统级）/ proj（项目级）/ user（用户级） |
+| sort | number | 否 | 排序权重，数值越小越靠前 |
+| state | number | 否 | 状态：1-启用，0-禁用 |
+| show | number | 否 | 是否展示：1-展示，0-隐藏 |
+| end | boolean | 否 | 是否终态：true/false |
+
+## 2. 提示词文件加载机制
+
+智能体启动时，系统会自动扫描并加载以下提示词文件（均位于智能体目录下）：
+
+| 文件名 | 加载阶段 | 作用 |
+|-------|---------|------|
+| role.md | 职责确认阶段 | 定义智能体角色定位、核心职责 |
+| soul.md | 职责确认阶段 | 定义智能体人格特质、表达风格 |
+| can.md | 能力评估阶段 | 定义智能体所能做的事情和能力清单 |
+| should.md | 能力评估阶段 | 定义智能体的行为准则和边界约束 |
+| ability.md | 能力评估阶段 | 定义智能体的专业技能和专长领域 |
+| stakeholder.md | 干系人梳理阶段 | 定义智能体的协作关系（帮谁/找谁） |
+| workflow.md | 执行干活阶段 | 定义智能体的工作流程和操作步骤 |
+
+### 2.1 加载优先级规则
+
+- 文件按上述表格顺序依次加载
+- 同名文件后加载的覆盖先加载的配置
+- 文件不存在时跳过，不影响系统启动
+- 所有文件均为可选，但建议至少配置 role.md 和 workflow.md
+
+### 2.2 提示词文件格式
+
+- 使用 Markdown 格式（.md 后缀）
+- 编码统一使用 UTF-8
+- 文件路径统一使用相对路径（相对于智能体目录）
+
+## 3. 多环境配置注意事项
+
+| 环境类型 | 配置要点 | 说明 |
+|---------|---------|------|
+| 开发环境 | debug模式 | 开启详细日志，方便排查问题 |
+| 测试环境 | 模拟数据 | 使用测试数据验证配置正确性 |
+| 生产环境 | 性能优化 | 关闭调试日志，开启缓存机制 |
+
+### 3.1 环境变量配置
+
+- 通过环境变量区分不同环境（DEV/TEST/PROD）
+- 敏感信息（API Key、Token等）通过环境变量注入
+- 文件路径根据环境自动适配
+
+### 3.2 配置继承与覆盖
+
+- 基础配置在 agent.json 中定义
+- 环境特定配置在对应环境的配置文件中定义
+- 环境配置优先级高于基础配置
+
+## 4. 配置验证和错误排查指南
+
+### 4.1 配置验证清单
+
+| 检查项 | 检查内容 | 验证方法 |
+|-------|---------|---------|
+| 名称唯一性 | name 是否与其他智能体重复 | 全局搜索检查 |
+| 文件存在性 | 引用的提示词文件是否存在 | 检查文件路径 |
+| 格式正确性 | JSON 格式是否合法 | JSON 语法校验 |
+| 字段完整性 | 必填字段是否填写完整 | 对照字段说明表 |
+| 编码一致性 | 文件编码是否为 UTF-8 | 查看文件编码 |
+
+### 4.2 常见错误及解决方案
+
+| 错误现象 | 可能原因 | 解决方案 |
+|---------|---------|---------|
+| 智能体未加载 | agent.json 格式错误 | 检查 JSON 语法，确保无多余逗号 |
+| 提示词未生效 | 文件名或路径错误 | 确认文件名与加载规则一致 |
+| 技能调用失败 | 技能名称不匹配 | 检查技能名称大小写和拼写 |
+| 标签匹配异常 | 标签不一致 | 确认知识标签与智能体标签一致 |
+| 环境配置不生效 | 环境变量未设置 | 检查环境变量是否正确注入 |
+
+### 4.3 调试建议
+
+- 首次配置时，先添加最少的必要字段，逐步扩展
+- 修改配置后重启智能体使配置生效
+- 使用日志输出确认各阶段提示词加载情况
+- 配置变更后验证核心功能是否正常

package/common/knowledge/design/color_system/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "color_system",
+  "title": "色彩体系规范",
+  "description": "UI设计的色彩体系、色板命名和配色规则。触发关键词：颜色、色彩、色板、主题色、品牌色",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "icon_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/color_system/knowledge.md

@@ -0,0 +1,65 @@
+# 色彩体系规范
+
+## 色板层级
+
+| 层级 | 说明 | 示例 |
+|:----|:-----|:-----|
+| 50 | 最浅色（背景色） | `#E3F2FD` |
+| 100 | 浅色（hover/禁用背景） | `#BBDEFB` |
+| 200 | 中浅色（选中背景） | `#90CAF9` |
+| 300 | 中间色（边框/装饰） | `#64B5F6` |
+| 400 | 中深色（次要文字） | `#42A5F5` |
+| 500 | **基准色（品牌色）** | `#2196F3` |
+| 600 | 深色（hover 状态） | `#1E88E5` |
+| 700 | 更深色（active 状态） | `#1976D2` |
+| 800 | 深色（强调文字） | `#1565C0` |
+| 900 | 最深色（标题文字） | `#0D47A1` |
+
+## 色彩分类
+
+### 品牌色（Brand Colors）
+- **Primary（主色）** — 品牌核心色彩，用于主要操作按钮、导航高亮、链接
+- **Secondary（辅色）** — 辅助品牌色，用于次要操作、标签、装饰元素
+- **Accent（强调色）** — 用于吸引注意力的高亮元素
+
+### 中性色（Neutral Colors）
+- 用于文字、背景、边框、分割线
+- 建议至少 9 级灰度（Gray 50–900）
+
+### 语义色（Semantic Colors）
+| 类型 | 色值倾向 | 用途 |
+|:----|:---------|:-----|
+| Success（成功） | 绿色系 | 成功提示、完成状态 |
+| Warning（警告） | 橙色系 | 警告提示、待处理状态 |
+| Error（错误） | 红色系 | 错误提示、失败状态 |
+| Info（信息） | 蓝色系 | 信息提示、通知 |
+
+## 色彩命名规范
+
+```
+{语义}_{层级}
+示例：primary_500, gray_100, success_50, error_700
+```
+
+## 无障碍对比度标准（WCAG 2.1）
+
+| 级别 | 普通文字 | 大文字/图标 | 装饰元素 |
+|:----|:---------|:------------|:---------|
+| AA | ≥ 4.5:1 | ≥ 3:1 | 无要求 |
+| AAA | ≥ 7:1 | ≥ 4.5:1 | 无要求 |
+
+## 暗色模式色板规则
+- 背景色：从 Gray 900+ 开始，向下取色
+- 文字色：从 Gray 50 开始，向上取色
+- 品牌色在暗色模式下可降低饱和度（-20%）
+- 语义色保持色相不变，调整明度
+
+## 主题色配置结构
+
+```json
+{
+  "brand": { "primary": "#1890FF", "secondary": "#722ED1", "accent": "#13C2C2" },
+  "neutral": { "background": "#F5F5F5", "text": "#262626", "border": "#D9D9D9" },
+  "semantic": { "success": "#52C41A", "warning": "#FAAD14", "error": "#FF4D4F", "info": "#1890FF" }
+}
+```

package/common/knowledge/design/component_spec/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "component_spec",
+  "title": "组件设计规范",
+  "description": "UI组件的设计标准、状态定义和交互规范。触发关键词：组件、按钮、输入框、表单、弹窗、组件的状态",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/component_spec/knowledge.md

@@ -0,0 +1,90 @@
+# 组件设计规范
+
+## 组件的通用状态
+
+每个交互组件必须定义以下 6 种状态：
+
+| 状态 | 说明 | 视觉变化 |
+|:----|:-----|:---------|
+| **Default** | 默认/正常状态 | 基础样式 |
+| **Hover** | 鼠标悬停 | 背景色加深 +10% / 阴影 |
+| **Active/Pressed** | 鼠标按下/触摸 | 背景色加深 +20% / 缩小 |
+| **Focus** | 键盘聚焦 | 外发光 / 边框高亮 |
+| **Disabled** | 禁用状态 | 降低不透明度至 40%–50% |
+| **Loading** | 加载中 | 显示加载指示器，禁用交互 |
+
+## 按钮规范
+
+### 按钮层级
+
+| 层级 | 视觉权重 | 使用频率 | 页面数量建议 |
+|:----|:---------|:---------|:------------|
+| **Primary（主要）** | 最高，品牌色填充 | 每个场景 1 个 | 每页 ≤ 1 个 |
+| **Secondary（次要）** | 中等，描边或浅底 | 多个 | 每页 ≤ 3 个 |
+| **Text（文字）** | 最低，仅文字 | 辅助操作 | 不限 |
+| **Danger（危险）** | 红色强调 | 删除/危险操作 | 按需 |
+
+### 按钮尺寸
+
+| 尺寸 | 高度 | 水平内边距 | 字号 | 适用场景 |
+|:----|:----|:----------|:----|:---------|
+| XL | 48px | 24px | 16px | 全屏宽度/大操作 |
+| LG | 40px | 20px | 15px | 表单主要操作 |
+| MD | 32px | 16px | 14px | **默认尺寸** |
+| SM | 28px | 12px | 12px | 表格/密集操作 |
+| XS | 24px | 8px | 12px | 工具条/标签操作 |
+
+### 禁用场景规则
+- 主要操作按钮禁用时，需提供 Tooltip 说明原因
+- 危险操作需二次确认（弹窗或撤销机制）
+
+## 输入框规范
+
+| 属性 | 标准值 |
+|:----|:-------|
+| 高度 | 32px（MD） |
+| 水平内边距 | 12px |
+| 边框色 | `color-neutral-border` |
+| 聚焦边框色 | `color-brand-primary` |
+| 错误边框色 | `color-semantic-error` |
+| 占位文字色 | `color-neutral-text-placeholder` |
+| 圆角 | `radius-sm`（4px） |
+| 标签位置 | 上方（默认）/ 左对齐 |
+
+### 输入框反馈状态
+
+| 状态 | 视觉反馈 | 提示文字 |
+|:----|:---------|:---------|
+| Normal | 默认边框 | 无 |
+| Focus | 蓝色边框 + 阴影 | 无 |
+| Error | 红色边框 + 红色阴影 | 错误原因 |
+| Success | 绿色边框 + 勾选图标 | 可选 |
+| Warning | 橙色边框 | 警告说明 |
+| Disabled | 灰色背景 50% 不透明度 | 无 |
+
+## 模态框规范
+
+| 属性 | 标准值 |
+|:----|:-------|
+| 遮罩色 | rgba(0, 0, 0, 45%) |
+| 内边距 | 24px |
+| 圆角 | `radius-lg`（16px） |
+| 关闭方式 | 点击遮罩（可配置）、点击 X、按 ESC |
+| 标题栏 | 16px Bold |
+| 底部操作栏 | 右对齐按钮 |
+
+### 模态框尺寸
+
+| 尺寸 | 宽度 | 适用内容 |
+|:----|:----|:---------|
+| SM | 420px | 确认/提示 |
+| MD | 520px | 表单编辑 |
+| LG | 720px | 复杂表单/详情 |
+| XL | 960px | 全功能/多标签 |
+
+## 组件命名规范
+
+```
+{组件名}-{变体}-{状态}-{朝向?}
+示例：btn-primary-hover, input-error, modal-lg
+```

package/common/knowledge/design/design_tokens/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "design_tokens",
+  "title": "设计令牌命名规范",
+  "description": "设计系统中设计令牌（Design Tokens）的命名、分类和组织规范。触发关键词：设计令牌、token、设计变量、设计系统",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/design_tokens/knowledge.md

@@ -0,0 +1,109 @@
+# 设计令牌命名规范
+
+## 命名语法
+
+```
+{类型}-{分类}-{属性}-{状态?}
+```
+
+| 分段 | 说明 | 示例值 |
+|:----|:-----|:-------|
+| 类型 | 令牌大类 | `color`, `size`, `space`, `font`, `shadow`, `radius`, `opacity`, `z` |
+| 分类 | 所属分类 | `brand`, `neutral`, `semantic`, `heading`, `body` |
+| 属性 | 具体属性 | `primary`, `background`, `text`, `border`, `hover` |
+| 状态（可选） | 交互状态 | `hover`, `active`, `disabled`, `focus`, `error` |
+
+## 类型对照表
+
+### 色彩令牌（color-*）
+
+```
+color-brand-primary              // 品牌主色
+color-brand-primary-hover        // 品牌主色悬停
+color-brand-primary-active       // 品牌主色按下
+color-neutral-background         // 页面背景色
+color-neutral-text-primary       // 主要文字色
+color-neutral-text-secondary     // 次要文字色
+color-neutral-border             // 边框色
+color-semantic-success           // 成功色
+color-semantic-error             // 错误色
+color-semantic-warning           // 警告色
+color-semantic-info              // 信息色
+```
+
+### 间距令牌（space-*）
+
+```
+space-padding-xs                 // 极小内边距（4px）
+space-padding-sm                 // 小内边距（8px）
+space-padding-md                 // 中内边距（16px）
+space-padding-lg                 // 大内边距（24px）
+space-margin-xs                  // 极小外边距
+space-margin-sm                  // 小外边距
+space-margin-md                  // 中外边距
+space-gap-column                 // 列间距
+space-gap-row                    // 行间距
+```
+
+### 字体令牌（font-*）
+
+```
+font-family-sans                 // 无衬线字体栈
+font-family-mono                 // 等宽字体栈
+font-size-h1                     // H1 字号
+font-size-body                   // 正文字号
+font-weight-regular              // 常规字重
+font-weight-bold                 // 加粗字重
+font-lineHeight-body             // 正文行高
+font-letterSpacing                // 字间距
+```
+
+### 尺寸令牌（size-*）
+
+```
+size-icon-xs                     // 迷你图标（12px）
+size-icon-sm                     // 小图标（16px）
+size-icon-md                     // 常规图标（24px）
+size-icon-lg                     // 大图标（32px）
+size-button-min-height           // 按钮最小高度
+size-input-height                // 输入框高度
+```
+
+### 圆角令牌（radius-*）
+
+```
+radius-none                      // 无圆角（0）
+radius-sm                        // 小圆角（4px）
+radius-md                        // 中圆角（8px）
+radius-lg                        // 大圆角（16px）
+radius-round                     // 圆形（50%）
+```
+
+### 阴影令牌（shadow-*）
+
+```
+shadow-none                      // 无阴影
+shadow-sm                        // 小阴影（卡片）
+shadow-md                        // 中阴影（下拉菜单）
+shadow-lg                        // 大阴影（模态框）
+shadow-xl                        // 特大阴影（通知）
+```
+
+## 平台映射
+
+```json
+{
+  "color-brand-primary": {
+    "css": "var(--color-brand-primary)",
+    "scss": "$color-brand-primary",
+    "figma": "Color / Brand / Primary",
+    "ios": "UIColor.brandPrimary",
+    "android": "@color/brand_primary"
+  }
+}
+```
+
+## 禁止行为
+- 禁止在代码中硬编码色值/尺寸（必须使用 Token）
+- 禁止 Token 命名出现具体像素值
+- 禁止混用不同语义的同类型 Token

package/common/knowledge/design/responsive_breakpoints/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "responsive_breakpoints",
+  "title": "响应式断点规范",
+  "description": "UI设计的响应式断点、设备适配和布局策略。触发关键词：响应式、断点、自适应、移动适配、屏幕尺寸",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "frontend_layout", "product_design", "h5_design"]
+}