@tinkcarlos/skillora 0.2.0

package/.claude/skills/shared-references/mcp-dependency-compatibility-protocol.md

@@ -0,0 +1,276 @@
+# MCP 依赖兼容性检查协议 (MCP Dependency Compatibility Protocol)
+
+## 核心原则
+
+```
+新增依赖前必须验证兼容性。使用 MCP 工具获取最新信息。
+```
+
+**Iron Law**: 不兼容的依赖 = 运行时崩溃 = P0 阻塞
+
+---
+
+## 🔴 MCP 工具调用策略
+
+### 工具选择矩阵
+
+| 查询类型 | 首选 MCP 工具 | 备选工具 | 用途 |
+|----------|--------------|----------|------|
+| 官方文档 | `context7` | `deepwiki` | 查询 API 兼容性、版本要求 |
+| 最新信息 | `exa` | `open-websearch` | 查询已知问题、兼容性报告 |
+| 代码示例 | `context7` | `exa` | 查询正确用法、配置方式 |
+| GitHub 信息 | `deepwiki` | `fetch` | 查询 README、Issues |
+
+### 调用顺序
+
+```
+1. context7 (官方文档) → 获取版本要求、API 兼容性
+2. exa (最新信息) → 获取已知问题、社区反馈
+3. deepwiki (GitHub) → 获取 README、兼容性说明
+```
+
+---
+
+## 🔴 Phase 1: 依赖基础检查 (MANDATORY)
+
+### Step 1.1: 包信息查询
+
+**使用 MCP 工具查询:**
+
+```markdown
+## MCP 查询: [package-name]
+
+### context7 查询
+- Query: "[package-name] compatibility requirements version"
+- 结果: [版本要求、平台兼容性]
+
+### exa 查询
+- Query: "[package-name] known issues compatibility problems 2024"
+- 结果: [已知问题、兼容性报告]
+```
+
+### Step 1.2: 本地验证
+
+```bash
+# Node.js
+npm info <package> version engines peerDependencies
+npm ls <package>  # 检查是否已安装
+
+# Python
+pip show <package>
+pip check  # 检查依赖冲突
+```
+
+---
+
+## 🔴 Phase 2: 环境兼容性检查 (MANDATORY)
+
+### 检查清单
+
+| 检查项 | MCP 查询 | 本地验证 | 严重等级 |
+|--------|----------|----------|----------|
+| Node.js 版本 | `context7: "[pkg] node version requirements"` | `node -v` vs `engines.node` | **P0** |
+| Python 版本 | `context7: "[pkg] python version support"` | `python --version` vs `python_requires` | **P0** |
+| 操作系统 | `exa: "[pkg] windows/linux/macos support"` | 检查 `os` 字段 | **P0** |
+| 浏览器/Node | `context7: "[pkg] browser node compatibility"` | 检查 `browser` 字段 | **P0** |
+| Electron | `exa: "[pkg] electron compatibility native module"` | 检查是否原生模块 | **P0** |
+
+### 环境兼容性查询模板
+
+```markdown
+## 环境兼容性: [package-name]
+
+### MCP 查询结果
+
+**context7 查询**: "[package-name] node version python version requirements"
+- Node.js: [要求版本] vs [当前版本] → ✅/❌
+- Python: [要求版本] vs [当前版本] → ✅/❌
+
+**exa 查询**: "[package-name] electron react-native compatibility"
+- Electron 兼容: ✅/❌
+- React Native 兼容: ✅/❌
+- 原生模块: 是/否
+
+### 本地验证
+```bash
+# 执行的命令和结果
+```
+```
+
+---
+
+## 🔴 Phase 3: 依赖冲突检查 (MANDATORY)
+
+### 检查清单
+
+| 检查项 | MCP 查询 | 本地验证 | 严重等级 |
+|--------|----------|----------|----------|
+| 版本冲突 | `exa: "[pkg-a] [pkg-b] version conflict"` | `npm ls` / `pip check` | **P0** |
+| Peer 依赖 | `context7: "[pkg] peer dependencies"` | `npm info [pkg] peerDependencies` | **P1** |
+| 重复依赖 | - | `npm dedupe --dry-run` | **P2** |
+
+### 冲突检查查询模板
+
+```markdown
+## 依赖冲突检查: [new-package]
+
+### 现有依赖
+| 包名 | 版本 |
+|------|------|
+| react | 18.2.0 |
+| ... | ... |
+
+### MCP 查询
+
+**exa 查询**: "[new-package] react 18 compatibility conflict"
+- 结果: [兼容性信息]
+
+**context7 查询**: "[new-package] peer dependencies requirements"
+- Peer 依赖: [列表]
+- 与现有依赖冲突: ✅ 无冲突 / ❌ 有冲突
+
+### 本地验证
+```bash
+npm install [new-package] --dry-run
+# 或
+pip install [new-package] --dry-run
+```
+```
+
+---
+
+## 🔴 Phase 4: 安全与许可证检查 (MANDATORY)
+
+### 检查清单
+
+| 检查项 | MCP 查询 | 本地验证 | 严重等级 |
+|--------|----------|----------|----------|
+| 安全漏洞 | `exa: "[pkg] security vulnerability CVE"` | `npm audit` / `pip-audit` | **P0** |
+| 许可证 | `context7: "[pkg] license"` | `npm info [pkg] license` | **P1** |
+| 维护状态 | `exa: "[pkg] maintained deprecated"` | 检查最后更新时间 | **P2** |
+
+### 安全检查查询模板
+
+```markdown
+## 安全检查: [package-name]
+
+### MCP 查询
+
+**exa 查询**: "[package-name] security vulnerability CVE 2024"
+- 已知漏洞: [列表或无]
+- 严重程度: [Critical/High/Medium/Low]
+
+**context7 查询**: "[package-name] license"
+- 许可证: [MIT/Apache/GPL/...]
+- 与项目许可证兼容: ✅/❌
+
+### 本地验证
+```bash
+npm audit
+# 或
+pip-audit
+```
+
+### 维护状态
+- 最后更新: [日期]
+- 状态: ✅ 活跃维护 / ⚠️ 低活跃 / ❌ 已弃用
+```
+
+---
+
+## 🔴 Phase 5: 包大小与性能影响 (RECOMMENDED)
+
+### 检查清单
+
+| 检查项 | 工具 | 阈值 |
+|--------|------|------|
+| 包大小 | `bundlephobia.com` / `npm info` | < 100KB (前端) |
+| 依赖数量 | `npm info dependencies` | < 20 个直接依赖 |
+| Tree-shaking | `context7: "[pkg] tree shaking support"` | 支持 ESM |
+
+---
+
+## 输出契约
+
+### 依赖兼容性报告模板
+
+```markdown
+## 依赖兼容性报告: [package-name]@[version]
+
+### Phase 1: 基础信息
+- 包名: [name]
+- 版本: [version]
+- 描述: [description]
+
+### Phase 2: 环境兼容性
+| 检查项 | 要求 | 当前 | 状态 |
+|--------|------|------|------|
+| Node.js | >=16 | 18.17.0 | ✅ |
+| Python | >=3.8 | 3.11.0 | ✅ |
+| Electron | 兼容 | - | ✅/❌ |
+
+### Phase 3: 依赖冲突
+| 冲突包 | 要求版本 | 现有版本 | 状态 |
+|--------|----------|----------|------|
+| react | ^18.0.0 | 18.2.0 | ✅ |
+
+### Phase 4: 安全与许可证
+- 安全漏洞: ✅ 无 / ❌ [CVE-xxx]
+- 许可证: MIT ✅
+- 维护状态: ✅ 活跃
+
+### Phase 5: 性能影响
+- 包大小: 45KB (gzip)
+- 依赖数量: 3
+
+### 最终结论
+**兼容性状态**: ✅ 可安装 / ⚠️ 需注意 / ❌ 不兼容
+
+**注意事项**:
+- [如有]
+```
+
+---
+
+## 快速检查命令
+
+### Node.js
+
+```bash
+# 完整检查流程
+npm info <package> version engines peerDependencies license
+npm install <package> --dry-run
+npm audit
+npm ls
+```
+
+### Python
+
+```bash
+# 完整检查流程
+pip show <package>
+pip install <package> --dry-run
+pip check
+pip-audit
+```
+
+---
+
+## 常见问题处理
+
+| 问题 | MCP 查询 | 解决方案 |
+|------|----------|----------|
+| 版本冲突 | `exa: "[pkg-a] [pkg-b] version conflict solution"` | 升级/降级依赖 |
+| 原生模块不兼容 | `exa: "[pkg] pure javascript alternative"` | 使用纯 JS 替代 |
+| 安全漏洞 | `exa: "[pkg] CVE fix update"` | 升级到修复版本 |
+| 许可证不兼容 | `exa: "[pkg] alternative MIT license"` | 寻找替代包 |
+
+---
+
+## Reference Navigation
+
+| 情况 | 参考文档 |
+|------|----------|
+| 原生模块替代 | `../fullstack-developer/references/dependency-and-integrity-protocol.md` |
+| Import 完整性 | `import-integrity-protocol.md` |
+| Electron 兼容性 | `../bug-fixing/references/dependency-and-integrity-protocol.md` |

