curate-a-team-library

策划团队技能库

目标

构建一个托管的技能库，让其他队友或 Agent 能够实际浏览、信任并安装其中的技能。

如果 CLI 已经提供所需的修改操作，就不要手动编辑 skills.json、README.md 或 WORK_AREAS.md。

第一步

从托管工作区开始。

npx ai-agent-skills init-library <name>
cd <name>

行动前最多提出 3 个简短问题：

• 技能库需要支持哪些类型的工作
• 第一轮应该保持小而精，还是覆盖更广
• 输出应保留在本地，还是最终整理为可分享的 GitHub 仓库

分区系统

使用以下 5 个工作区作为分区：

• frontend：Web UI、浏览器工作、设计系统、视觉润色
• backend：API、数据、安全、基础设施、运行时系统
• mobile：iOS、Android、React Native、Expo、设备测试、应用交付
• workflow：文档、测试、发布工作、文件、研究、规划
• agent-engineering：提示词、评估、工具、编排、Agent 运行时设计

添加任何内容之前，先将用户的技术栈映射到相应分区。

• 示例：React Native + Node backend 映射到 mobile + backend。
• 只有当测试、发布、文档或研究确实属于工作内容时，才添加 workflow。
• 只有当团队正在开发 AI 功能、提示词、评估或工具时，才添加 agent-engineering。
• 确保第一轮覆盖用户明确指定的每个主要分区。

探索流程

策划之前先浏览。

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

whyHere 应体现策划者的判断，而不是敷衍填充。

• 说明它支持的技术栈或工作流。
• 说明它填补了此技能库中的哪项空缺。
• 如实说明它为何适合收录于此。

合适：

覆盖 React Native 测试，让 mobile 分区具备真正的设备验证选项。

不合适：

我想把它放进我的分区。

推荐技能

谨慎使用 --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

• 对你涉及的每个主要分区运行 list --area。
• 如果创建了 starter-pack，确认安装命令看起来正确。
• 确保最终的分区组合仍符合用户的实际技术栈。

收尾

返回以下信息：

• 添加了哪些内容
• 使用了哪些分区以及原因
• 哪些技能设为精选
• 如果创建了 starter-pack，其中包含哪些内容
• 技能库仅供本地使用，还是已准备好分享