企业官网建设流程全解析

很多朋友最近大概率被同一件事刷了屏：GitHub 上各种skills仓库突然火了起来，一堆人开始往 Claude Code 里装“技能包”。作为一个从 Claude Code 早期版本就开始折腾的老用户，我忍不住想聊清楚一件事——Claude Code 的技能到底怎么装、怎么用、怎么玩出花来，而不是照着 README 敲两行命令就完事。

先说结论：Claude Code 的“技能（Skills）”本质上就是一组有固定结构的提示词工程文件，它把某类任务的执行方法、检查清单、注意事项打包成一个目录，让 Claude 在做同类事情时不用每次都临时摸索，而是直接调用这套成熟流程。你可以把它理解成给 Claude 配了一本“工作手册”，遇到对应场景就翻开照着做。这篇内容就围绕“如何安装技能”展开，从环境准备、安装方式、自定义开发一直讲到常见问题排查，希望能帮你少踩几个我踩过的坑。

1. Claude Code 和“技能”到底解决什么问题

1.1 先搞懂 Claude Code 是什么

Claude Code 是 Anthropic 推出的终端（命令行）编程助手，它跑在本地终端里，可以读取你的代码仓库、执行命令、修改文件、运行测试，然后把你需要用自然语言描述的开发任务变成一系列实际动作。换句话说，你平时在 IDE 里靠插件和手动操作完成的活儿，在终端里用对话就能驱动。

但这东西和普通的“聊天式代码助手”有个非常明显的区别：它不是一个只能“给建议”的问答机器人，而是真的能动手。它能读取项目结构、搜索文件、执行 Shell 命令、在编辑器里改代码，整个过程你来审核、它来执行。正因为这种“能动手”的特性，它才非常适合挂载技能包——因为技能包的本质，就是告诉它“在某种场景下，按照什么步骤、什么标准、什么顺序去做事”。

拿我自己的实际体验举例：我常用 Claude Code 处理仓库里的重复性重构任务，比如把某个模块的错误处理从 return null 改成抛出统一异常。在没有技能包之前，每次我都得把格式要求、边界情况、注意事项重新描述一遍，偶尔还会漏掉某些细节。后来我把这套重构流程写成了一个技能，现在只需要说一句“按重构技能处理 payment 模块”，它就会自动按我设定的步骤推进，效率差别非常明显。

1.2 “技能”在 Claude Code 里到底指什么

关于“技能”这个概念，社区里最容易出现理解偏差。我见过不少人把 Claude Code 的技能和 Cursor 里的 Rules、或者是传统 IDE 里的代码模板混为一谈，其实它们虽然有相似之处，但底层逻辑完全不同。

在 Claude Code 的语境下，一个“技能”通常是一个独立的目录，里面包含：

• SKILL.md：这是核心文件，用 Markdown 编写，描述这个技能是干什么的、在什么时候启用、有哪些执行步骤和约束规则。
• 一些辅助文件：可能是参考数据、示例代码、模板文件、检查清单等等，帮助 Claude 在执行技能时能有更充分的上下文。

关键点在于：技能不是一段写死的代码，而是一套“可被模型理解和执行的指令集”。它利用了 Claude 这类大模型对自然语言的理解能力，把流程化的任务通过描述性文本固化下来。这样做的收益很直接：

• 不需要每次重新描述需求，省时间。
• 执行标准统一，避免每次结果参差不齐。
• 容易分享，一个技能目录拷给别人就能用。

如果你写过 OpenAI 的 Function Calling 或者搞过 Agent 的 Prompt 工程，你会发现 Claude Code 的 Skill 思路在其中有很多相似的影子，只是更产品化、更开箱即用。

对我来说，理解这层逻辑是安装和开发技能的前提。否则你很容易把技能当成“插件”，以为装上就有魔法，等到它不生效的时候又不知道从哪里排查。

2. 安装前的准备工作与基础安装

2.1 环境要求与前置准备

在安装 Claude Code 和技能之前，先确认你的环境是否满足基本条件。我踩过的最大坑就是环境不匹配导致后面的步骤连环报错，所以这里专门列一个检查清单：

