Agentic Awesome Skills 常见问题全解安装路径、风险标签、调用方式与故障排查实战指南【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills本篇指南围绕 Agentic Awesome SkillsAAS官方 FAQ越南语版 FAQ.vi.md展开系统回答关于 Skills 概念、多工具安装、风险分级、调用方式、更新维护与贡献规范的高频问题并结合作品仓库内安装器源码与真实 SKILL.md 结构给出可验证的实操依据。读完本文你将能明确判断自己的 AI 工具该把 Skills 装到哪个目录、如何用skill-id正确调用、如何通过 Risk Labels 甄别高危技能以及遇到AI 不识别技能PR 未通过质量检查时如何快速定位并解决。一、Skills 到底是什么FAQ 通用问题精讲1.1 Skills技能的确切定义FAQ 给出了一个通俗而准确的定义Skills 是教 AI 助手处理特定任务的专用指令文件可以把它们理解为一组可随时按需加载的专家知识模块。类比现实生活就像你会在不同场景咨询律师、医生或机械师一样这些 Skills 让 AI 在需要时成为不同领域的专家。在仓库中每个 Skill 就是一个目录下的SKILL.md文件。以 skills/brainstorming/SKILL.md 为例它的 YAML frontmatter 包含name、description、risk、source、date_added等字段正文则完整定义了该技能的 Purpose、执行流程、退出条件和关键原则——这正是 FAQ 中技能就是指令文件说法的直接证据。1.2 我需要把 2000 个 Skills 全部安装吗不需要。当仓库被安装后所有 Skills 都是可用状态但 AI 只会在你通过skill-name显式请求时才加载它们。FAQ 用了一个很好的比喻就像一座图书馆所有书都在书架上但你只读自己需要的那些。补充两个官方建议来自 FAQ 与英文原版 docs/users/faq.md使用 Starter Packs 入门包 只安装符合你角色需要的子集在英文原版 FAQ 中还有更进一步的工程化约束不要把所有SKILL.md拼接进单个 system prompt这几乎必然撑爆模型上下文窗口。正确做法是把 skills_index.json 作为发现用的规范清单仅在技能被调用如对话中出现skill-id时才加载单个文件。相关契约见 schemas/skills-index.v1.schema.json。1.3 哪些 AI 工具可以使用这些 SkillsFAQ 明确列出的兼容工具包括✅Claude CodeAnthropic 的命令行工具✅Gemini CLIGoogle✅Codex CLIOpenAI✅CursorAI 集成 IDE✅Antigravity IDE✅OpenCodeGitHub Copilot通过 GitHub CLI 的gh skill处于 preview 支持状态对 CopilotFAQ 特别提醒仓库同时存在 canonical 与 mirror 版本必须使用准确的路径只有确定要安装所有发现的技能时才使用--allgh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent github-copilot --scope user --pin v14.2.0英文原版 FAQ 还补充了Kiro CLI / IDEAmazon与AdaL CLI并注明 Copilot 为部分支持复制粘贴方式。1.4 免费吗离线可用吗免费。仓库采用 MIT 许可个人使用免费、商业使用免费、允许修改。英文原版补充了细节原创代码与工具按 MIT 许可见 LICENSE原创文档与非代码内容按 CC BY 4.0 许可见 LICENSE-CONTENT。离线方面Skill 文件本身存储在你的本地电脑上但 AI 助手运行仍需联网。二、安全与信任Risk Labels 风险标签体系2.1 Risk Labels风险标签代表什么AAS 对每个技能做了风险分级这些值直接映射到每个SKILL.mdfrontmatter 的risk:字段。在 skills/brainstorming/SKILL.md 中可以看到risk: critical的真实写法。分级含义如下标签含义使用建议⚪unknown旧内容或尚未分类使用前手动审查技能none纯参考或规划类内容无 shell 命令、无状态变更、无网络访问可放心使用safe非破坏性指导如只读命令、规划、代码审查、分析常规可用critical会修改文件、删除数据、使用网络扫描器或执行破坏性操作务必谨慎offensive安全攻防技术渗透测试、漏洞利用仅限授权场景且必须确认目标在允许范围内2.2 这些 Skills 会黑掉我的电脑吗不会直接执行。Skills 本质是文本文件但它们会指导AI 运行命令——如果技能内容写着删除所有文件一个顺从的 AI 可能会真的尝试去执行。因此 FAQ 的建议是始终先看风险标签并在使用前审查源码内容。英文原版 FAQ 对这个问题的表述更严谨Markdown 文件本身不是运行中的进程但只是文本并不能构成完整的安全模型——被加载的技能可以指示 Agent 运行命令、使用凭据、访问网络或修改文件安装行为本身不等于发生了任何执行只有执行日志与系统变更才是证据。更完整的讨论见英文原版指引对应的安全文档docs/users/security-and-antivirus.md越南语版对应 SECURITY.vi.md。2.3 安装器如何辅助风险评估仓库的安装器 tools/bin/install.js 把风险标签直接做成了安装过滤维度--risk csv只安装匹配这些风险标签的技能如--risk safe,none安装前会生成 Risk Summary列出待装技能按风险标签的分布统计对应源码buildRiskSummary函数未提供任何选择时安装器会打印警告提示完整目录可能包含 offensive 与 unknown 风险技能并建议优先使用--skills、--risk、--category或--tags提供audit --skills ids静态预检对选中的技能做模式扫描命令执行、网络访问、凭据、文件系统写入、提权、破坏性/不可逆操作、二进制文件与符号链接不会执行任何技能内容报告后再决定是否安装。三、安装与设置路径、工具标志与更新3.1 默认安装到哪里安装器的默认目标路径是 Antigravity 全局目录~/.agents/skills/一条命令即可完成npx agentic-awesome-skills这个默认行为在安装器源码 tools/bin/install.js 的getTargets()中有直接体现未指定任何工具标志时默认目标为path.join(HOME, .agents, skills)。3.2 各工具的专用安装路径FAQ 给出各工具对应的目录约定工具Skills 目录Claude Code.claude/skills/Gemini CLI.gemini/skills/Codex CLI.codex/skills/Kiro CLI / IDE~/.kiro/skills/或.kiro/skills/Antigravity~/.agents/skills/或.agent/skills/Antigravity CLIagy~/.gemini/antigravity-cli/skills/Cursor.cursor/skills/OpenCode.agents/skills/AdaL CLI.adal/skills/安装器源码为多数路径提供了对应的--cursor、--claude、--gemini、--codex、--kiro、--antigravity、--agy标志使用这些标志后无需手动指定目录。例如--codex会解析CODEX_HOME环境变量未设置时回退到~/.codex/skills。3.3 Windows 上能否安装可以。直接使用标准安装命令npx agentic-awesome-skillsFAQ 明确指出旧方案中的core.symlinkstrueworkaround 或启用 Developer Mode 已不再需要。3.4 如何更新 Skills两种方式任选其一# 方式一重新运行安装器获取最新版本 npx agentic-awesome-skills # 方式二若使用 git clone 方式安装进入目录后拉取 cd ~/.agents/skills git pull origin main3.5 进阶精确选择安装源码级支撑FAQ 只给了最基础的安装用法而安装器 tools/bin/install.js 的实际能力远超于此这里结合源码补充几个高频实战场景只装指定技能精确 ID/路径npx agentic-awesome-skills --skills brainstorming--skills接受技能名、ID 或嵌套路径未知或歧义的值会直接失败关闭fail closed同名技能会要求给出更精确的嵌套路径源码resolveExactSkillSelections。按风险/类别/标签过滤安装npx agentic-awesome-skills --cursor --risk safe,none npx agentic-awesome-skills --path .agents/skills --category development,backend --risk safe,none npx agentic-awesome-skills --path .agents/skills --tags debugging,typescript-过滤规则源码parseSelectorArg/matchesInstallSelectors同一标志内逗号分隔的值之间是OR关系尾缀-表示排除如legal-表示排除 legal 类--risk、--category、--tags三个标志之间是AND关系精确选择--skills与元数据过滤可以组合也是 AND 关系。安装前预览不写盘npx agentic-awesome-skills --skills brainstorming --dry-run npx agentic-awesome-skills --all --dry-run--dry-run会为每个目标预览将要发生的安装/更新/移除但不写入任何文件——这是 FAQ先审查再安装原则的工程化落地。固定版本发布身份校验npx agentic-awesome-skills --release 4.6.0 --skills brainstorming默认与--release安装采用fail closed策略克隆出的 Git commit 必须与 npm 上该精确版本记录的不可变gitHead一致否则拒绝安装未经审查的内容而--tag会跳过该身份校验并打印警告因为它接受可变 Git 引用。Antigravity 的特别要求由于完整目录可能撑爆宿主上下文导致启动缓慢、截断错误甚至崩溃循环安装器对 Antigravity 目标强制要求提供--skills、元数据过滤或显式--all同意源码assertAntigravityInstallSelection。推荐流程是让配置了只读 AAS Core MCP 的 Codex/Claude Agent 审查项目、从完整目录中挑选精确 skill ID然后用--dry-run预览确认后再去掉--dry-run正式安装。四、使用 Skills调用、组合与选择4.1 如何调用一个技能使用符号加技能名brainstorming 帮我设计一个 todo 应用4.2 能否同时使用多个技能可以。在同一条对话中连续引用多个技能brainstorming 帮我设计这部分然后用 writing-plans 生成任务清单4.3 如何判断该用哪个技能FAQ 给出三步法浏览目录查看 Skill 目录 CATALOG.md搜索ls skills/ | grep 关键词直接问 AI你有没有测试testing方面的技能英文原版 FAQ 补充使用 AAS Core 时可描述项目目标与约束让 Agent 搜索并阅读完整目录、挑选精确 ID 并调用compose_stack在批准栈之前审查 Agent 的理由与提议的 ID。仓库顶层skills/目录下有 2000 个技能子目录当前仓库可见 2035 个足以支撑按需检索。4.4 Bundles捆绑包与 Workflows工作流的区别Bundles按角色或领域分组的策展推荐集合用于回答该包含哪些技能Workflows面向具体成果的有序执行剧本用于需要一步步执行的场景。FAQ 强调Bundle 是技能清单而非可独立调用的超级技能不能直接Essentials或/web-wizard应从 bundle 中挑选单个技能调用或安装专门的 bundle 插件。入门起点见 BUNDLES.vi.md 与仓库的 workflows.json 相关文档。五、故障排查Troubleshooting5.1 AI 助手不识别我的技能FAQ 归纳了三大常见原因安装路径不对检查你所用工具的文档尝试安装器默认的~/.agents/skills/或对应工具标志需要重启安装完成后重启 AI/IDE拼写错误是否把brainstorming打成了brain-storming5.2 技能给出了错误或过时的建议请前往仓库的 Issues 页面提交反馈并附上是哪个技能which skill发生了什么what went wrong预期应该发生什么what should happen instead。5.3 语境过载与崩溃循环英文原版补充的典型场景英文原版 FAQ 记录了两个高发问题及其缓解思路Windows 截断崩溃循环若宿主反复报TrajectoryChatConverter: could not convert a single message before hitting truncation需清理损坏的 Local Storage / Session Storage / IndexedDB 状态并先备份默认 Antigravity Windows 路径对应英文文档docs/users/windows-truncation-recovery.mdLinux/macOS 语境过载仅当完整技能库激活时宿主不稳定应改用激活流程只让所需 bundle 或技能 ID 保持激活对应英文文档docs/users/agent-overload-recovery.md激活脚本见 scripts/activate-skills.sh。通用缓解原则先缩小激活集如--category development,backend --risk safe,none、增量添加技能并逐个回归测试、更频繁地开启新会话。六、参与贡献Quality Bar 与官方技能更新6.1 开源新手也能贡献吗完全可以。FAQ 明确欢迎新手推荐从以下低门槛工作入手修正拼写错误添加示例改进文档。详细指引见 CONTRIBUTING.md。6.2 我的 PR 为何未通过 Quality Bar 检查Quality Bar 是仓库自动化的质量控制门禁。技能缺失的内容通常包括合法的description描述使用示例。本地提交前先运行校验命令npm run validate该命令在 package.json 中定义实际执行tools/scripts/validate_skills.py。英文原版 FAQ 还补充了第三项PR 正文需包含默认模板的 Quality Bar 检查清单另外还有security:docs门禁npm run security:docs与skill-review自动检查针对改动SKILL.md的 PR审查质量门槛、触发词与危险命令模式。质量标准的完整说明见 docs/QUALITY_BAR.md。6.3 能否直接更新 Official 官方技能不能直接改。从外部来源导入的技能通过 frontmatter 中的source、source_repo、source_type字段标识。若某个技能来自其他供应商或仓库正确做法是提交 issue 或附带清晰来源的小型 PR而不是随意修改。在 skills/brainstorming/SKILL.md 中可以看到source: community的真实写法——这就是 provenance来源元数据的实际样例。七、专业技巧速查FAQ 给出的四条高价值入门路径构建任何新东西之前先brainstorming梳理思路遇到棘手的 bug用systematic-debugging想要更高质量的代码尝试test-driven-development想创造自己的技能探索skill-creator。结语FAQ 的核心结论可以浓缩为三句话Skills 是按需加载的专家指令文件不必全量安装风险标签 安装器审计 --dry-run预览构成先审查后安装的完整安全链路先定位正确的安装路径与调用语法再按 Quality Bar 规范参与贡献。若仍有疑问可对照英文原版 docs/users/faq.md、入门指南 GETTING_STARTED.vi.md 与使用文档 USAGE.vi.md 继续深入或在仓库 Discussions 中发起讨论。【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考