企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能

本文是面向普通用户的实操型指南。假设你已经完成了仓库安装，本文将从"下一步该做什么"开始，一步步教你理解捆绑包（Bundles）机制、掌握不同 AI 工具的@skill调用语法、写出高质量的技能提示词，并带你完成第一个真实技能调用，最终具备独立规划、编排并安全使用整个技能库的能力。

安装后第一件事：理解"技能在等待被调用"

很多人在安装完成后会感到困惑："我已经安装了仓库，接下来该做什么？" 答案是：你已经拥有了全部技能文件，但它们都在等待被你调用。

你刚刚做了什么

当你运行npx agentic-awesome-skills或克隆仓库时，你实际上完成了三件事：

• ✅下载了 2,000+ 个技能文件到你的计算机。默认路径为~/.agents/skills/；如果你使用了--path参数，则落在自定义路径（如~/.agent/skills/）。
• ✅使它们对你的 AI 助手可用。
• ❌并未自动启用所有技能——它们只是静静地躺在那里等待使用。

关于技能总数，不同版本与文档口径略有差异：原使用指南写作时提及 1,936+ 个技能，而当前仓库的 package.json 中的描述为 "2,126+ agentic skills"，docs_zh-CN/users/bundles.md 末尾标注"总技能数：1,936+、编辑捆绑包数：59"。可以把它理解为一个持续增长的技能库，具体以你安装的仓库版本为准。

把它想象成安装一个工具箱：你现在拥有所有工具，但你需要为每项工作选择使用哪些工具。技能不会自动"运行"，只有当你在对话中显式点名（@skill-name）时，AI 才会读取对应的SKILL.md文件并按其中的操作手册执行。

验证你的安装

安装后可以用几种方式快速确认技能确实就位：

# 查看实际安装路径下的技能目录（默认路径） ls ~/.agents/skills/ # 查看仓库内规范技能清单（可用于发现技能） ls skills/ | head -20

仓库根目录下的 skills_index.json 是技能的规范轻量级清单，包含id、path、category、name、description、risk、source、date_added等元数据字段。例如brainstorming技能在清单中的条目是：

{ "id": "brainstorming", "path": "skills/brainstorming", "category": "uncategorized", "name": "brainstorming", "description": "Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.", "risk": "critical", "source": "community", "date_added": "2026-02-27" }

id就是你在对话中@mention时使用的标识符，path则指向包含SKILL.md的目录。

步骤 1：理解"捆绑包"（Bundles）—— 这不是另一次安装

常见困惑："我需要分别下载每个技能吗？"

答案：不需要！捆绑包不是另一层安装，而是按角色分组的技能推荐清单。

捆绑包是什么

捆绑包是按角色组织的技能推荐列表，帮助你决定从 2,000+ 个技能中优先开始使用哪些：

• 你安装的是一个包含全部技能的工具箱（✅ 已完成）。
• 捆绑包就像贴有标签的整理托盘，上面写着："如果你是木匠，从这 10 个工具开始"。
• 你通常从捆绑包中选择技能；维护者也可以把它们用作插件子集或 Antigravity 激活预设。

捆绑包不是什么

• ❌ 可调用的单个超级技能
• ❌ 与技能本身不同的内容格式
• ❌ 大多数用户每天都必须单独管理的东西
• ❌ 可调用的超级技能，如@essentials或/web-wizard

注意：docs_zh-CN/users/bundles.md中明确提示："捆绑包不是可调用的大型技能……在对话中仍应调用包中列出的各个技能。" 也就是说，你调用的是包里的@react-best-practices这样的具体技能，而不是捆绑包本身。

示例："Web Wizard" 捆绑包

当你看到 Web Wizard 捆绑包 时，它列出了：

• frontend-design
• react-best-practices
• tailwind-patterns
• 等等

这些是关于 Web 开发人员应该首先尝试哪些技能的推荐。它们已经安装了——你只需要在你的提示词中使用它们。

使用激活脚本将捆绑包作为"活动子集"

如果你希望一次只激活一个捆绑包（例如在 Antigravity 中让~/.agents/skills/只保留该包内的技能），请使用仓库提供的激活脚本，而不是尝试直接调用捆绑包名称：

# macOS / Linux ./scripts/activate-skills.sh --clear Essentials ./scripts/activate-skills.sh --clear "Web Wizard"

:: Windows .\scripts\activate-skills.bat --clear Essentials

从 scripts/activate-skills.sh 的源码可以看到其工作方式：