package/.claude/skills/shared-references/skill-call-graph.md

@@ -0,0 +1,230 @@
+# Skill Call Graph
+
+技能调用关系可视化文档。
+
+---
+
+## 调用关系图
+
+```
+                              ┌─────────────────────────────────────────────────────────────┐
+                              │                    用户请求入口                              │
+                              └─────────────────────────────────────────────────────────────┘
+                                                        │
+                    ┌───────────────────────────────────┼───────────────────────────────────┐
+                    │                                   │                                   │
+                    ▼                                   ▼                                   ▼
+        ┌───────────────────┐               ┌───────────────────┐               ┌───────────────────┐
+        │ product-requirements│             │ fullstack-developer│              │    bug-fixing     │
+        │   (需求分析器)      │             │    (主编排器)       │              │   (Bug 修复器)    │
+        └───────────────────┘               └───────────────────┘               └───────────────────┘
+                    │                                   │                                   │
+                    │                    ┌──────────────┼──────────────┐                   │
+                    │                    │              │              │                   │
+                    ▼                    ▼              ▼              ▼                   ▼
+        ┌─────────────────┐    ┌─────────────┐ ┌─────────────┐ ┌─────────────┐   ┌─────────────┐
+        │ frontend-design │    │api-scaffolding│ │database-    │ │test-driven- │   │ code-review │
+        │  (前端设计器)    │    │             │ │migrations   │ │development  │   │ (代码审查器) │
+        └─────────────────┘    └─────────────┘ └─────────────┘ └─────────────┘   └─────────────┘
+                    │                                                                      │
+                    │                                                                      │
+                    ▼                                                                      ▼
+        ┌─────────────────┐                                                    ┌─────────────────┐
+        │react-best-      │                                                    │   bug-fixing    │
+        │practices        │                                                    │   (循环修复)     │
+        └─────────────────┘                                                    └─────────────────┘
+```
+
+---
+
+## 编排器 Skills 详细调用关系
+
+### 1. fullstack-developer (主编排器)
+
+```
+fullstack-developer
+    │
+    ├── Phase 1: 需求分析
+    │       └── product-requirements (强制)
+    │
+    ├── Phase 2-3: 设计与计划
+    │       ├── database-migrations (如涉及数据库)
+    │       └── api-scaffolding (如涉及 API)
+    │
+    ├── Phase 4: 开发执行
+    │       ├── frontend-design (如涉及 UI) ──→ react-best-practices
+    │       ├── api-testing-observability (API 测试)
+    │       └── test-driven-development (测试)
+    │
+    ├── Phase 5: 测试验证
+    │       └── webapp-testing (Web 自动化)
+    │
+    └── Phase 6: 代码审查 (强制闭环)
+            └── code-review ──→ bug-fixing ──→ code-review (循环)
+```
+
+### 2. bug-fixing (Bug 修复器)
+
+```
+bug-fixing
+    │
+    ├── 修复需要新 API
+    │       └── fullstack-developer (最小 API only)
+    │
+    ├── 修复涉及 UI
+    │       └── frontend-design (Fix-related only)
+    │
+    ├── 修复涉及数据库
+    │       └── database-migrations (Required changes only)
+    │
+    ├── 需要回归测试
+    │       └── test-driven-development
+    │
+    └── 修复完成 (强制)
+            └── code-review ──→ verification-before-completion
+```
+
+### 3. code-review (代码审查器)
+
+```
+code-review
+    │
+    ├── 发现 P0/P1 Bug (强制)
+    │       └── bug-fixing ──→ code-review (循环直到通过)
+    │
+    ├── 缺少测试覆盖
+    │       └── test-driven-development
+    │
+    └── 修复后需验证
+            └── verification-before-completion
+```
+
+### 4. product-requirements (需求分析器)
+
+```
+product-requirements
+    │
+    ├── UI 开发
+    │       └── frontend-design (仅计划内 UI)
+    │
+    ├── Bug 发现
+    │       └── bug-fixing (仅阻塞性 Bug)
+    │
+    ├── 代码完成
+    │       └── code-review (本次变更)
+    │
+    └── 测试需求
+            └── test-driven-development (计划内测试)
+```
+
+### 5. frontend-design (前端设计器)
+
+```
+frontend-design
+    │
+    ├── React/Next.js 项目 (强制)
+    │       └── react-best-practices
+    │
+    ├── UI 审查/可访问性 (强制)
+    │       └── web-design-guidelines
+    │
+    └── 设计完成后
+            └── code-review
+```
+
+---
+
+## 强制调用链 (Closed Loops)
+
+### 闭环 1: 代码审查闭环
+
+```
+code-review ──→ bug-fixing ──→ code-review (循环直到通过)
+```
+
+### 闭环 2: 开发完成闭环
+
+```
+development ──→ verification-before-completion ──→ code-review ──→ (bug-fixing →)* ──→ merge
+```
+
+### 闭环 3: Bug 修复闭环
+
+```
+bug-fixing ──→ code-review ──→ verification-before-completion
+```
+
+---
+
+## 调用约束矩阵
+
+| 调用方 | 被调用方 | 范围约束 | 强制? |
+|--------|----------|----------|-------|
+| fullstack-developer | product-requirements | - | ✅ |
+| fullstack-developer | frontend-design | 任何 UI 工作 | ✅ |
+| fullstack-developer | database-migrations | ORM 模型变更 | ✅ |
+| fullstack-developer | code-review | 开发完成后 | ✅ |
+| fullstack-developer | bug-fixing | 审查发现问题 | P0/P1 only |
+| bug-fixing | fullstack-developer | 修复需要新 API | 最小 API only |
+| bug-fixing | frontend-design | 修复涉及 UI | Fix-related only |
+| bug-fixing | database-migrations | 修复涉及数据库 | Required changes only |
+| bug-fixing | code-review | 修复完成 | ✅ |
+| code-review | bug-fixing | 发现 P0/P1 Bug | ✅ |
+| frontend-design | react-best-practices | React/Next.js | ✅ |
+| frontend-design | web-design-guidelines | UI 审查 | ✅ |
+
+---
+
+## 上下文隔离规则
+
+### 委托进入
+
+```markdown
+## 🔄 技能委托通知
+
+### 主上下文锚点确认
+- **原始任务**: [用户的原始请求]
+- **任务 ID**: [Bug ID / 需求文档路径]
+- **当前计划任务**: T[X] - [任务描述]
+- **成功标准**: [明确的完成条件]
+
+### 委托详情
+- **目标 Skill**: `[skill-name]`
+- **委托目的**: [为什么需要这个 Skill]
+- **范围限定**:
+  - ✅ 允许: [具体允许的操作]
+  - ❌ 禁止: [明确禁止的操作]
+- **退出条件**: [什么标志完成]
+
+---
+⏱️ 开始委托任务...
+```
+
+### 委托退出
+
+```markdown
+## ✅ 委托任务完成
+
+### 完成情况
+- **目标达成**: ✅ / ❌
+- **范围遵守**: ✅ / ❌
+- **产出物**: [创建/修改的文件列表]
+
+### 偏离检查
+- **是否偏离原始目标**: ✅ 未偏离 / ❌ 已偏离
+- **偏离说明**: [如有偏离，说明原因]
+
+### 返回主上下文
+- **继续任务**: T[X+1]
+- **计划状态更新**: [更新内容]
+
+---
+🔄 返回主上下文
+```
+
+---
+
+## 参考文档
+
+- 完整编排协议: `skill-orchestration-protocol.md`
+- 技能路由表: `../fullstack-developer/references/skill-router-table.md`