Claude Skills实践

引言 什么是 Claude Skills Claude Skills 是 Claude Code 提供的一种可复用提示词模板机制。它允许用户将常用的任务流程封装成可执行的"技能",通过 /技能名称 的方式快速调用。 Skills 本质上是预定义的提示词(prompts),存储在项目的 .claude/skills/ 目录下。每个 Skill 是一个 Markdown 文件,包含任务描述和执行指令。当用户调用 Skill 时,Claude Code 会自动加载该文件的内容作为对话的起始提示。 例如,内置的 /commit Skill 会引导 Claude 按照规范的流程创建 git commit,而 /review-pr 则帮助用户审查 Pull Request。 为什么需要 Skills 在日常开发中,我们经常会重复执行某些任务,比如: 代码提交:遵循特定的 commit message 规范 代码审查:按照团队的 PR 审查清单逐项检查 文档生成:为新功能自动生成文档模板 测试运行:执行特定的测试命令并分析结果 每次手动输入这些指令不仅繁琐,还容易遗漏关键步骤。Skills 的价值在于: 提高效率:一键触发复杂的多步骤任务 保证一致性:确保每次执行都遵循相同的流程和标准 知识沉淀:将团队的 best practice 固化为可复用的模板 降低门槛:新成员可以通过 Skills 快速上手团队工作流 Skills 基础概念 Skills 的定义和作用 从技术角度看,一个 Skill 是一个 Markdown 文件,其目录层级如下: ~/.claude/skills/ # 用户级别(个人使用,跨项目可用) └── my-skill/ └── SKILL.md # Skill 定义文件 <project>/.claude/skills/ # 项目级别(随项目共享,团队通用) └── team-skill/ └── SKILL.md 每个 Skill 是一个独立的目录,目录名即为 Skill 名称,内部包含一个 SKILL.md 文件。文件结构如下: ...

2026-03-22 · Jerry Wang

Vscode Claude Code编程实践

VSCode设置Claude 常用设置项 设置claude界面及默认的模式,编程建议用plan。 核心功能 代码生成与补全 代码分析与解释 重构与优化 调试辅助 编程实践技巧 如何写好Prompt Prompt是与Claude Code交互的核心,好的Prompt能显著提高代码质量和开发效率。 基本原则 明确具体:清楚描述你想要什么,避免模糊表述 差:帮我写个函数 好:写一个TypeScript函数,接收字符串数组,返回去重后的数组 提供上下文:说明技术栈、约束条件、相关文件 例:在这个Next.js项目中,使用React Query实现用户列表组件 分步骤:复杂任务拆分成多个小请求 先搭架子 → 再实现核心逻辑 → 最后处理边界情况 常用Prompt模板 代码生成 请实现一个[功能名称],要求: - 技术栈:[框架/库] - 输入:[参数说明] - 输出:[返回值说明] - 约束:[性能/安全/风格要求] 代码解释 请解释这段代码的作用: [粘贴代码] 重点关注:[具体问题] Bug修复 这段代码出现[错误信息],期望行为是[...],请帮我定位并修复: [粘贴代码] 代码重构 请重构以下代码,目标是: - 提高可读性 - 遵循[编码规范] - 保持功能不变 [粘贴代码] 进阶技巧 指定文件范围:在src/utils目录下创建... 引用现有代码:参考api/user.ts的风格实现... 添加约束:不使用第三方库、兼容IE11 要求解释:并解释你的实现思路 利用CLAUDE.md文件 CLAUDE.md是项目根目录下的一个特殊文件,用于为Claude Code提供项目级的上下文信息,让AI更好地理解你的项目。 什么是CLAUDE.md CLAUDE.md类似README,但专门写给Claude看。Claude Code在每次交互时会自动读取这个文件,了解项目背景、规范和约定。 应该写什么 # 项目概述 这是一个使用Next.js 14 + TypeScript的电商平台后台管理系统。 # 技术栈 - 框架:Next.js 14 (App Router) - 语言:TypeScript - 样式:Tailwind CSS - 状态管理:Zustand - 数据获取:TanStack Query # 代码规范 - 组件放在src/components,按功能模块分类 - API路由放在app/api目录 - 使用函数式组件和Hooks - 命名:组件用PascalCase,函数用camelCase # 重要约定 - 所有API响应使用统一格式 { code, data, message } - 表单使用react-hook-form + zod验证 - 错误处理使用全局ErrorBoundary # 注意事项 - 不要修改src/legacy目录下的代码 - 新功能需要添加单元测试 最佳实践 保持更新:技术栈变更时同步更新 控制长度:控制在200行以内,过长会被截断 突出重点:写AI需要知道的,而非所有细节 明确禁止:列出不想让AI做的事情 斜杠命令使用 Claude Code提供了丰富的斜杠命令(Slash Commands),用于快速执行常见任务。 ...

2026-03-22 · Jerry Wang

Claude Code国内使用手册

Claude code Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手,于 2024 年发布。它将 Claude 的强大能力带入终端,让你可以用自然语言直接操作文件、执行命令、管理 Git 仓库。 与传统 IDE 插件式的 AI 助手不同,Claude Code 是一个真正的自主 Agent——它不仅能给出代码建议,还能直接执行 shell 命令、编辑多文件、运行测试。它支持 MCP(Model Context Protocol)协议,可以连接外部工具和服务,并允许用户自定义 Skills 来扩展功能。 无论是日常开发、代码审查、重构还是调试,Claude Code 都能成为你的得力助手,尤其适合习惯在终端工作的开发者。 2025年Claude code发布了IDE插件,支持Vscode、Jetbrains等IDE。 安装 npm方式(推荐) npm install -g @anthropic-ai/claude-code 前提条件:需要安装 Node.js(建议 v18 或更高版本)。 国内可用,建议使用npm方式安装 目前官方推荐的方式 macOS / Linux: curl -fsSL https://claude.ai/install.sh | bash Windows (PowerShell): irm https://claude.ai/install.ps1 | iex 安装完成后,运行以下命令验证: claude --version 解析脚本文件,二进制文件在谷歌云,国内无法正常下载 硬核下载方案: # 获取最新版本 https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest # 获取可下载的版本元数据,测试时最新版本为2.1.63 https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/2.1.63/manifest.json # 下载 # mac https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/2.1.63/darwin-x64/claude # windows x64 https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/2.1.63/win32-x64/claude.exe 订阅 官方订阅:锁区,国内无法正常使用 ...

2026-03-22 · Jerry Wang