Lampio 知识库

主题

🤖 Claude Code 使用指南 ​

本目录放项目自己的工具指南，外加一份 Claude Code 用法速览。

🔴 通用 Claude Code / Skill 教程已于 2026-08-29 删除（docs/plans/archive/post-merge-repo-optimization-plan.md T2-2）：它们是第三方工具的教程、钉着「适用版本 V2.1.29+」只会越来越错，且模型自带这部分知识。要问 Claude Code 或 Skill 的用法，直接问 Claude（本环境有 claude-code-guide agent），别在本仓再养一份。

📚 指南目录 ​

文档内容适用人群
doc-maintenance-guide.md文档维护流程新增/修改文档
vocabulary-pipeline-and-reseed.md词库 pipeline + 跨端 reseed改引擎/跨端协同

🚀 快速开始 ​

什么是 Claude Code？ ​

Claude Code 是 Anthropic 官方提供的命令行工具，可以：

  • 💻 在命令行中与 Claude 对话
  • 📁 直接操作本地文件系统
  • 🔧 运行 shell 命令
  • 🤖 通过 Skills 自定义功能

基础使用 ​

bash
# 启动 Claude Code
claude

# 指定工作目录
claude --working-directory /path/to/project

# 查看帮助
claude --help

💡 按场景查找 ​

提升开发效率 ​

核心技巧：

  • 使用 Glob 和 Grep 工具快速查找代码
  • 利用 子代理 处理复杂任务（Explore/Plan/general-purpose）
  • 善用 TaskCreate/TaskUpdate 追踪任务进度
  • 配置 MCP 服务器扩展功能
  • 让 Claude 并行启动多个子代理加速搜索

自定义 Skills ​

Skill 开发流程：

  1. 创建 Skill 目录和 SKILL.md
  2. 定义触发条件和工具权限
  3. 编写 Skill 逻辑
  4. 测试和调试
  5. 发布到项目或全局

🛠️ 项目中的 Skills ​

本项目使用 8 个自定义 Skills，位于 rvh/.claude/skills/（合仓后是 scoped skill —— 碰 rvh/ 文件时才注册）：

Skill功能触发条件
code-check-before-restart重启前快速检查重启 app 前
code-review代码质量检查代码变更后
doc-sync-check文档同步检查用户说"检查文档"
ui-compliance-checkMaterial 3 规范检查UI代码变更后
clean-arch-checkClean Architecture 检查架构相关代码变更
doc-consistency-check文档内部一致性检查用户说"文档质量检查"
preinstalled-db-update预装数据库维护词库更新时

Skill 覆盖7维度：

  • 🚀 重启前检查
  • 🎨 UI规范
  • 🏗️ 架构设计
  • 📋 代码质量
  • 📚 变更驱动同步（代码/数据库→文档）
  • 📖 文档内部一致性
  • 🗄️ 数据库维护

📖 学习路径 ​

初级（基础使用） ​

  1. 安装和配置 - 查看 ../../QUICKSTART.md
  2. 基础对话 - 学习如何与 Claude 交互
  3. 文件操作 - 使用 Read、Write、Edit 工具

中级（效率提升） ​

  1. 任务管理 - 学习使用 Task 工具追踪任务
  2. 代码搜索 - 掌握 Glob 和 Grep 工具

高级（自定义扩展） ​

  1. 子代理使用 - Explore（代码库探索）/ Plan（架构设计）/ general-purpose（复杂研究），可并行
  2. Skill 开发 - 照着 rvh/.claude/skills/ 下现有的 8 个改；写法问 Claude
  3. MCP Server - 集成外部工具和服务

🔗 相关资源 ​

官方文档 ​

社区资源 ​

💡 最佳实践 ​

Do's ✅ ​

  • ✅ 使用 TaskCreate/TaskUpdate 追踪复杂任务
  • ✅ 让 Claude 在修改代码后主动检查文档
  • ✅ 利用 Skills 自动化重复性工作
  • ✅ 善用 Glob/Grep 而非 bash 命令搜索
  • ✅ 使用 Tab 键切换思考模式（v2.1+）
  • ✅ 让 Claude 使用 Explore 子代理搜索代码库
  • ✅ 对于复杂任务，明确告知 Claude 以触发子代理

Don'ts ❌ ​

  • ❌ 不要在没有 Read 的情况下直接 Edit 文件
  • ❌ 不要用 bash grep/find 替代 Grep/Glob 工具
  • ❌ 不要硬编码文件路径，使用相对路径
  • ❌ 不要忽略 Claude 的文档同步提醒
  • ❌ 不要使用旧快捷键 opt+T（已改为 Tab）
  • ❌ 不要对简单任务过度使用子代理（直接用 Read/Grep 更快）

🐛 故障排查 ​

常见问题 ​

Q: Claude 找不到文件

  • 检查工作目录是否正确
  • 使用 Glob 工具搜索文件位置

Q: Skill 没有触发

  • 检查 trigger 条件是否匹配
  • 查看 SKILL.md 的 description 字段

Q: 修改文件失败

  • 确保先使用 Read 读取了文件
  • 检查文件路径是否为绝对路径

Q: Git hooks 不工作

  • 运行 bash scripts/install-hooks.sh 安装
  • 检查 .git/hooks/pre-commit 是否可执行

📞 获取帮助 ​

最后更新：2026-02-05 版本：1.2（适用于 Claude Code V2.1.29+，新增子代理使用说明） 维护者：Reading Vocab Helper Team