• --clear参数会触发[RESET]流程：将现有~/.agents/skills/下内容归档到skills_archive_<时间戳>目录，再从skills_library中恢复所选技能；不带--clear则是在现有文件夹上**叠加（APPEND）**新技能。
• 脚本默认展开Essentials捆绑包（无参数时），其回退清单为：concise-planning、git-pushing、kaizen、lint-and-validate、systematic-debugging。
• 展开捆绑包依赖tools/scripts/get-bundle-skills.py，你可以通过AG_BASE_DIR、AG_SKILLS_DIR、AG_LIBRARY_DIR、AG_REPO_SKILLS_DIR等环境变量覆盖默认目录。
• 脚本对传入的 skill id 做了安全校验（is_safe_skill_id只允许A-Za-z0-9._-与/组成的路径，并拒绝.、..、/.），对目录符号链接也做了越界检查，避免把源目录外的内容拷入。

步骤 2：如何实际执行 / 使用技能

这是整个使用过程中最需要讲清楚的部分：只需在与 AI 助手的对话中提及技能名称，AI 便会加载对应技能并按其指引执行。确切的语法因工具而异，但总是很简单：

专业提示：大多数现代工具使用@skill-name语法。如有疑问，先试试这个！

Gemini CLI 特别提示：如果 Gemini CLI 在几轮对话后开始挂起，请尝试新开一个对话，并暂时将活动集减少到只有 2-5 个技能，以排除上下文增长的问题。

安装时也可以针对具体工具指定安装方式。根据 docs_zh-CN/users/getting-started.md，npx agentic-awesome-skills支持--cursor、--claude、--gemini、--codex、--kiro、--antigravity、--agy等参数为特定工具安装，并用--path <dir>指定自定义位置；--risk、--category、--tags可缩小安装范围。若技能未被识别，也可尝试显式路径：npx agentic-awesome-skills --claude（或--cursor、--gemini等）。

步骤 3：我的提示词应该是什么样的？

技能的使用效果高度依赖提示词质量。以下是真实示例的良好提示词：

示例 1：开始一个新项目

糟糕的提示词：

"Help me build a todo app"

良好的提示词：

"Use @brainstorming to help me design a todo app with user authentication and cloud sync"

为什么更好：你明确调用了技能并提供了上下文。

示例 2：审查代码

糟糕的提示词：

"Check my code"

良好的提示词：

"Use @lint-and-validate to checksrc/components/Button.tsxfor issues"

为什么更好：特定技能 + 特定文件 = 精确结果。

示例 3：安全审计

糟糕的提示词：

"Make my API secure"

良好的提示词：

"Use @api-security-best-practices to review my REST endpoints inroutes/api/users.js"

为什么更好：AI 知道确切要应用哪个技能的标准。

示例 4：组合多个技能

良好的提示词：

"Use @brainstorming to design a payment flow, then apply @stripe-integration to implement it"

为什么好：你可以在单个提示词中链接技能！

步骤 4：你的第一个技能（动手教程）

让我们现在实际使用一个技能，目标是规划一个新功能：

1. 选择一个技能：使用brainstorming（来自 "Essentials" 捆绑包）。
2. 打开你的 AI 助手（Claude Code、Cursor 等）。
3. 输入这个确切的提示词：

Use @brainstorming to help me design a user profile page for my app

4. 按 Enter 键。
5. 接下来会发生什么：
   • AI 加载brainstorming技能
   • 它将开始向你提出结构化问题（一次一个）
   • 它将引导你完成理解、需求和设计
   • 你回答每个问题，它构建完整的规范
6. 结果：你最终会得到一个详细的设计文档——还没有写一行代码！

如果你想了解这个技能"背后发生了什么"，可以直接阅读技能本体 skills/brainstorming/SKILL.md。它的前置元数据声明了risk: critical（即会引导 AI 进入工作状态、产出设计文档的技能），正文则定义了完整的运行模式：技能激活期间不允许实现、编码或修改行为，AI 以"设计促进者与资深评审者"身份工作，第一步强制"理解当前上下文"，然后一次一个问题地澄清想法，最后产出经过验证的设计规格。这正是你在对话中看到"结构化提问"的来源。

步骤 5：选择你的前几个技能（实用建议）

不要试图一次使用所有技能。这里有一个明智的分层策略：

0. 需要工具特定起点时

如果在选择技能之前你需要特定于工具的起点，请使用：

• Claude Code 技能
• Cursor 技能
• Codex CLI 技能
• Gemini CLI 技能

