# 技能/工作/常识提示词命名规范、分组分类和路径规范

## 1. 通用命名原则

| 原则 | 说明 | ✅ 正确 | ❌ 错误 |
|:-----|:------|:---------|:---------|
| **小写蛇形** | 全小写，单词间用下划线连接 | `skill_analysis` | `SkillAnalysis` |
| **语义清晰** | 名称能体现用途，避免过于泛化 | `svg_graphic_drawing` | `draw` |
| **动词+名词** | 用"做什么"的结构 | `create_skill` | `skill_create_func` |
| **避免冗余后缀** | 不加 `_skill` `_work` `_knowledge` 后缀 | `innovation_skill`（历史遗留） | 新技能不加后缀 |
| **层级有序** | 从通用到具体 | `frontend_vue_component` | `component_vue_frontend` |

## 2. 技能（Skill）命名规范

### 2.1 名称规则
| 规则 | 说明 | 示例 |
|:-----|:------|:------|
| 格式 | `{动作}_{领域}_{具体对象}` | `write_skill_prompt` |
| 动作词 | create/write/read/design/develop/analyze/optimize/test | |
| 领域词 | skill/agent/ui/api/data/image/audio/video | |
| 长度 | 不超过40个字符 | |

### 2.2 分组分类

| 分组 | 说明 | 路径 | 示例技能 |
|:-----|:------|:------|:----------|
| `agent` | 智能体核心技能 | `./skill/agent/` | `innovation_skill`, `write_prompt` |
| `plan` | 规划分析类 | `./skill/plan/` | `skill_analysis`, `training_planning` |
| `design` | 设计类 | `./skill/design/` | `ui_design`, `svg_graphic_drawing` |
| `develop` | 开发类 | `./skill/develop/` | `frontend_development`, `vue_development` |
| `media` | 多媒体类 | `./skill/media/` | `audio_creation`, `video_editing` |

### 2.3 文件路径规范
```
./skill/{group}/{name}/
├── skill.md      # 技能提示词主体
└── skill.json    # 技能配置文件
```

## 3. 做事提示词（Work）命名规范

### 3.1 名称规则
| 规则 | 说明 | 示例 |
|:-----|:------|:------|
| 格式 | `{动作}_{对象}` 或 `{领域}_{动作}` | `write_skill_prompt`, `skill_quality_check` |
| 动作词 | write/create/check/test/design/develop/analyze | |
| 长度 | 不超过40个字符 | |

### 3.2 分组分类

| 分组 | 说明 | 路径 | 示例 |
|:-----|:------|:------|:------|
| `agent` | 智能体相关 | `./work/agent/` | `write_skill_prompt`, `skill_quality_check` |
| `develop` | 开发流程 | `./work/develop/` | `database_design`, `api_design` |
| `design` | 设计流程 | `./work/design/` | `ui_design`, `character_design` |
| `plan` | 规划流程 | `./work/plan/` | `hr_planning`, `task_planning` |
| `media` | 多媒体流程 | `./work/media/` | `audio_editing`, `video_editing` |
| `mm` | 框架开发 | `./work/mm/` | `develop_mm_api`, `config_mm_plugin` |

### 3.3 文件路径规范
```
./work/{group}/{name}/
├── prompt/
│   ├── rule.md      # 规则文档
│   ├── method.md    # 方法文档
│   └── trick.md     # 技巧文档
└── work.json        # 工作配置
```

## 4. 常识知识（Knowledge）命名规范

### 4.1 名称规则
| 规则 | 说明 | 示例 |
|:-----|:------|:------|
| 格式 | `{领域}_{规范名}` 或 `{对象}_{规则}` | `color_system`, `naming_conventions` |
| 内容相关 | 名称反映知识内容 | `svg_standards` ✅ / `knowledge1` ❌ |
| 长度 | 不超过40个字符 | |

### 4.2 分组分类

| 分组 | 说明 | 路径 | 示例 |
|:-----|:------|:------|:------|
| `design` | 设计类规范 | `./knowledge/design/` | `color_system`, `typography` |
| `develop` | 开发类规范 | `./knowledge/develop/` | `naming_conventions` |
| `media` | 多媒体类规范 | `./knowledge/media/` | `media_format_standards` |
| `mm` | 框架类规范 | `./knowledge/mm/` | `data_query_syntax`, `template_syntax` |
| `prompt_engineering` | 提示词工程规范 | `./knowledge/prompt_engineering/` | `skill_prompt_standards` |

### 4.3 文件路径规范
```
./knowledge/{group}/{name}/
├── knowledge.md    # 常识知识主体
└── knowledge.json  # 常识知识配置
```

## 5. 标签（tags）关联规范

| 标签类型 | 格式 | 示例 |
|:---------|:------|:------|
| 技能标签 | 使用技能名称 | `innovation_skill`, `svg_graphic_drawing` |
| 领域标签 | 使用领域英文名 | `ui_design`, `backend_dev`, `frontend_dev` |
| 智能体标签 | 使用智能体名称 | `skill_teacher`, `tool_maker` |
| 专项标签 | 使用专项名称 | `prompt_engineering`, `mm_development` |

**标签匹配规则**：一个常识知识的标签命中某个技能的标签时，该技能即可引用该常识知识。