• Node.js 版本：Claude Code 官方提供 npm 安装方式，Node.js 建议 18 或更高版本。如果你还在用 14、16 这种老版本，建议先升级，否则安装过程中容易报引擎不兼容的错误。
• 操作系统：官方支持 macOS、Linux、Windows（Windows 建议使用 WSL 或 Git Bash 环境，原生 cmd/PowerShell 下体验会差一些）。我自己在 Windows 上折腾过一段时间，最终还是切到了 WSL 里跑，原因后面说。
• 网络环境：需要能正常访问 npm 和 Anthropic 的 API 服务，这是基础前提。
• API 凭据：你要准备好 Anthropic API Key，或者有 Claude Pro/Max 订阅账号并完成登录授权。首次启动时它会引导你完成登录。

这里多说一句 Windows 原生环境的问题：Claude Code 在 Windows 下能跑，但一些技能脚本如果依赖 bash 命令，在 cmd 和 PowerShell 里经常出幺蛾子。我遇到过某次装了一个依赖 Shell 管道的技能，在 PowerShell 下调了半天没反应，切到 WSL 后秒好。所以如果你打算长期使用，我非常推荐在 WSL 环境里跑。

2.2 安装 Claude Code 的几种方式

Claude Code 的安装方式比较常规，最主流的是通过 npm 安装：

npm install -g @anthropic-ai/claude-code

装完后在终端输入claude就能启动交互式界面。首次启动会引导你完成登录和授权，流程基本是全自动的。

不想用 npm 的话，还可以用官方安装脚本：

curl -fsSL https://claude.ai/install.sh | bash

这个方式适合想图省事的情况，本质还是帮你把 npm 包装上，只是省掉了手动敲命令这一步。

如果你更希望以桌面客户端的方式使用，Anthropic 也推出了 Claude Code 的桌面版，从官网下载对应操作系统的安装包安装即可。桌面版的本质是给终端版套了一层图形界面外壳，核心能力和终端版一致，但日常操作更直观，适合不习惯命令行的人。

卸载方式同样很简单：

npm uninstall -g @anthropic-ai/claude-code

这个命令会把 Claude Code 从全局依赖里移除，配置文件和本地数据（比如对话历史、技能目录）不会自动删除，如果你也想清理干净，需要手动删除对应的配置目录。

2.3 基础配置与模型连接

安装完成后，第一件事是确认它能正常连接模型。运行claude后，它会检查你的登录状态。如果你提前设置过环境变量，它也会自动读取。

常见的配置项目有这么几个：

• ANTHROPIC_API_KEY：直接设置 API Key 环境变量，适合脚本化调用。
• ANTHROPIC_MODEL：指定默认使用的模型版本，默认是 Claude 系列最新的 Sonnet 或 Opus，具体取决于你的账号权限。
• CLAUDE_CONFIG_DIR：配置文件存放目录，技能目录的根路径也在这里，默认是~/.claude。

配置完成后，建议先跑一个最简单的对话测试一下，比如让它“读一下当前目录结构”，确认它能正常工作再往下进行。

注意：技能安装之前，建议先确认 Claude Code 基础功能完整可用。因为很多技能安装过程中的报错其实是基础配置没到位，而不是技能本身的问题。

3. 安装技能（Skills）的完整实操

3.1 技能的存放位置与管理方式

一旦 Claude Code 正常工作，下一步就是安装技能。这里先科普一个核心概念：技能目录（skills directory）。

Claude Code 会从特定位置扫描技能目录，每个技能以子文件夹的形式存在。默认的技能根目录在~/.claude/skills（对应官方文档中的 plugin 配置），不过自定义技能也支持放在项目本地，比如.claude/skills。

我自己常用的管理思路是“全局技能 + 项目技能”双层结构：

• 全局技能（~/.claude/skills/）放一些跨项目通用的能力，比如“代码审查”“提交信息规范”“重构流程”，任何项目都能用。
• 项目技能（.claude/skills/）放当前项目专属的流程，比如“数据库迁移流程”“本项目的部署规范”，跟着仓库走。

这两层技能是并存关系，Claude 在执行任务时会同时考虑它们，不会互相覆盖。具体的优先级规则我后面讲。

3.2 从 GitHub 技能库安装技能

现在社区已经有大量现成的技能库，GitHub 上搜claude skills就能找到一堆。安装方式没有统一的包管理器，最通用的做法就是 git clone 或直接下载 ZIP，然后把对应目录放到技能目录里。

我以安装一个 GitHub 上的技能为例子，完整操作如下：

# 1. 进入技能根目录 cd ~/.claude/skills # 2. 克隆技能仓库 git clone https://github.com/example/some-claude-skill.git

