超级版1

2026-08-13 02:48:05 +00:00 · 2025-12-13 17:00:54 +08:00
parent 5e6f46c096
commit 53100d627b
108 changed files with 240878 additions and 21 deletions
@@ -0,0 +1,470 @@
+---
+name: claude-code-guide
+description: Claude Code 高级开发指南 - 全面的中文教程，涵盖工具使用、REPL 环境、开发工作流、MCP 集成、高级模式和最佳实践。适合学习 Claude Code 的高级功能和开发技巧。
+---
+
+# Claude Code 高级开发指南
+
+全面的 Claude Code 中文学习指南，涵盖从基础到高级的所有核心概念、工具使用、开发工作流和最佳实践。
+
+## 何时使用此技能
+
+当需要以下帮助时使用此技能：
+- 学习 Claude Code 的核心功能和工具
+- 掌握 REPL 环境的高级用法
+- 理解开发工作流和任务管理
+- 使用 MCP 集成外部系统
+- 实现高级开发模式
+- 应用 Claude Code 最佳实践
+- 解决常见问题和错误
+- 进行大文件分析和处理
+
+## 快速参考
+
+### Claude Code 核心工具（7个）
+
+1. **REPL** - JavaScript 运行时环境
+   - 完整的 ES6+ 支持
+   - 预加载库：D3.js, MathJS, Lodash, Papaparse, SheetJS
+   - 支持 async/await, BigInt, WebAssembly
+   - 文件读取：`window.fs.readFile()`
+
+2. **Artifacts** - 可视化输出
+   - React, Three.js, 图表库
+   - HTML/SVG 渲染
+   - 交互式组件
+
+3. **Web Search** - 网络搜索
+   - 仅美国可用
+   - 域名过滤支持
+
+4. **Web Fetch** - 获取网页内容
+   - HTML 转 Markdown
+   - 内容提取和分析
+
+5. **Conversation Search** - 对话搜索
+   - 搜索历史对话
+   - 上下文检索
+
+6. **Recent Chats** - 最近对话
+   - 访问最近会话
+   - 对话历史
+
+7. **End Conversation** - 结束对话
+   - 清理和总结
+   - 会话管理
+
+### 大文件分析工作流
+
+```bash
+# 阶段 1：定量评估
+wc -l filename.md    # 行数统计
+wc -w filename.md    # 词数统计
+wc -c filename.md    # 字符数统计
+
+# 阶段 2：结构分析
+grep "^#{1,6} " filename.md  # 提取标题层次
+grep "```" filename.md       # 识别代码块
+grep -c "keyword" filename.md # 关键词频率
+
+# 阶段 3：内容提取
+Read filename.md offset=0 limit=50      # 文件开头
+Read filename.md offset=N limit=100     # 目标部分
+Read filename.md offset=-50 limit=50    # 文件结尾
+```
+
+### REPL 高级用法
+
+```javascript
+// 数据处理
+const data = [1, 2, 3, 4, 5];
+const sum = data.reduce((a, b) => a + b, 0);
+
+// 使用预加载库
+// Lodash
+_.chunk([1, 2, 3, 4], 2);  // [[1,2], [3,4]]
+
+// MathJS
+math.sqrt(16);  // 4
+
+// D3.js
+d3.range(10);  // [0,1,2,3,4,5,6,7,8,9]
+
+// 读取文件
+const content = await window.fs.readFile('path/to/file');
+
+// 异步操作
+const result = await fetch('https://api.example.com/data');
+const json = await result.json();
+```
+
+### 斜杠命令系统
+
+**内置命令：**
+- `/help` - 显示帮助
+- `/clear` - 清除对话
+- `/plugin` - 管理插件
+- `/settings` - 配置设置
+
+**自定义命令：**
+创建 `.claude/commands/mycommand.md`：
+```markdown
+根据需求执行特定任务的指令
+```
+
+使用：`/mycommand`
+
+### 开发工作流模式
+
+#### 1. 文件分析工作流
+```bash
+# 探索 → 理解 → 实现
+ls -la                  # 列出文件
+Read file.py            # 读取内容
+grep "function" file.py # 搜索模式
+# 然后实现修改
+```
+
+#### 2. 算法验证工作流
+```bash
+# 设计 → 验证 → 实现
+# 1. 在 REPL 中测试逻辑
+# 2. 验证边界情况
+# 3. 实现到代码
+```
+
+#### 3. 数据探索工作流
+```bash
+# 检查 → 分析 → 可视化
+# 1. 读取数据文件
+# 2. REPL 中分析
+# 3. Artifacts 可视化
+```
+
+## 核心概念
+
+### 工具权限系统
+
+**自动授予权限的工具：**
+- REPL
+- Artifacts  
+- Web Search/Fetch
+- Conversation Search
+
+**需要授权的工具：**
+- Bash (读/写文件系统)
+- Edit (修改文件)
+- Write (创建文件)
+
+### 项目上下文
+
+Claude 自动识别：
+- Git 仓库状态
+- 编程语言（从文件扩展名）
+- 项目结构
+- 依赖配置
+
+### 内存系统
+
+**对话内存：**
+- 存储在当前会话
+- 200K token 窗口
+- 自动上下文管理
+
+**持久内存（实验性）：**
+- 跨会话保存
+- 用户偏好记忆
+- 项目上下文保留
+
+## MCP 集成
+
+### 什么是 MCP？
+
+Model Context Protocol - 连接 Claude 到外部系统的协议。
+
+### MCP 服务器配置
+
+配置文件：`~/.config/claude/mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "node",
+      "args": ["path/to/server.js"],
+      "env": {
+        "API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
+
+### 使用 MCP 工具
+
+Claude 会自动发现 MCP 工具并在对话中使用：
+
+```
+"使用 my-server 工具获取数据"
+```
+
+## 钩子系统
+
+### 钩子类型
+
+在 `.claude/settings.json` 配置：
+
+```json
+{
+  "hooks": {
+    "tool-pre-use": "echo 'About to use tool'",
+    "tool-post-use": "echo 'Tool used'",
+    "user-prompt-submit": "echo 'Processing prompt'"
+  }
+}
+```
+
+### 常见钩子用途
+
+- 自动格式化代码
+- 运行测试
+- Git 提交检查
+- 日志记录
+- 通知发送
+
+## 高级模式
+
+### 多代理协作
+
+使用 Task 工具启动子代理：
+
+```
+"启动一个专门的代理来优化这个算法"
+```
+
+子代理特点：
+- 独立上下文
+- 专注单一任务
+- 返回结果到主代理
+
+### 智能任务管理
+
+使用 TodoWrite 工具：
+
+```
+"创建任务列表来跟踪这个项目"
+```
+
+任务状态：
+- `pending` - 待处理
+- `in_progress` - 进行中  
+- `completed` - 已完成
+
+### 代码生成模式
+
+**渐进式开发：**
+1. 生成基础结构
+2. 添加核心功能
+3. 实现细节
+4. 测试和优化
+
+**验证驱动：**
+1. 写测试用例
+2. 实现功能
+3. 运行测试
+4. 修复问题
+
+## 质量保证
+
+### 自动化测试
+
+```bash
+# 运行测试
+npm test
+pytest
+
+# 类型检查
+mypy script.py
+tsc --noEmit
+
+# 代码检查
+eslint src/
+flake8 .
+```
+
+### 代码审查模式
+
+使用子代理进行审查：
+
+```
+"启动代码审查代理检查这个文件"
+```
+
+审查重点：
+- 代码质量
+- 安全问题
+- 性能优化
+- 最佳实践
+
+## 错误恢复
+
+### 常见错误模式
+
+1. **工具使用错误**
+   - 检查权限
+   - 验证语法
+   - 确认路径
+
+2. **文件操作错误**
+   - 确认文件存在
+   - 检查读写权限
+   - 验证路径正确
+
+3. **API 调用错误**
+   - 检查网络连接
+   - 验证 API 密钥
+   - 确认请求格式
+
+### 渐进式修复策略
+
+1. 隔离问题
+2. 最小化复现
+3. 逐步修复
+4. 验证解决方案
+
+## 最佳实践
+
+### 开发原则
+
+1. **清晰优先** - 明确需求和目标
+2. **渐进实现** - 分步骤开发
+3. **持续验证** - 频繁测试
+4. **适当抽象** - 合理模块化
+
+### 工具使用原则
+
+1. **正确的工具** - 选择合适的工具
+2. **工具组合** - 多工具协同
+3. **权限最小化** - 只请求必要权限
+4. **错误处理** - 优雅处理失败
+
+### 性能优化
+
+1. **批量操作** - 合并多个操作
+2. **增量处理** - 处理大文件
+3. **缓存结果** - 避免重复计算
+4. **异步优先** - 使用 async/await
+
+## 安全考虑
+
+### 沙箱模型
+
+每个工具在隔离环境中运行：
+- REPL：无文件系统访问
+- Bash：需要明确授权
+- Web：仅特定域名
+
+### 最佳安全实践
+
+1. **最小权限** - 仅授予必要权限
+2. **代码审查** - 检查生成的代码
+3. **敏感数据** - 不要共享密钥
+4. **定期审计** - 检查钩子和配置
+
+## 故障排除
+
+### 工具无法使用
+
+**症状：** 工具调用失败
+
+**解决方案：**
+- 检查权限设置
+- 验证语法正确
+- 确认文件路径
+- 查看错误消息
+
+### REPL 性能问题
+
+**症状：** REPL 执行缓慢
+
+**解决方案：**
+- 减少数据量
+- 使用流式处理
+- 优化算法
+- 分批处理
+
+### MCP 连接失败
+
+**症状：** MCP 服务器无响应
+
+**解决方案：**
+- 检查配置文件
+- 验证服务器运行
+- 确认环境变量
+- 查看服务器日志
+
+## 实用示例
+
+### 示例 1：数据分析
+
+```javascript
+// 在 REPL 中
+const data = await window.fs.readFile('data.csv');
+const parsed = Papa.parse(data, { header: true });
+const values = parsed.data.map(row => parseFloat(row.value));
+const avg = _.mean(values);
+const std = math.std(values);
+console.log(`平均值: ${avg}, 标准差: ${std}`);
+```
+
+### 示例 2：文件搜索
+
+```bash
+# 在 Bash 中
+grep -r "TODO" src/
+find . -name "*.py" -type f
+```
+
+### 示例 3：网络数据获取
+
+```
+"使用 web_fetch 获取 https://api.example.com/data 的内容，
+然后在 REPL 中分析 JSON 数据"
+```
+
+## 参考文件
+
+此技能包含详细文档：
+
+- **README.md** (9,594 行) - 完整的 Claude Code 高级指南
+
+包含以下主题：
+- 核心工具深度解析
+- REPL 高级协同模式
+- 开发工作流详解
+- MCP 集成完整指南
+- 钩子系统配置
+- 高级模式和最佳实践
+- 故障排除和安全考虑
+
+使用 `view` 命令查看参考文件获取详细信息。
+
+## 资源
+
+- **GitHub 仓库**: https://github.com/karminski/claude-code-guide-study
+- **原始版本**: https://github.com/Cranot/claude-code-guide
+- **Anthropic 官方文档**: https://docs.claude.com
+
+## 注意事项
+
+本指南结合了：
+- 官方功能和公告
+- 实际使用观察到的模式
+- 概念性方法和最佳实践
+- 第三方工具集成
+
+请在使用时参考最新的官方文档。
+
+---
+
+**使用这个技能深入掌握 Claude Code 的强大功能！**
@@ -0,0 +1,328 @@
+# Claude Code 高级开发指南文档索引
+
+## 文档概览
+
+### README.md
+**文件:** `README.md`
+**行数:** 9,594 行
+**语言:** 中文
+
+这是一份极其详细和全面的 Claude Code 学习指南，涵盖从基础到高级的所有内容。
+
+## 主要章节
+
+### 1. 快速导航与参考
+- 即时命令参考
+- 功能快速参考
+- 高级用户快捷方式
+- 任务状态参考
+- 常见工作流卡片
+
+### 2. 核心智能系统
+- Claude 工具的关键发现
+- 高级 REPL 协同模式
+- 专用内核架构集成
+- 元待办事项系统
+- 高级协同实现
+
+### 3. 核心概念
+- 7 个核心工具详解
+- 权限系统
+- 项目上下文
+- 内存管理
+- 文件操作
+
+### 4. 斜杠命令系统
+- 系统命令
+- 自定义命令
+- 命令模板
+- 命令组织
+
+### 5. 钩子系统
+- 钩子类型
+- 事件触发
+- 安全模式
+- 自动化工作流
+
+### 6. MCP 集成
+- MCP 服务器配置
+- OAuth 认证
+- 外部系统集成
+- 子代理使用
+
+### 7. 开发工作流
+- 文件分析工作流
+- 算法验证工作流
+- 数据探索工作流
+- 任务管理模式
+
+### 8. 质量保证
+- 自动化测试
+- 代码审查
+- 多代理协作
+- 验证策略
+
+### 9. 错误恢复
+- 常见错误模式
+- 渐进式修复
+- 调试技巧
+- 问题诊断
+
+### 10. 实用示例
+- 数据分析
+- 文件处理
+- API 集成
+- 可视化创建
+- 测试自动化
+
+### 11. 高级模式
+- 研究系统
+- Smart Flows
+- 认知方法
+- 多代理编排
+
+### 12. 最佳实践
+- 开发原则
+- 工具使用
+- 性能优化
+- 代码质量
+
+### 13. 故障排除
+- 常见问题
+- 解决方案
+- 诊断步骤
+- 工具调试
+
+### 14. 安全考虑
+- 沙箱模型
+- 权限管理
+- 安全审计
+- 最佳安全实践
+
+### 15. 工具协同掌握
+- 工具组合模式
+- 高级集成
+- 性能优化
+- 实战案例
+
+## 核心工具详解
+
+### 1. REPL (JavaScript 运行时)
+- 完整 ES6+ 支持
+- 预加载 5 个库：
+  - D3.js (数据可视化)
+  - MathJS (数学计算)
+  - Lodash (实用工具)
+  - Papaparse (CSV 解析)
+  - SheetJS (Excel 处理)
+- 异步支持 (async/await)
+- BigInt 支持
+- WebAssembly 支持
+- 文件读取能力
+
+### 2. Artifacts (可视化输出)
+- React 组件
+- Three.js 3D 渲染
+- HTML/SVG 生成
+- 图表和可视化
+- 交互式界面
+
+### 3. Web Search (网络搜索)
+- 搜索网络内容
+- 域名过滤
+- 仅美国可用
+
+### 4. Web Fetch (内容获取)
+- 获取网页内容
+- HTML 转 Markdown
+- 内容提取
+
+### 5. Conversation Search (对话搜索)
+- 搜索历史对话
+- 上下文检索
+
+### 6. Recent Chats (最近对话)
+- 访问最近会话
+- 对话历史管理
+
+### 7. End Conversation (结束对话)
+- 会话清理
+- 对话总结
+
+## 大文件分析方法论
+
+指南提供系统化的大文件处理方法：
+
+### 第一阶段：定量评估
+使用 `wc` 命令确定文件规模
+
+### 第二阶段：结构分析
+使用 `grep` 提取结构信息
+
+### 第三阶段：内容提取
+使用 `Read` 工具战略性采样
+
+## REPL 高级用法
+
+### 数据科学能力
+- 处理 100,000+ 元素数组
+- 统计分析
+- 数据转换
+- 可视化准备
+
+### 预加载库示例
+```javascript
+// Lodash
+_.chunk([1,2,3,4], 2)
+
+// MathJS
+math.sqrt(16)
+
+// D3.js
+d3.range(10)
+
+// Papaparse
+Papa.parse(csvData)
+
+// SheetJS
+XLSX.read(data)
+```
+
+## 工作流模式
+
+### 文件分析工作流
+探索 → 理解 → 实现
+
+### 算法验证工作流
+设计 → 验证 → 实现
+
+### 数据探索工作流
+检查 → 分析 → 可视化
+
+### 质量保证工作流
+测试 → 审查 → 优化
+
+## MCP 集成详解
+
+### 配置文件位置
+`~/.config/claude/mcp_config.json`
+
+### MCP 服务器类型
+- API 集成服务器
+- 数据库连接服务器
+- 文件系统服务器
+- 自定义工具服务器
+
+### 认证方式
+- API 密钥
+- OAuth 2.0
+- 环境变量
+- 配置文件
+
+## 钩子系统
+
+### 钩子触发时机
+- 工具使用前/后
+- 用户提示提交
+- 文件修改
+- 命令执行
+
+### 钩子用途
+- 代码格式化
+- 自动测试
+- Git 操作
+- 日志记录
+- 通知发送
+
+## 高级模式
+
+### 多代理协作
+- 主代理编排
+- 子代理专门化
+- 结果聚合
+- 任务分解
+
+### 智能任务管理
+- 任务创建
+- 状态追踪
+- 进度报告
+- 优先级管理
+
+### 认知增强
+- 记忆利用
+- 上下文管理
+- 知识整合
+- 推理优化
+
+## 最佳实践总结
+
+### 开发原则
+1. 清晰优先
+2. 渐进实现
+3. 持续验证
+4. 适当抽象
+
+### 工具使用原则
+1. 选择正确工具
+2. 组合工具能力
+3. 最小化权限
+4. 处理错误
+
+### 性能优化原则
+1. 批量操作
+2. 增量处理
+3. 缓存结果
+4. 异步优先
+
+## 安全注意事项
+
+### 沙箱隔离
+每个工具在独立沙箱中运行
+
+### 权限管理
+- 自动授予权限的工具
+- 需要授权的工具
+- 权限最小化原则
+
+### 敏感数据处理
+- 不要共享 API 密钥
+- 不要提交密码
+- 使用环境变量
+- 定期审计配置
+
+## 快速链接
+
+- **GitHub**: https://github.com/karminski/claude-code-guide-study
+- **原始版本**: https://github.com/Cranot/claude-code-guide
+- **Star 数**: 444+
+- **Fork 数**: 174+
+
+## 使用建议
+
+这份指南内容极其丰富（9,594 行），建议：
+
+1. **初学者**: 从核心概念开始
+2. **中级用户**: 关注开发工作流
+3. **高级用户**: 深入高级模式
+4. **问题解决**: 查看故障排除章节
+
+## 特色内容
+
+### 系统化大文件分析
+详细的三阶段方法论
+
+### REPL 深度解析
+超越基础的高级用法
+
+### MCP 完整指南
+从配置到实战
+
+### 多代理编排
+高级协作模式
+
+### 认知增强策略
+提升 Claude 能力的方法
+
+---
+
+**这是目前最全面的 Claude Code 中文学习资源！**