@tinkcarlos/skillora 0.2.0

package/.claude/skills/skill-expert-skills/docs/_index.md

@@ -0,0 +1,91 @@
+# 知识文档索引 (Knowledge Documents Index)
+
+> 本目录存储通过最新知识获取协议生成的知识文档。
+
+---
+
+## 目录结构
+
+```
+docs/
+├── _index.md          ← 本文件：文档索引
+├── research/          ← 调研文档（时效性强）
+│   └── YYYY-MM-DD-[topic].md
+└── knowledge/         ← 知识沉淀文档（相对稳定）
+    └── [domain]-knowledge.md
+```
+
+---
+
+## 文档分类
+
+### research/ - 调研文档
+
+存储特定时间点的调研结果，具有时效性。
+
+| 文档 | 主题 | 创建日期 | 状态 |
+|------|------|----------|------|
+| *(暂无文档)* | - | - | - |
+
+### knowledge/ - 知识沉淀文档
+
+存储经过验证和整理的领域知识，相对稳定。
+
+| 文档 | 领域 | 最后更新 | 状态 |
+|------|------|----------|------|
+| *(暂无文档)* | - | - | - |
+
+---
+
+## 文档命名规范
+
+### 调研文档 (research/)
+
+```
+YYYY-MM-DD-[topic].md
+
+示例：
+- 2025-01-17-react-19-new-features.md
+- 2025-01-15-claude-skills-best-practices.md
+```
+
+### 知识沉淀文档 (knowledge/)
+
+```
+[domain]-knowledge.md
+
+示例：
+- frontend-knowledge.md
+- claude-skills-knowledge.md
+- api-design-knowledge.md
+```
+
+---
+
+## 文档状态说明
+
+| 状态 | 含义 |
+|------|------|
+| 🟢 Active | 当前有效，可直接使用 |
+| 🟡 Review | 需要审查更新 |
+| 🔴 Outdated | 已过期，需要重新调研 |
+
+---
+
+## 维护指南
+
+1. **新增文档**：按命名规范创建，更新本索引
+2. **更新文档**：修改内容后更新"最后更新"日期
+3. **过期处理**：超过时效阈值的文档标记为 Outdated
+4. **删除文档**：从索引中移除条目，归档或删除文件
+
+---
+
+## 时效性阈值
+
+| 文档类型 | 时效阈值 | 说明 |
+|----------|----------|------|
+| API/SDK 调研 | 6 个月 | 技术更新快 |
+| 框架最佳实践 | 1 年 | 相对稳定 |
+| 设计模式 | 2 年 | 较为稳定 |
+| 安全相关 | 3 个月 | 需要及时更新 |

package/.claude/skills/skill-expert-skills/references/deep-research-methodology.md