克隆完成后，检查一下目录结构，确保它符合 Claude Code 能识别的格式。一个标准的技能目录应该是这样的：

some-claude-skill/ ├── SKILL.md ├── reference/ │ └── details.md └── scripts/ └── helper.py

最关键的就是SKILL.md必须存在且命名准确。如果你发现仓库里没有这个文件，说明它可能不是标准的 Claude Code 技能，或者是老旧格式，装进去很可能不生效。

装好之后，重启 Claude Code，然后用自然语言测试这个技能是否被识别。你可以直接问“你现在有哪些技能”，或者用与技能相关的关键词触发它。如果技能正常加载，Claude 会按SKILL.md里的规则响应。

这里分享一个经验：很多“技能安装”所谓的失败，其实是目录结构不对。比如有人把技能根目录直接放到了~/.claude/skills里，导致 Claude 把整个仓库当成了一个技能，无法识别内部文件。正确做法是每一个技能占一层子目录，结构是skills/skill-name/SKILL.md，不是skills/SKILL.md。

3.3 手写一个自定义技能

社区技能库虽然多，但真正贴合自己工作的，大概率还得自己写。好在自定义技能的难度很低，本质上就是写 Markdown。

一个最小可用的技能目录，只需要一个SKILL.md文件。比如我写一个“代码提交信息规范化”技能：

--- name: commit-message description: 根据代码变更内容，生成符合 Conventional Commits 规范的提交信息。 --- # Commit Message 规范化 当用户要求生成提交信息，或需要提交代码时，使用本技能。 ## 执行步骤 1. 读取 git diff，分析变更内容。 2. 根据变更类型确定 type（feat/fix/docs/style/refactor/perf/test/build/ci/chore）。 3. 使用祈使句，不超过 50 个字符。 4. 如果有 breaking change，在正文中注明。 5. 输出完整的 git commit 命令供用户确认。 ## 注意事项 - 不要修改用户的代码。 - 如果变更同时包含多个类型，按主要变更选择 type。 - 拿不准类型时，优先使用 refactor。

把以上内容保存为~/.claude/skills/commit-message/SKILL.md，重启后这个技能就生效了。

SKILL.md里最核心的是 YAML Front Matter 里的name和description，尤其是description。Claude Code 判断什么时候启用哪个技能，很大程度上靠这个描述字段和用户意图做匹配。所以描述要写得明确、关键词丰富，忌讳太笼统。比如“处理代码”这种描述就没什么用，而“根据 git 变更生成 Conventional Commits 规范的提交信息”就很清晰。

其实，如果你不想自己从零开始写，完全可以找一个现成的技能，照着它的格式改一改，把内容替换成自己的流程——这是我最推荐的上手路径。

4. 实战中使用技能的正确姿势

4.1 技能调用与上下文管理

安装完技能后，最大的疑问通常变成：技能到底怎么“被调用”？是像函数一样输入名字吗？还是要写特殊命令？

从我的实测来看，Claude Code 的技能触发机制比大部分人想象的更“自然语言化”。你不需要@skill-name这种显式的调用语法（当然某些版本支持类似的显式触发，但并不是必须），直接说你的需求，Claude 会根据当前对话和技能描述自动匹配。

举例来说，假设我安装了“数据库迁移”技能，我可以直接说“帮我把 orders 表加一个 status 字段”，Claude 如果判断这个需求命中“数据库迁移”的描述，就会自动应用这个技能的执行步骤，而不会先去改代码。

不过这里有个容易被忽视的点：技能触发取决于上下文匹配，而不是你说了就一定会触发。如果你发现技能没生效，最常见的原因是描述写得太泛，或者当前需求关联度不够高。这种情况下，你可以主动在对话里点名技能，比如说“使用数据库迁移技能处理 orders 表变更”，引导作用非常明显。

4.2 组合技能完成真实任务

单个技能解决单一场景，但真实开发往往是多个场景叠加。Claude Code 支持多个技能协同工作，这比一个个独立调用有意思得多。

举一个我刚才实际跑通的场景。我开发一个小工具库时，提交了一个新功能分支，想把变更推到远端并发起合并请求。过程中我同时使用了三个技能：

• “代码审查”技能：先扫描本次变更的 diff，找出潜在问题并自动修复。
• “测试生成”技能：为新增函数补充单测。
• “提交信息规范”技能：生成符合格式的 commit message。

