企业官网建设流程全解析

• AI 技能
• 开发工具
• 人工智能

ai-agent-skills是一个面向 AI coding agents 的通用技能（Skills）安装器与包管理器——一条npx ai-agent-skills命令即可在 12+ 种运行时之间安装、同步和管理 Agent Skills。除了官方精选库之外，它真正被低估的能力是：用init-library命令创建工作区（Workspace Mode），几分钟内搭建一个属于你自己的技能库。本教程将带你从零走完"创建工作区 → 选技能上架 → 批量导入旧库 → 生成文档 → 分享给团队"的完整流程。🚀

什么是 ai-agent-skills 技能库管理器

简单来说，ai-agent-skills做两件事：

• 📦 内置一个人工精选的技能库（house copies + 上游目录条目），可以直接install；
• 🛠️ 提供一套CLI + TUI 工具链，让你构建并管理自己的技能库，即"工作区模式"。

技能库按"货架（Shelves）"组织，默认分为 5 个工作区（work areas），完整地图见 WORK_AREAS.md：

💡 货架越小、越有主见，库才越像"被精心打理过的"。这正是官方策展理念（见 CURATION.md）的核心。

init-library：一条命令创建你的技能库工作区

init-library是工作区模式的入口命令，命令定义见 cli.js，核心实现位于 initLibrary 函数。

最小可用步骤

# 创建一个名为 my-library 的受管工作区 npx ai-agent-skills init-library my-library cd my-library # 确认 CLI 和 TUI 读取的是你的库而不是内置库 npx ai-agent-skills list --area frontend npx ai-agent-skills search react-native

执行后，工作区内会生成 5 个核心文件：

• skills.json—— 目录数据（货架、分支、来源、策展笔记）
• README.md—— 自动生成、可分享的库说明
• WORK_AREAS.md—— 货架地图
• skills/—— 存放本地技能副本
• .ai-agent-skills/config.json—— 工作区配置（标记mode: workspace）

官方对这条流程的完整说明在 docs/workflows/start-a-library.md。

三个常用参数速查

⚠️ 注意两点：重复初始化会被拒绝（Workspace already initialized）；目标目录已存在且非空时也会拒绝覆盖，所以放心执行。

把技能放上货架：add / catalog / vendor 三条路径

工作区内添加技能有明确的三条路径（决策框架见 FOR_YOUR_AGENT.md）：

1️⃣add：默认入口

适合内置精选技能或简单的上游导入，CLI 会自动为你路由：

npx ai-agent-skills add frontend-design \ --area frontend --branch Implementation \ --why "Anchors the frontend shelf with production-ready UI craft."

2️⃣catalog：只登记上游元数据

不复制文件到skills/，只记录"这个上游技能属于哪个货架、哪个分支、为什么入选"，保持库轻量：

npx ai-agent-skills catalog openai/skills --skill linear \ --area workflow --branch Linear \ --why "Plan-driven workflow for issue tracking."

3️⃣vendor：创建可编辑的本地副本

只有当你想真正拥有并修改这份技能时才用：

npx ai-agent-skills vendor <repo-or-path> --skill <name> \ --area <shelf> --branch <branch> --why "Why it deserves a local copy."

📌 官方建议：每次变更（mutation）都带上--area、--branch、--why。--why（即whyHere笔记）应写具体理由，例如"为 mobile 货架补充真机校验能力"，而不是"我觉得好用"。分支命名推荐React Native / UI、Node / APIs这类规范格式，避免stuff、misc。

完整规则可参考内置技能 skills/curate-a-team-library/SKILL.md。

已有技能？用 --import 原地升级成工作区

如果你手里已经有一个"扁平"的技能仓库（一堆skills/<name>/SKILL.md目录），不必推倒重来——直接在仓库根目录原地初始化并批量导入：

cd ~/projects/my-skills npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify npx ai-agent-skills browse

批量导入的底层逻辑在 lib/workspace-import.cjs 中实现。导入后的行为值得了解：

• ✅ 无效名称（如含冒号/下划线的私有命名）会被跳过并报告，不会中断整个批次；
• 🤔 低置信度的技能会回落到workflow货架，并打上needs-curation标签；
• 🔍 用list --area workflow复查回退桶，再用curate手动修正归属：

npx ai-agent-skills list --area workflow npx ai-agent-skills curate some-skill --area mobile \ --branch "Mobile / Testing" --why "Why it belongs."

build-docs 收尾：生成文档并分享给团队

给库加了几个技能后，最后一步永远是重新生成文档——README.md和WORK_AREAS.md都是"受管文件"，不要手改，用命令生成：

npx ai-agent-skills build-docs

安装、同步与日常维护

# 安装到你的项目货架（.agents/skills/） npx ai-agent-skills install frontend-design -p # 技能上游更新后刷新本地 npx ai-agent-skills sync frontend-design -p

默认安装目标：全局~/.claude/skills/，项目.agents/skills/；老式 agent 仍可通过--agent <name>指定（claude、cursor、codex、vscode 等 12 种）。

变成团队共享库

库进入 Git 后，队友一条命令即可安装整个库或某个 collection：

git init && git add . && git commit -m "Initialize skills library" gh repo create <owner>/my-library --public --source=. --remote=origin --push # 分享给队友（有 starter-pack 时优先用它） npx ai-agent-skills install <owner>/my-library --collection starter-pack -p

💡starter-pack 小技巧：当库里有 5~8 个靠谱技能后，创建一个starter-packcollection（添加时用--collection starter-pack，或对已有条目用curate <skill> --collection starter-pack），新成员入职时安装它即可。

常见疑问 FAQ

Q1：工作区模式和直接用内置库有什么区别？内置库是官方策展的精选内容，install即可用；工作区模式则让list、search、browse等命令读取你自己的skills.json，CLI 的一切策展操作都作用在你的库上。

Q2：为什么我的命令提示init-library相关的报错？先检查是否已在管理型工作区根目录重复执行（会提示Workspace already initialized），以及工作区名是否至少包含一个字母或数字（名称会被 slug 化处理）。

Q3：想让 AI agent 帮我建库怎么办？把 FOR_YOUR_AGENT.md 里的"Paste this into your agent"提示词直接贴给 agent，它会按策展协议（建工作区、最多问 3 个问题、先浏览后上架、收尾build-docs）替你完成。

Q4：想先看看会做什么再执行？几乎所有变更类命令都支持--dry-run预览，例如npx ai-agent-skills init-library my-library --dry-run。

总结：你的技能库工作流清单

1. init-library <name>创建工作区（旧库用init-library . --import --auto-classify）
2. list/search/collections先浏览，再策展
3. add/catalog/vendor上架技能，全程带--area--branch--why
4. build-docs重新生成文档
5. 推到 Git，用install <owner>/<repo>与团队共享

从一条命令到一个可共享的团队技能库，init-library工作区模式就是 ai-agent-skills 为你准备的完整工具箱。更多工作流指南：添加上游技能、制作本地副本、组织货架、刷新已装技能。

• AI 技能
• 开发工具
• 人工智能