1. 从 "Essentials" 开始（5 个技能，每个人都需要）

1. @brainstorming- 在构建之前规划
2. @lint-and-validate- 保持代码整洁
3. @git-pushing- 安全地保存工作
4. @systematic-debugging- 更快地修复错误
5. @concise-planning- 组织任务

如何使用它们：

• 在编写新代码之前 →@brainstorming
• 编写代码之后 →@lint-and-validate
• 在提交之前 →@git-pushing
• 当卡住时 →@systematic-debugging

2. 然后添加特定于角色的技能（再添加 5-10 个）

在 bundles.md 中找到你的角色，并从该捆绑包中选择 5-10 个技能。

Web 开发人员示例：

• @frontend-design
• @react-best-practices
• @tailwind-patterns
• @seo-audit

安全工程师示例：

• @api-security-best-practices
• @vulnerability-scanner
• @ethical-hacking-methodology

3. 最后，按需添加即时技能

将 CATALOG.md 保持打开作为参考。当你需要特定的东西时：

"我需要集成 Stripe 付款" → 搜索目录 → 找到@stripe-integration→ 使用它！

完整示例：端到端构建功能

让我们通过一个现实场景，把前面的知识串起来——任务："为我的 Next.js 网站添加博客"。

步骤 1：规划（使用 @brainstorming）

You: Use @brainstorming to design a blog system for my Next.js site AI: [询问关于需求的结构化问题] You: [回答问题] AI: [生成详细的设计规范]

步骤 2：实现（使用 @nextjs-best-practices）

You: Use @nextjs-best-practices to scaffold the blog with App Router AI: [创建文件结构，设置路由，添加组件]

步骤 3：样式（使用 @tailwind-patterns）

You: Use @tailwind-patterns to make the blog posts look modern AI: [应用 Tailwind 样式和响应式设计]

步骤 4：SEO（使用 @seo-audit）

You: Use @seo-audit to optimize the blog for search engines AI: [添加 meta 标签、站点地图、结构化数据]

步骤 5：测试和部署

You: Use @test-driven-development to add tests, then @vercel-deployment to deploy AI: [创建测试，设置 CI/CD，部署到 Vercel]

结果：使用最佳实践构建的专业博客，无需手动研究每个步骤！这正是"工作流"的价值所在——workflows.md 中定义了一整套可执行的端到端剧本（如"发布 SaaS MVP""Web 应用安全审计""构建 AI 代理系统"），将多个技能按顺序编排成一个完整流程。如果你希望以"流程"而不是"单点技能"的方式推进任务，可以从工作流开始。

技能发现与上下文安全：为什么不要一次加载所有技能

一个非常常见的问题："我可以一次将所有技能加载到模型中吗？"

不可以。即使你本地安装了全部技能，你不应该将每个SKILL.md连接到单个系统提示词或上下文块中。2,000+ 个技能文档会迅速填满模型的上下文窗口，导致截断甚至崩溃（在 Jetski/Cortex + Gemini 这类宿主上会表现为TrajectoryChatConverter: could not convert a single message before hitting truncation）。

预期的设计模式是：

• 使用根目录 skills_index.json（规范清单）来发现存在哪些技能——它只含元数据，体积轻量；仅在宿主必须读取data/子树时使用 data/skills_index.json 兼容性镜像；
• 仅为你实际在对话中使用的特定@skill-id值加载对应的SKILL.md文件（延迟加载）。

如果你正在构建自己的宿主 / 代理（例如 Jetski/Cortex + Gemini），docs_zh-CN/integrations/jetski-cortex.md 提供了完整的集成伪代码与安全约束，核心要点包括：

• 轻量级清单：启动时读取skills_index.json构建id -> meta映射，不加载全文。
• 消息解析：用正则/@([a-zA-Z0-9-_./]+)/g从用户 / 系统消息中提取所有@skill-id引用。
• 延迟加载：仅针对解析出的 id 读取SKILL.md（fullPath = path.join(SKILLS_ROOT, meta.path, "SKILL.md")），并设置maxSkillsPerTurn上限（建议每轮 5-10 个）。
• 溢出策略：设置上下文窗口 70-80% 的安全阈值；超限时减少技能数量，或通过overflowBehavior: "error"明确报错而不是静默截断。
• 路径安全：读取前验证解析出的路径始终位于SKILLS_ROOT之内。

常见问题

"我应该使用哪个工具？Claude Code、Cursor、Gemini？"

任何一个都可以！技能通用适用。选择你已经使用或喜欢的工具：

