用途:为真实技术栈构建一个可被队友或智能体浏览、信任并安装的受管技能库。资料强调不要手工编辑 skills.json、README.md 或 WORK_AREAS.md,应使用 CLI 提供的变更命令。
主要能力与书架体系:使用五个工作区作为书架——frontend(Web UI、浏览器、设计系统、视觉打磨)、backend(API、数据、安全、基础设施、运行时)、mobile(iOS、Android、React Native、Expo、设备测试、应用交付)、workflow(文档、测试、发布、文件、研究、规划)、agent-engineering(提示词、评估、工具、编排、智能体运行时设计)。先把用户技术栈映射到书架,例如 React Native + Node 后端映射为 mobile + backend;仅当测试、发布、文档或研究是真实工作内容时才加 workflow;仅当团队做 AI 功能、提示词、评估或工具时才加 agent-engineering。首轮须覆盖用户明确提到的每个主要书架。
使用方式:先初始化受管工作区:npx ai-agent-skills init-library <name>,然后 cd <name>。行动前最多问 3 个简短问题:库需支持哪些工作、首轮应小而聚焦还是更广、输出留在本地还是最终成为可分享的 GitHub 仓库。策展前先浏览:npx ai-agent-skills list --area <work-area>、npx ai-agent-skills search <query>、npx ai-agent-skills collections。若用户提到多个主要书架,逐一检查后再选技能。
变更规则:首轮保持小规模,约 3 到 8 个技能。捆绑选择与简单 GitHub 导入先用 add;想引入上游条目而不复制文件到 skills/ 时用 catalog;只有团队想本地编辑或拥有的真正内部副本才用 vendor。每次变更都要带明确的策展元数据,如 --area、--branch、--why。分支名示例:React Native / UI、React Native / QA、Node / APIs、Node / Data、Docs / Release;避免 stuff、misc、notes。
whyHere 写法:它是策展判断而非填充,应说明支持的技术栈或工作流、填补的空白、为何属于这里。例如“Covers React Native testing so the mobile shelf has a real device-validation option.”。精选(--featured)要克制,每个书架约 2 到 3 个,只留给会建议新队友优先安装的技能。当库有约 5 到 8 个可靠选择后,创建 starter-pack 合集:添加新技能时用 --collection starter-pack,或对已有条目用 npx ai-agent-skills curate <skill> --collection starter-pack,保持合集小而利于上手。
收尾检查:对每个涉及的主要书架运行 npx ai-agent-skills list --area <work-area>,运行 npx ai-agent-skills collections 与 npx ai-agent-skills build-docs;若创建了 starter-pack,确认安装命令正确;确保最终书架组合仍匹配用户实际技术栈。最后返回:添加了什么、用了哪些书架及原因、哪些技能被精选、starter-pack 包含什么(若创建)、库是仅本地还是可分享。
限制:资料未提供具体技能清单、价格、平台支持范围或效果保证;上述命令与流程均来自资料原文。