220 lines
5.9 KiB
Markdown
220 lines
5.9 KiB
Markdown
# 智能自动分类指南
|
|
|
|
## 概述
|
|
|
|
技能集合现在使用智能自动分类来消除"未分类"，并根据内容将技能组织成有意义的类别。
|
|
|
|
## 当前状态
|
|
|
|
✅ 当前仓库通过生成的目录索引
|
|
- 大多数技能都在有意义的类别中
|
|
- 较小的尾部仍需要手动审查或更好的关键词覆盖
|
|
- 11 个主要类别
|
|
- 类别按技能数量排序（最多的在前）
|
|
|
|
## 类别分布
|
|
|
|
| 类别 | 数量 | 示例 |
|
|
|----------|-------|----------|
|
|
| Backend | 164 | Node.js、Django、Express、FastAPI |
|
|
| Web Development | 107 | React、Vue、Tailwind、CSS |
|
|
| Automation | 103 | Workflow、Scripting、RPA |
|
|
| DevOps | 83 | Docker、Kubernetes、CI/CD、Git |
|
|
| AI/ML | 79 | TensorFlow、PyTorch、NLP、LLM |
|
|
| Content | 47 | Documentation、SEO、Writing |
|
|
| Database | 44 | SQL、MongoDB、PostgreSQL |
|
|
| Testing | 38 | Jest、Cypress、Unit Testing |
|
|
| Security | 36 | Encryption、Authentication |
|
|
| Cloud | 33 | AWS、Azure、GCP |
|
|
| Mobile | 21 | React Native、Flutter、iOS |
|
|
| Game Dev | 15 | Unity、WebGL、3D |
|
|
| Data Science | 14 | Pandas、NumPy、Analytics |
|
|
|
|
## 工作原理
|
|
|
|
### 1. **基于关键词的分析**
|
|
系统分析技能名称和描述中的关键词:
|
|
- **Backend**: nodejs、express、fastapi、django、server、api、database
|
|
- **Web Dev**: react、vue、angular、frontend、css、html、tailwind
|
|
- **AI/ML**: ai、machine learning、tensorflow、nlp、gpt
|
|
- **DevOps**: docker、kubernetes、ci/cd、deploy
|
|
- 更多...
|
|
|
|
### 2. **优先级系统**
|
|
前置元数据类别 > 检测到的关键词 > 回退（未分类）
|
|
|
|
如果技能已经有前置元数据类别，则保留该类别。
|
|
|
|
### 3. **基于范围的匹配**
|
|
- 完全短语匹配的权重是部分匹配的 2 倍
|
|
- 使用单词边界以避免误报
|
|
|
|
## 使用自动分类
|
|
|
|
### 对未分类技能运行
|
|
```bash
|
|
python tools/scripts/auto_categorize_skills.py
|
|
```
|
|
|
|
### 首先预览更改（试运行）
|
|
```bash
|
|
python tools/scripts/auto_categorize_skills.py --dry-run
|
|
```
|
|
|
|
### 输出
|
|
```
|
|
======================================================================
|
|
AUTO-CATEGORIZATION REPORT
|
|
======================================================================
|
|
|
|
Summary:
|
|
✅ Categorized: 776
|
|
⏭️ Already categorized: 46
|
|
❌ Failed to categorize: 124
|
|
📈 Total processed: full repository
|
|
|
|
Sample changes:
|
|
• 3d-web-experience
|
|
uncategorized → web-development
|
|
• ab-test-setup
|
|
uncategorized → testing
|
|
• agent-framework-azure-ai-py
|
|
uncategorized → backend
|
|
```
|
|
|
|
## Web 应用程序改进
|
|
|
|
### 类别过滤器
|
|
**之前:**
|
|
- 包括"未分类"的无序列表
|
|
- 没有类别大小指示
|
|
|
|
**之后:**
|
|
- 类别按技能数量排序（最多的在前，"未分类"最后）
|
|
- 显示计数："Backend (164)" "Web Development (107)"
|
|
- 更易于浏览
|
|
|
|
### 示例下拉菜单
|
|
|
|
**排序顺序:**
|
|
1. All Categories
|
|
2. Backend (164)
|
|
3. Web Development (107)
|
|
4. Automation (103)
|
|
5. DevOps (83)
|
|
6. AI/ML (79)
|
|
7. ... 更多类别 ...
|
|
8. Uncategorized (126) ← 在最后
|
|
|
|
## 对于技能创建者
|
|
|
|
### 添加新技能时
|
|
|
|
在前置元数据中包含类别:
|
|
```yaml
|
|
---
|
|
name: my-skill
|
|
description: "..."
|
|
category: web-development
|
|
date_added: "2026-03-06"
|
|
---
|
|
```
|
|
|
|
### 如果您不确定
|
|
|
|
系统将在下次索引重新生成时自动分类:
|
|
```bash
|
|
python tools/scripts/generate_index.py
|
|
```
|
|
|
|
## 关键词参考
|
|
|
|
按类别可用的自动分类关键词:
|
|
|
|
**Backend**: nodejs、node.js、express、fastapi、django、flask、spring、java、python、golang、rust、server、api、rest、graphql、database、sql、mongodb
|
|
|
|
**Web Development**: react、vue、angular、html、css、javascript、typescript、frontend、tailwind、bootstrap、webpack、vite、pwa、responsive、seo
|
|
|
|
**Database**: database、sql、postgres、mysql、mongodb、firestore、redis、orm、schema
|
|
|
|
**AI/ML**: ai、machine learning、ml、tensorflow、pytorch、nlp、llm、gpt、transformer、embedding、training
|
|
|
|
**DevOps**: docker、kubernetes、ci/cd、git、jenkins、terraform、ansible、deploy、container、monitoring
|
|
|
|
**Cloud**: aws、azure、gcp、serverless、lambda、storage、cdn
|
|
|
|
**Security**: encryption、cryptography、jwt、oauth、authentication、authorization、vulnerability
|
|
|
|
**Testing**: test、jest、mocha、pytest、cypress、selenium、unit test、e2e
|
|
|
|
**Mobile**: mobile、react native、flutter、ios、android、swift、kotlin
|
|
|
|
**Automation**: automation、workflow、scripting、robot、trigger、integration
|
|
|
|
**Game Development**: game、unity、unreal、godot、threejs、2d、3d、physics
|
|
|
|
**Data Science**: data、analytics、pandas、numpy、statistics、visualization
|
|
|
|
## 自定义
|
|
|
|
### 添加自定义关键词
|
|
|
|
编辑 [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py):
|
|
|
|
```python
|
|
CATEGORY_KEYWORDS = {
|
|
'your-category': [
|
|
'keyword1', 'keyword2', 'exact phrase', 'another-keyword'
|
|
],
|
|
# ... 其他类别
|
|
}
|
|
```
|
|
|
|
然后重新运行:
|
|
```bash
|
|
python tools/scripts/auto_categorize_skills.py
|
|
python tools/scripts/generate_index.py
|
|
```
|
|
|
|
## 故障排除
|
|
|
|
### "分类失败"的技能
|
|
|
|
某些技能可能太通用或独特。您可以:
|
|
|
|
1. **在技能的前置元数据中手动设置类别**:
|
|
```yaml
|
|
category: your-chosen-category
|
|
```
|
|
|
|
2. **向 CATEGORY_KEYWORDS 配置添加关键词**
|
|
|
|
3. **移动到文件夹**（如果它适合更广泛的类别）:
|
|
```
|
|
skills/backend/my-new-skill/SKILL.md
|
|
```
|
|
|
|
### 重新生成索引
|
|
|
|
对 SKILL.md 文件进行更改后:
|
|
```bash
|
|
python tools/scripts/generate_index.py
|
|
```
|
|
|
|
这将:
|
|
- 解析前置元数据类别
|
|
- 回退到文件夹结构
|
|
- 生成新的 skills_index.json
|
|
- 复制到 apps/web-app/public/skills.json
|
|
|
|
## 后续步骤
|
|
|
|
1. **在 Web 应用程序中测试**: 尝试改进的类别过滤器
|
|
2. **添加缺失的关键词**: 如果某些技能仍未分类
|
|
3. **组织剩余的未分类技能**: 自动分配或手动审查
|
|
4. **监控增长**: 使用报告来跟踪新技能与已分类技能
|
|
|
|
---
|
|
|
|
**结果**: 更清晰的类别过滤器，具有智能、有意义的组织！🎉
|