@@ -0,0 +1,389 @@
+# 深度研究方法论 (Deep Research Methodology)
+
+> **目标**：在创建/优化任何 Skill 之前，成为该领域的"博导级"专家，拥有系统性、深度的知识储备。
+
+---
+
+## 目录
+
+- [1. 为什么需要深度研究](#1-为什么需要深度研究)
+- [2. 研究深度层级](#2-研究深度层级)
+- [3. 系统性研究框架](#3-系统性研究框架)
+- [4. 知识获取策略](#4-知识获取策略)
+- [5. 知识验证与交叉检验](#5-知识验证与交叉检验)
+- [6. 知识沉淀规范](#6-知识沉淀规范)
+- [7. 研究质量评估](#7-研究质量评估)
+
+---
+
+## 1. 为什么需要深度研究
+
+### 1.1 问题案例
+
+```
+场景：优化 code-review Skill
+浅层研究：只看了几篇代码审查的文章
+结果：遗漏了以下关键内容
+  - 前后端一致性检查
+  - 非代码文件审查（.env, Docker, CI/CD）
+  - 逻辑闭环验证
+  - 全栈字段一致性
+  - 资源限制降级策略
+```
+
+### 1.2 深度研究的价值
+
+| 研究深度 | 知识覆盖率 | 遗漏风险 | 专业度 |
+|----------|------------|----------|--------|
+| 浅层（1-2篇文章） | 30-40% | 高 | 入门级 |
+| 中层（5-10篇文章） | 60-70% | 中 | 工程师级 |
+| **深层（系统性研究）** | **90%+** | **低** | **博导级** |
+
+---
+
+## 2. 研究深度层级
+
+### 2.1 五层知识金字塔
+
+```
+                    ┌─────────────┐
+                    │   第5层     │  ← 前沿研究/未解决问题
+                    │  创新边界   │
+                ┌───┴─────────────┴───┐
+                │       第4层         │  ← 高级模式/架构决策
+                │    专家级知识       │
+            ┌───┴─────────────────────┴───┐
+            │           第3层             │  ← 最佳实践/常见陷阱
+            │       实践级知识            │
+        ┌───┴─────────────────────────────┴───┐
+        │               第2层                 │  ← 核心概念/原理
+        │           原理级知识                │
+    ┌───┴─────────────────────────────────────┴───┐
+    │                   第1层                     │  ← 基础定义/术语
+    │               基础级知识                    │
+    └─────────────────────────────────────────────┘
+```
+
+### 2.2 每层必须掌握的内容
+
+| 层级 | 内容 | 研究方法 | 来源 |
+|------|------|----------|------|
+| **第1层：基础** | 术语定义、基本概念、历史背景 | 官方文档、维基百科 | 权威定义 |
+| **第2层：原理** | 工作原理、核心机制、设计理念 | 技术规范、RFC、论文 | 原始设计文档 |
+| **第3层：实践** | 最佳实践、常见错误、性能优化 | 工程博客、案例研究 | 一线经验 |
+| **第4层：专家** | 架构模式、权衡取舍、边界情况 | 专家访谈、深度文章 | 资深从业者 |
+| **第5层：前沿** | 未解决问题、新兴趋势、研究方向 | 学术论文、会议演讲 | 研究社区 |
+
+---
+
+## 3. 系统性研究框架
+
+### 3.1 研究维度矩阵
+
+对于任何领域，必须从以下 6 个维度进行系统性研究：
+
+| 维度 | 核心问题 | 研究重点 |
+|------|----------|----------|
+| **What** | 是什么？ | 定义、范围、边界 |
+| **Why** | 为什么？ | 目的、价值、必要性 |
+| **How** | 怎么做？ | 方法、流程、工具 |
+| **When** | 何时用？ | 适用场景、触发条件 |
+| **Pitfalls** | 有什么坑？ | 常见错误、反模式 |
+| **Advanced** | 高级话题？ | 优化、扩展、前沿 |
+
+### 3.2 研究清单模板
+
+```markdown
+## [领域名称] 系统性研究清单
+
+### What - 定义与范围
+- [ ] 官方定义是什么？
+- [ ] 核心组成部分有哪些？
+- [ ] 与相关概念的区别？
+- [ ] 边界在哪里？
+
+### Why - 目的与价值
+- [ ] 解决什么问题？
+- [ ] 不做会怎样？
+- [ ] 核心价值是什么？
+- [ ] ROI 如何？
+
+### How - 方法与流程
+- [ ] 标准流程是什么？
+- [ ] 关键步骤有哪些？
+- [ ] 需要什么工具？
+- [ ] 有哪些变体方法？
+
+### When - 场景与条件
+- [ ] 什么时候必须用？
+- [ ] 什么时候不该用？
+- [ ] 触发条件是什么？
+- [ ] 优先级如何判断？
+
+### Pitfalls - 陷阱与错误
+- [ ] 最常见的 5 个错误？
+- [ ] 如何检测这些错误？
+- [ ] 如何预防？
+- [ ] 如何修复？
+
+### Advanced - 高级话题
+- [ ] 性能优化方法？
+- [ ] 扩展性考虑？
+- [ ] 与其他系统集成？
+- [ ] 前沿发展趋势？
+```
+
+---
+
+## 4. 知识获取策略
+
+### 4.1 来源优先级金字塔
+
+```
+                    ┌─────────────┐
+                    │   官方文档   │  ← 最高优先级
+                    │   RFC/规范   │
+                ┌───┴─────────────┴───┐
+                │    权威技术博客     │  ← 高优先级
+                │  （大厂工程博客）   │
+            ┌───┴─────────────────────┴───┐
+            │       学术论文/会议演讲      │  ← 中优先级
+            │     （ACM, IEEE, arXiv）    │
+        ┌───┴─────────────────────────────┴───┐
+        │           社区最佳实践               │  ← 参考优先级
+        │    （Stack Overflow, GitHub）       │
+    ┌───┴─────────────────────────────────────┴───┐
+    │               个人博客/教程                  │  ← 补充优先级
+    │           （需交叉验证）                     │
+    └─────────────────────────────────────────────┘
+```
+
+### 4.2 搜索策略
+
+#### 4.2.1 官方文档搜索
+
+```
+site:docs.xxx.com [主题]
+site:platform.xxx.com [主题] specification
+[技术名] official documentation
+[技术名] RFC
+```
+
+#### 4.2.2 最佳实践搜索
+
+```
+[主题] best practices 2024
+[主题] production lessons learned
+[主题] at scale [大厂名]
+[主题] common mistakes to avoid
+```
+
+#### 4.2.3 深度技术搜索
+
+```
+[主题] internals deep dive
+[主题] architecture design
+[主题] performance optimization
+[主题] edge cases handling
+```
+
+#### 4.2.4 问题导向搜索
+
+```
+[主题] pitfalls gotchas
+[主题] troubleshooting guide
+[主题] debugging techniques
+why [主题] fails
+```
+
+### 4.3 知识来源清单
+
+| 领域类型 | 推荐来源 |
+|----------|----------|
+| **前端开发** | MDN, React/Vue 官方文档, web.dev, CSS-Tricks, Smashing Magazine |
+| **后端开发** | 语言官方文档, OWASP, Martin Fowler 博客, High Scalability |
+| **数据库** | 数据库官方文档, Use The Index Luke, Percona 博客 |
+| **安全** | OWASP, NIST, CWE, 安全厂商博客 |
+| **DevOps** | 云厂商文档, CNCF, SRE 书籍, Google SRE 博客 |
+| **AI/ML** | arXiv, Papers With Code, Hugging Face 文档 |
+
+---
+
+## 5. 知识验证与交叉检验
+
+### 5.1 三角验证法
+
+每个关键结论必须通过至少 3 个独立来源验证：
+
+```
+        来源 A (官方文档)
+              ↘
+                → 结论 ←
+              ↗         ↖
+来源 B (工程博客)    来源 C (实践案例)
+```
+
+### 5.2 验证检查清单
+
+| 检查项 | 通过标准 |
+|--------|----------|
+| **来源数量** | ≥ 3 个独立来源 |
+| **来源质量** | 至少 1 个官方/权威来源 |
+| **时效性** | 核心内容 < 2 年，边缘内容 < 5 年 |
+| **一致性** | 多来源结论一致或差异已记录 |
+| **实践验证** | 关键结论有代码/命令验证 |
+
+### 5.3 冲突处理
+
+当不同来源结论冲突时：
+
+1. **优先级判断**：官方 > 权威博客 > 社区
+2. **时效性判断**：新 > 旧（技术演进）
+3. **场景判断**：记录不同场景下的不同结论
+4. **实践验证**：通过实际测试确定
+
+---
+
+## 6. 知识沉淀规范
+
+### 6.1 沉淀位置
+
+```
+skill-expert-skills/
+├── references/
+│   ├── domain-knowledge/           ← 领域知识库
+│   │   ├── frontend-expertise.md   ← 前端领域知识
+│   │   ├── backend-expertise.md    ← 后端领域知识
+│   │   ├── database-expertise.md   ← 数据库领域知识
+│   │   ├── security-expertise.md   ← 安全领域知识
+│   │   └── [domain]-expertise.md   ← 其他领域知识
+│   └── research-logs/              ← 研究日志
+│       └── [date]-[topic].md       ← 具体研究记录
+```
+
+### 6.2 知识条目格式
+
+每条知识必须包含：
+
+```markdown
+### [知识点标题]
+
+**来源**: [URL] (检索日期: YYYY-MM-DD)
+
+**核心内容**:
+- 要点 1
+- 要点 2
+- 要点 3
+
+**适用场景**:
+- 场景 1
+- 场景 2
+
+**常见错误**:
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| ... | ... | ... |
+
+**验证方法**:
+```bash
+# 验证命令或代码
+```
+
+**相关知识**: [链接到其他相关条目]
+```
+
+### 6.3 知识更新规则
+
+| 触发条件 | 更新动作 |
+|----------|----------|
+| 发现新的权威来源 | 补充来源，更新结论 |
+| 技术版本更新 | 验证现有结论，标记过时内容 |
+| 实践中发现问题 | 补充陷阱和修复方法 |
+| 用户反馈遗漏 | 补充遗漏的知识点 |
+
+---
+
+## 7. 研究质量评估
+
+### 7.1 研究完成度评估
+
+| 维度 | 权重 | 评估标准 |
+|------|------|----------|
+| **广度** | 25% | 是否覆盖所有 6 个研究维度 |
+| **深度** | 25% | 是否达到第 4 层（专家级）知识 |
+| **来源质量** | 20% | 官方/权威来源占比 |
+| **验证程度** | 15% | 关键结论是否经过验证 |
+| **沉淀质量** | 15% | 知识是否按规范沉淀 |
+
+### 7.2 研究完成检查清单
+
+```markdown
+## 研究完成度自检
+
+### 广度检查
+- [ ] What 维度已研究
+- [ ] Why 维度已研究
+- [ ] How 维度已研究
+- [ ] When 维度已研究
+- [ ] Pitfalls 维度已研究
+- [ ] Advanced 维度已研究
+
+### 深度检查
+- [ ] 第 1 层（基础）知识已掌握
+- [ ] 第 2 层（原理）知识已掌握
+- [ ] 第 3 层（实践）知识已掌握
+- [ ] 第 4 层（专家）知识已掌握
+- [ ] 第 5 层（前沿）知识已了解
+
+### 来源检查
+- [ ] 官方文档已查阅
+- [ ] 权威博客已查阅
+- [ ] 学术资料已查阅（如适用）
+- [ ] 社区实践已参考
+
+### 验证检查
+- [ ] 关键结论已交叉验证
+- [ ] 冲突结论已处理
+- [ ] 实践验证已完成（如适用）
+
+### 沉淀检查
+- [ ] 知识已按规范沉淀
+- [ ] 来源已完整记录
+- [ ] 验证方法已记录
+```
+
+### 7.3 研究不足的信号
+
+| 信号 | 说明 | 补救措施 |
+|------|------|----------|
+| 只有 1-2 个来源 | 研究不够深入 | 扩展搜索范围 |
+| 无官方来源 | 权威性不足 | 优先查找官方文档 |
+| 结论过于笼统 | 深度不够 | 深入研究具体细节 |
+| 无陷阱/错误记录 | 实践经验不足 | 搜索常见问题 |
+| 无验证方法 | 可操作性不足 | 补充验证命令/代码 |
+
+---
+
+## 8. 快速参考卡
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              深度研究方法论 - 快速参考                       │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  研究目标：成为"博导级"专家，知识覆盖率 > 90%               │
+│                                                             │
+│  研究维度：What | Why | How | When | Pitfalls | Advanced    │
+│                                                             │
+│  知识层级：基础 → 原理 → 实践 → 专家 → 前沿                 │
+│                                                             │
+│  来源优先：官方 > 权威博客 > 学术 > 社区 > 个人             │
+│                                                             │
+│  验证要求：≥3 来源 | 交叉验证 | 实践验证                    │
+│                                                             │
+│  沉淀规范：来源 + 内容 + 场景 + 错误 + 验证                 │
+│                                                             │
+│  完成标准：6 维度覆盖 | 4 层深度 | 3 来源验证               │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```