@tinkcarlos/skillora 0.2.0

package/.claude/skills/skill-expert-skills/references/domain-knowledge-template.md

@@ -0,0 +1,503 @@
+# 领域知识库模板 (Domain Knowledge Template)
+
+> 本文档提供创建和维护领域知识库的标准模板。每个领域应有独立的知识库文件。
+
+---
+
+## 目录
+
+- [1. 知识库文件结构](#1-知识库文件结构)
+- [2. 知识库模板](#2-知识库模板)
+- [3. 知识条目模板](#3-知识条目模板)
+- [4. 常见领域知识库示例](#4-常见领域知识库示例)
+- [5. 知识库维护规范](#5-知识库维护规范)
+
+---
+
+## 1. 知识库文件结构
+
+### 1.1 目录结构
+
+```
+skill-expert-skills/
+├── references/
+│   ├── domain-knowledge/           ← 领域知识库目录
+│   │   ├── _index.md               ← 知识库索引
+│   │   ├── frontend-expertise.md   ← 前端领域
+│   │   ├── backend-expertise.md    ← 后端领域
+│   │   ├── database-expertise.md   ← 数据库领域
+│   │   ├── security-expertise.md   ← 安全领域
+│   │   ├── devops-expertise.md     ← DevOps 领域
+│   │   ├── api-design-expertise.md ← API 设计领域
+│   │   └── [domain]-expertise.md   ← 其他领域
+│   └── research-logs/              ← 研究日志目录
+│       ├── _index.md               ← 研究日志索引
+│       └── YYYY-MM-DD-[topic].md   ← 具体研究记录
+```
+
+### 1.2 命名规范
+
+| 类型 | 命名格式 | 示例 |
+|------|----------|------|
+| 领域知识库 | `[domain]-expertise.md` | `frontend-expertise.md` |
+| 研究日志 | `YYYY-MM-DD-[topic].md` | `2024-01-15-code-review.md` |
+| 索引文件 | `_index.md` | `_index.md` |
+
+---
+
+## 2. 知识库模板
+
+### 2.1 完整知识库模板
+
+```markdown
+# [领域名称] 专家知识库
+
+> 最后更新: YYYY-MM-DD | 知识条目数: N | 覆盖深度: 第 X 层
+
+---
+
+## 目录
+
+- [1. 领域概述](#1-领域概述)
+- [2. 核心概念](#2-核心概念)
+- [3. 最佳实践](#3-最佳实践)
+- [4. 常见陷阱](#4-常见陷阱)
+- [5. 高级话题](#5-高级话题)
+- [6. 工具与资源](#6-工具与资源)
+- [7. 参考来源](#7-参考来源)
+
+---
+
+## 1. 领域概述
+
+### 1.1 定义
+[领域的官方/权威定义]
+
+### 1.2 范围
+- 包含: [...]
+- 不包含: [...]
+
+### 1.3 核心价值
+[为什么这个领域重要]
+
+---
+
+## 2. 核心概念
+
+### 2.1 [概念名称]
+
+**定义**: [简洁定义]
+
+**关键要点**:
+- 要点 1
+- 要点 2
+- 要点 3
+
+**示例**:
+```[language]
+// 代码示例
+```
+
+**来源**: [URL] (YYYY-MM-DD)
+
+### 2.2 [概念名称]
+...
+
+---
+
+## 3. 最佳实践
+
+### 3.1 [实践名称]
+
+**场景**: [何时使用]
+
+**做法**:
+1. 步骤 1
+2. 步骤 2
+3. 步骤 3
+
+**示例**:
+```[language]
+// 代码示例
+```
+
+**反例**:
+```[language]
+// 错误示例
+```
+
+**来源**: [URL] (YYYY-MM-DD)
+
+### 3.2 [实践名称]
+...
+
+---
+
+## 4. 常见陷阱
+
+### 4.1 [陷阱名称]
+
+**问题描述**: [什么问题]
+
+**根因**: [为什么会发生]
+
+**检测方法**:
+- 方法 1
+- 方法 2
+
+**预防措施**:
+- 措施 1
+- 措施 2
+
+**修复方法**:
+```[language]
+// 修复代码
+```
+
+**来源**: [URL] (YYYY-MM-DD)
+
+### 4.2 [陷阱名称]
+...
+
+---
+
+## 5. 高级话题
+
+### 5.1 [话题名称]
+
+**背景**: [为什么需要了解]
+
+**核心内容**:
+- 内容 1
+- 内容 2
+
+**权衡取舍**:
+| 方案 | 优点 | 缺点 | 适用场景 |
+|------|------|------|----------|
+| A | ... | ... | ... |
+| B | ... | ... | ... |
+
+**来源**: [URL] (YYYY-MM-DD)
+
+### 5.2 [话题名称]
+...
+
+---
+
+## 6. 工具与资源
+
+### 6.1 必备工具
+
+| 工具 | 用途 | 链接 |
+|------|------|------|
+| [工具名] | [用途] | [URL] |
+
+### 6.2 推荐资源
+
+| 类型 | 名称 | 链接 | 说明 |
+|------|------|------|------|
+| 官方文档 | [名称] | [URL] | [说明] |
+| 书籍 | [名称] | [URL] | [说明] |
+| 课程 | [名称] | [URL] | [说明] |
+
+---
+
+## 7. 参考来源
+
+### 7.1 官方来源
+- [来源名称](URL) - 检索日期: YYYY-MM-DD
+
+### 7.2 权威博客
+- [来源名称](URL) - 检索日期: YYYY-MM-DD
+
+### 7.3 学术资料
+- [来源名称](URL) - 检索日期: YYYY-MM-DD
+
+### 7.4 社区资源
+- [来源名称](URL) - 检索日期: YYYY-MM-DD
+```
+
+---
+
+## 3. 知识条目模板
+
+### 3.1 概念类条目
+
+```markdown
+### [概念名称]
+
+**定义**: [一句话定义]
+
+**关键要点**:
+- 要点 1
+- 要点 2
+- 要点 3
+
+**与相关概念的区别**:
+| 概念 | 区别 |
+|------|------|
+| [相关概念 A] | [区别说明] |
+| [相关概念 B] | [区别说明] |
+
+**示例**:
+```[language]
+// 代码示例
+```
+
+**来源**: [URL] (YYYY-MM-DD)
+```
+
+### 3.2 实践类条目
+
+```markdown
+### [实践名称]
+
+**场景**: [何时使用这个实践]
+
+**前提条件**:
+- 条件 1
+- 条件 2
+
+**步骤**:
+1. [步骤 1]
+2. [步骤 2]
+3. [步骤 3]
+
+**正确示例**:
+```[language]
+// 正确代码
+```
+
+**错误示例**:
+```[language]
+// 错误代码 - 说明为什么错误
+```
+
+**验证方法**:
+```bash
+# 验证命令
+```
+
+**来源**: [URL] (YYYY-MM-DD)
+```
+
+### 3.3 陷阱类条目
+
+```markdown
+### [陷阱名称]
+
+**严重级别**: P0/P1/P2/P3
+
+**问题描述**: [什么问题，有什么影响]
+
+**根因分析**: [为什么会发生]
+
+**触发条件**:
+- 条件 1
+- 条件 2
+
+**检测方法**:
+| 方法 | 命令/工具 | 预期结果 |
+|------|-----------|----------|
+| [方法 1] | `[命令]` | [结果] |
+
+**预防措施**:
+- [ ] 措施 1
+- [ ] 措施 2
+
+**修复方法**:
+```[language]
+// 修复前
+[错误代码]
+
+// 修复后
+[正确代码]
+```
+
+**真实案例**: [可选，描述真实发生的案例]
+
+**来源**: [URL] (YYYY-MM-DD)
+```
+
+### 3.4 工具类条目
+
+```markdown
+### [工具名称]
+
+**用途**: [一句话说明用途]
+
+**安装**:
+```bash
+# 安装命令
+```
+
+**基本用法**:
+```bash
+# 基本命令
+```
+
+**常用选项**:
+| 选项 | 说明 | 示例 |
+|------|------|------|
+| `-x` | [说明] | `command -x value` |
+
+**最佳实践**:
+- 实践 1
+- 实践 2
+
+**常见问题**:
+| 问题 | 解决方案 |
+|------|----------|
+| [问题 1] | [解决方案] |
+
+**官方文档**: [URL]
+```
+
+---
+
+## 4. 常见领域知识库示例
+
+### 4.1 前端领域知识库结构
+
+```markdown
+# 前端专家知识库
+
+## 核心概念
+- 组件化设计
+- 状态管理
+- 响应式设计
+- 可访问性 (a11y)
+
+## 最佳实践
+- 组件设计原则
+- 性能优化
+- 错误处理
+- 测试策略
+
+## 常见陷阱
+- 闭包陷阱
+- useEffect 依赖问题
+- 状态更新竞态
+- 内存泄漏
+
+## 高级话题
+- SSR/SSG
+- 微前端
+- 性能监控
+```
+
+### 4.2 后端领域知识库结构
+
+```markdown
+# 后端专家知识库
+
+## 核心概念
+- RESTful API 设计
+- 数据库事务
+- 并发控制
+- 缓存策略
+
+## 最佳实践
+- 输入验证
+- 错误处理
+- 日志记录
+- 安全防护
+
+## 常见陷阱
+- N+1 查询
+- 竞态条件
+- 连接泄漏
+- SQL 注入
+
+## 高级话题
+- 分布式系统
+- 消息队列
+- 服务网格
+```
+
+---
+
+## 5. 知识库维护规范
+
+### 5.1 更新触发条件
+
+| 触发条件 | 更新动作 |
+|----------|----------|
+| 创建/优化新 Skill | 补充相关领域知识 |
+| 发现知识遗漏 | 补充遗漏的知识点 |
+| 技术版本更新 | 验证并更新过时内容 |
+| 用户反馈问题 | 补充陷阱和解决方案 |
+| 定期审查（季度） | 全面检查时效性 |
+
+### 5.2 更新流程
+
+```
+1. 识别需要更新的内容
+       ↓
+2. 联网研究获取最新信息
+       ↓
+3. 交叉验证新信息
+       ↓
+4. 按模板格式更新知识库
+       ↓
+5. 更新"最后更新"日期
+       ↓
+6. 更新索引文件（如有新条目）
+```
+
+### 5.3 质量检查清单
+
+```markdown
+## 知识库质量检查
+
+### 完整性
+- [ ] 核心概念覆盖完整
+- [ ] 最佳实践有 5+ 条
+- [ ] 常见陷阱有 5+ 条
+- [ ] 高级话题有 3+ 条
+
+### 准确性
+- [ ] 每条知识有来源
+- [ ] 关键结论已交叉验证
+- [ ] 代码示例可运行
+
+### 时效性
+- [ ] 最后更新 < 6 个月
+- [ ] 无过时的技术引用
+- [ ] 版本号是最新的
+
+### 可用性
+- [ ] 目录结构清晰
+- [ ] 搜索关键词覆盖
+- [ ] 示例代码完整
+```
+
+---
+
+## 6. 快速参考
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              领域知识库模板 - 快速参考                       │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  文件命名: [domain]-expertise.md                            │
+│                                                             │
+│  必含章节:                                                  │
+│    1. 领域概述 - 定义/范围/价值                             │
+│    2. 核心概念 - 关键概念解释                               │
+│    3. 最佳实践 - 推荐做法 (5+)                              │
+│    4. 常见陷阱 - 常见错误 (5+)                              │
+│    5. 高级话题 - 进阶内容 (3+)                              │
+│    6. 工具资源 - 工具/文档/书籍                             │
+│    7. 参考来源 - 所有引用来源                               │
+│                                                             │
+│  每条知识必含:                                              │
+│    - 内容描述                                               │
+│    - 代码示例（如适用）                                     │
+│    - 来源 URL + 日期                                        │
+│                                                             │
+│  更新频率: 每次使用时检查 | 季度全面审查                    │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```