私有技能注册表

私有技能注册表让您可以发布技能供其他工作空间安装，追踪版本和批准状态，以及在整个组织范围内监控使用情况。

何时使用注册表

在以下情况下使用技能注册表：

• 与组织内的其他工作空间共享技能
• 在团队使用之前进行版本控制和批准技能
• 追踪哪些技能受欢迎或未被使用
• 提供一个精选的内部工具和辅助程序库

如果您仅为自己的工作空间创建技能，则不需要注册表 — 直接创建它。

技能可见性

每项技能都有一个可见性设置，用于确定谁可以查看和安装它：

创建技能时，它以 private 开始。

发布技能版本

技能稳定后，您可以发布它以创建不可更改的快照，可以进行审查和安装：

1. 在 技能 中打开技能
2. 点击 发布（或 发布新版本，如果有较早的版本）
3. 填写 变更日志 — 描述新增或改变的内容
4. 点击 发布

技能现在处于 pending_review 状态。工作空间管理员或批准者随后可以审查并批准它。

发布创建一个版本：

• 版本 1 — 首个发布的版本
• 版本 2 — 下次在进行更改后发布
• 版本 3、4 等

每个版本都是不可更改的 — 您无法编辑已发布的版本。要进行更改，请编辑草稿技能并发布新版本。

批准工作流程

已发布的技能遵循批准工作流程：

1. 作者发布

作者点击 发布，技能移到 pending_review。

2. 审查者批准或拒绝

工作空间管理员或审查者可以：

• 批准 — 技能移到 approved 并可由其他工作空间安装
• 拒绝 — 技能保留在草稿中；作者可进行更改并重新提交

要审查技能：

1. 转到 技能 → 待审查
2. 点击技能
3. 审查代码和变更日志
4. 点击 批准 或 拒绝

3. 已批准的技能可安装

批准后，其他工作空间在 技能 → 注册表 中看到技能，并可安装它。

安装技能

要安装由另一工作空间发布的技能：

1. 转到 技能 → 注册表
2. 浏览来自其他工作空间的已批准技能
3. 在技能上点击 安装
4. 确认安装

AACWorkflow 在您的工作空间中创建技能的本地副本，固定到您安装的版本。您的副本是独立的 — 对源技能的编辑不会自动更新您的副本。

要更新到已安装技能的较新版本：

1. 转到 技能 → 已安装
2. 找到已安装的技能
3. 点击 更新

最新的批准版本被拉入您的工作空间。

要卸载技能：

1. 转到 技能 → 已安装
2. 找到技能
3. 点击 卸载

本地副本被删除，但使用它的代理会被更新以显示该技能不可用。

版本历史和比较

每个已发布的版本都被保留，您可以查看完整的历史：

1. 打开技能
2. 点击 版本 标签页
3. 查看所有已发布的版本，包括：
   • 版本号
   • 作者和发布日期
   • 变更日志
   • 与上一版本的差异

要查看版本之间发生的更改：

1. 在"版本"标签页中，选择两个版本
2. 点击 查看差异

删除的行以红色显示；添加的行以绿色显示。

使用指标

追踪技能的使用频率：

1. 打开技能
2. 转到 指标 标签页

您将看到：

• 使用它的代理 — 链接该技能的代理数量
• 执行的任务 — 使用该技能运行的任务总数
• 最后使用 — 技能最后被执行的时间

使用这些指标来：

• 识别受欢迎的技能
• 查找未使用的技能（考虑删除它们）
• 了解技能在整个组织的采用情况

组织技能

可见性策略

• Private — 实验或个人技能；还未准备好共享
• Workspace — 您的工作空间中所有人使用的技能
• Organization — 稳定、已审查的工具，其他团队应该了解

命名约定

使用包含域或工具的描述性名称：

• github-pr-reviewer — 审查 GitHub PR
• aws-cost-analyzer — 分析 AWS 成本
• sql-optimizer — 优化 SQL 查询
• internal-docs-generator — 生成内部文档

组织

在工作空间内，使用标签或前缀来分组相关技能：

• github-* — 所有与 GitHub 相关的技能
• aws-* — 所有与 AWS 相关的技能
• internal-* — 仅限内部工具

最佳实践

• 仅发布稳定的技能 — 发布前彻底测试
• 编写清晰的变更日志 — 帮助审查者和用户了解更改的内容
• 谨慎进行版本控制 — 不要跳跃版本；使用语义化版本控制（1.0 → 1.1 → 2.0）
• 专注技能 — 一项技能，一项工作；如果做多项工作则拆分
• 存档旧版本 — 批准新版本后，用户不应该需要旧版本
• 记录依赖项 — 如果技能需要外部工具或 API，请清楚地记录

版本管理

发布新版本时：

1. 旧版本保持批准状态 — 现有安装继续工作
2. 新版本进入待审查 — 必须被批准
3. 用户可以升级 — 点击 更新 拉取最新的批准版本
4. 固定 — 用户保留其安装的版本，除非他们手动更新

这意味着：

• 破坏性更改不强制升级
• 用户选择何时更新
• 旧版本保持可用以供回退

存档和弃用

要停用技能：

1. 打开技能
2. 转到 设置
3. 点击 存档

已存档的技能：

• 停止在注册表中显示
• 不能被新安装
• 现有安装仍然工作（但显示弃用通知）
• 已使用它的代理可以继续运行，但建议用户切换到替代品

可选择设置建议的替代品，以便用户知道切换到什么。

跨组织共享技能

如果您想与组织外的人共享技能：

1. 将技能导出为文件（.tar.gz 或类似文件）
2. 通过带外方式共享文件
3. 其他团队可以通过 技能 → 从文件导入 导入它

对整个 AACWorkflow 社区的公开共享目前不受支持，但此私有注册表允许您轻松在组织内共享。

安全和治理

• 审批门限 — 所有已发布的技能必须在使用前被批准
• 工作空间范围 — 技能对每个工作空间隔离；工作空间特定数据不会泄露
• 版本控制 — 每个版本都是不可更改的；更改需要新版本和重新批准
• 审计跟踪 — 所有发布、批准和安装都被记录

有关其他治理和校验和，请参阅技能签名和审查。

后续步骤

• 技能签名和审查 — 批准门限和篡改检测
• 技能 — 了解如何创建和使用技能
• 团队 — 组织代理以使用特定技能