整个流程我没有重新描述任何步骤规则，只是依次说“审查一下当前改动”“为新函数补个测试”“生成提交信息”，Claude 自动匹配到了对应技能并按照各自的流程执行。

这个体验的关键点是：技能之间没有强耦合，它们是“按需激活”的。只要你把每个技能的边界描述清楚，Claude 在复杂的多环节任务中也能自动判断何时套用哪个流程。

4.3 记忆技能与长期使用

在 Claude Code 的生态里，除了普通的任务型技能，还有一类被叫做“记忆技能”的东西引起了不少关注。所谓记忆技能，就是让 Claude 跨会话记住你的偏好、项目背景、常用决策，而不是每次对话都从零开始。

我自己的用法是维护一个“项目背景记忆”技能，里面记录了当前项目的一些固定信息：

• 项目的技术栈和关键依赖。
• 命名规范，比如常量用 UPPER_CASE，组件用 PascalCase。
• 已知技术债和注意事项。
• 发布流程和回滚策略。

这些内容放在SKILL.md里，描述写成“需要了解项目背景或做出技术决策时使用”。之后每次新开会话，只要涉及项目细节，Claude 就会自动读取这份背景信息，不用我再反复重复。这种做法比硬塞一个超大的 CLAUDE.md 更灵活，因为这个背景只在相关场景下才会被加载，日常简单对话不会被无关历史影响。

如果你刚开始用，我建议先建一个自己的项目背景记忆技能，把平时最容易重复交代的东西写进去，很快就能体会到差异。

5. 常见问题与排查技巧

5.1 技能不生效怎么办

技能没反应，在我收到的反馈里是最常见的问题，没有之一。按照我自己排查的经验，优先级从高到低应该是下面这样：

对于第一条，我再强调一下：检查路径是最快的方式。很多技能仓库会把源码放在src/或者有子目录嵌套，如果你只把整个仓库直接拷到skills下，SKILL.md并没有出现在技能根目录下，Claude 就没法识别。

查看 Claude Code 是否识别到技能，可以在对话中直接问它“你现在能用哪些技能”，如果列出来的结果里没有你刚装的技能，大概率就是上面表中的前两行问题。

5.2 安装过程中常见坑

装技能本身不复杂，但网络上分享的技能质量参差不齐，我给大家几个判断标准。

• 看更新时间：一年以上没更新的技能仓库，大概率是旧版格式，兼容性存疑。
• 看 SKILL.md 的 Front Matter：没有name和description字段的，多半不是正规技能。
• 看依赖脚本：如果技能引用了外部脚本或者 Python 包，要注意有没有写明安装依赖。我之前装过一个技能，里面调用了requests库，我环境里偏偏没装，结果技能每次跑到一半就崩了。

装完技能后，我也建议大家养成一个习惯：先小成本验证，再大规模使用。比如装完一个代码审查技能，先拿一个小文件试运行，而不是直接丢一个几百行的大仓库进去跑。等确认输出符合预期，再放心用。

5.3 卸载技能与清理痕迹

技能卸载比较容易，直接删除对应目录即可：

rm -rf ~/.claude/skills/commit-message

删除后重启 Claude Code，技能就消失了。没有什么注册表之类的残留问题。

如果你有这个强迫症，想确认技能真的被移除了，用前面说的方法在对话中问一句“你现在有哪些技能”就行。

还有个小细节：如果你用桌面版客户端，删除技能后需要退出重进一下，桌面版不会像终端版那样每次启动都重新扫描。

6. 从使用到维护：技能生态的下一步

装技能只是入门，真正让技能发挥价值的是持续维护。我自己的习惯是每过一段时间就审视一下现有技能：

• 哪个技能最近完全没被触发过？如果是描述有问题，改描述；如果确实是流程过时了，删掉。
• 哪个任务连续手动操作了好几次？说明这个场景值得固化成新技能。
• 发现某个技能和其他技能开始重复？合并它们，明确边界。

这种“从使用到维护”的节奏，能让技能库始终贴合真实工作流。别忘了，技能的核心价值不是“装得越多越好”，而是“在正确场景下稳定复用”。一个精准描述、边界清晰的技能，胜过十个泛泛而谈的模板。

最后，如果你刚开始折腾，不要追求一上来就装几十个技能。先挑一个你日常最高频、最重复、最不想要动脑的任务，把它写成技能，用起来，再慢慢扩展。慢慢试下来你会发现，真正不能被替代的不是技能本身，而是你对这些任务的理解和沉淀被完整地保存了下来。