• Claude Code- 最适合终端 / CLI 工作流
• Cursor- 最适合 IDE 集成
• Gemini CLI- 最适合 Google 生态系统
• Codex CLI- 最适合 OpenAI 生态系统

"我可以查看所有可用的技能吗？"

可以！三种方式：

1. 浏览 CATALOG.md（可搜索列表）
2. 运行ls ~/.agents/skills/（或你的实际安装路径）
3. 询问你的 AI："你有哪些关于[主题]的技能？"

"安装后我需要重启 IDE 吗？"

通常不需要，但如果你的 AI 无法识别技能：

1. 尝试重启你的 IDE / CLI
2. 检查安装路径是否与你的工具匹配
3. 尝试显式路径：npx agentic-awesome-skills --claude（或--cursor、--gemini等）

"技能和 MCP 工具有什么区别？"

• 技能是可复用的SKILL.md剧本，用于指导 AI 助手完成工作流。
• MCP 工具是集成或可调用功能，让助手能够与外部系统交互。

当你想要更好的流程、结构和执行质量时使用技能；当你需要访问 API、服务、数据库或其他系统时使用 MCP 工具。详细对比可阅读 skills-vs-mcp-tools.md。

"我可以创建自己的技能吗？"

可以！使用@skill-creator技能：

Use @skill-creator to help me build a custom skill for [your task]

"如果技能没有按预期工作怎么办？"

1. 直接在安装路径中检查技能的SKILL.md文件，例如：~/.agents/skills/[skill-name]/SKILL.md
2. 阅读描述以确保你正确使用它
3. 在本仓库的 Issues 页面提交问题，并提供详细信息（技能名、使用工具、复现步骤）

"这些技能如何避免溢出模型上下文？"

一些主机工具（例如基于 Jetski/Cortex + Gemini 构建的自定义代理）可能想将每个SKILL.md连接到单个系统提示词中，这不是设计的使用方式，几乎肯定会溢出上下文窗口。正确做法是：使用根目录 skills_index.json 作为规范轻量级清单进行发现；仅在调用技能时（例如通过对话中的@skill-id）加载单个SKILL.md文件。详见 docs_zh-CN/integrations/jetski-cortex.md。

"这些技能有风险吗？"

每个SKILL.md的前置元数据中都包含risk:字段，用于标注风险等级：

• ⚪unknown：遗留或未分类内容，使用前需手动检查
• 🟢none：纯参考或规划内容——无 shell 命令、无变更、无网络访问
• 🔵safe：非破坏性指导，如只读命令、规划、代码审查和分析
• 🟠critical：会修改文件、删除数据或执行破坏性操作的技能，谨慎使用
• 🔴offensive：渗透测试等进攻性技术，仅限授权使用，必须确认目标在范围内

快速参考卡

保存此内容以供快速查找：

下一步

既然你了解了如何使用技能：

1. ✅现在就尝试一个技能- 从@brainstorming开始，尝试任何想法
2. 📚从你的角色捆绑包中选择 3-5 个技能，来自 bundles.md
3. 🔖将CATALOG.md加入书签，当你需要特定东西时使用
4. 🎯从workflows.md尝试一个工作流，以获得完整的端到端流程

最大化效果的专业提示

提示 1：使用 @brainstorming 开始每个功能

在编写代码之前，使用@brainstorming进行规划。你将节省数小时的重构时间。

提示 2：按顺序链接技能

不要试图一次完成所有事情。按顺序使用技能：规划 → 构建 → 测试 → 部署

提示 3：在提示词中具体化

糟糕："Use @react-patterns" 良好："Use @react-patterns to build a modal component with animations"

提示 4：引用文件路径

帮助 AI 专注："Use @security-auditor on routes/api/auth.js"

提示 5：组合技能以完成复杂任务

"Use @brainstorming to design, then @test-driven-development to implement with tests"

提示 6：把技能清单当作"路由表"，而不是"全量内存"

让 AI 用 skills_index.json 或 CATALOG.md 做技能发现，按需加载对应SKILL.md——这是让 2,000+ 技能与有限上下文窗口共存的关键。

仍然困惑？

如果有些东西仍然不合理：

1. 查看 FAQ
2. 查看 真实示例
3. 在本仓库发起 Discussion 或 Issues，帮助我们改进此指南！

记住：你并不孤单！这个项目的全部意义是让 AI 助手更易于使用。如果本指南没有帮助，请告诉我们，以便我们修复它。

• AI 技能
• AI 插件
• 人工智能