核心用法
bolta.skills.index 是 Bolta AI 平台的官方技能注册中心与编排层，本身不直接执行内容操作，而是作为智能路由系统，根据工作空间配置为用户推荐最优的技能组合。
典型使用场景：
- 新工作空间初始化："我该安装哪些技能？"
- 能力探索："Bolta 能做什么？"
- 兼容性问题排查："为什么这个技能无法使用？"
- 多步骤工作流规划："完成这个任务需要哪些技能？"
工作流程：
1. 自动采集工作空间上下文（Safe Mode 状态、自主模式、角色权限、配额使用情况）
2. 检查语音档案状态（首次使用需先创建）
3. 应用决策矩阵过滤不适用的技能
4. 返回个性化推荐列表，包含优先级排序和排除原因说明
显著优点
1. 智能策略感知：深度集成 Bolta 的权限与授权系统，自动识别 Safe Mode、自主模式（assisted/managed/autopilot/governance）、用户角色和代理权限，避免配置冲突
2. 渐进式引导：提供四种预定义安装集，匹配从新手到高阶用户的完整成长路径：
- Assisted 模式：全人工审核，适合合规要求严格的场景
- Managed 模式：人机协作，平衡效率与 oversight
- Autopilot 模式：全自动化，适合成熟品牌的高频发布
- Governance 模式：管理审计专用，面向管理员和合规团队
3. 实时配额监控：集成 bolta.quota.status，在推荐前检查日发帖量和小时 API 调用限制，避免执行时失败
4. 详细的可解释性：每个被排除的技能都附带具体原因（如"需要 posts:schedule 权限"或"自主模式不兼容"），并推荐替代方案或故障排查工具（如 bolta.policy.explain）
5. 结构化输出：返回完整的 JSON 响应，包含推荐技能列表、排除技能及原因、警告信息、下一步操作指引，便于程序化集成
潜在缺点与局限性
1. 强依赖外部凭证：必须配置 BOLTA_API_KEY、BOLTA_WORKSPACE_ID 等环境变量，首次 setup 成本较高，需要完成 agent 注册流程
2. 平台锁定：专为 Bolta 生态系统设计，技能推荐逻辑深度耦合 Bolta 的权限模型（Safe Mode、自主模式、五层架构），无法直接迁移到其他平台
3. 非执行型技能：仅提供发现和推荐能力，实际内容创建仍需调用其他技能（如 bolta.draft.post），本身不产生直接业务价值
4. 配置复杂度高：决策矩阵涉及 6 个输入变量（Safe Mode、自主模式、角色、代理权限、配额、语音档案状态），新手理解门槛较高
5. Autopilot 模式风险：文档明确警告该模式绕过人工审核，需配合成熟的语音档案（建议 v5+）和严格的配额限制，否则可能导致品牌风险
适合人群
- Bolta 新用户：首次配置工作空间，需要了解平台能力边界
- 内容运营团队：需要根据团队规模和发布频率选择合适的工作流模式
- Workspace 管理员：管理多角色权限、监控配额使用、排查授权失败
- 合规与安全官员：需要审计日志导出、API 密钥轮换、策略解释等治理能力
- AI Agent 开发者：需要以程序化方式发现可用能力并动态调整行为
常规风险
1. 凭证泄露风险：BOLTA_API_KEY 为敏感凭证，文档反复强调不可提交至 Git，需定期轮换（建议 90 天周期）
2. 配置冲突风险：Autopilot 模式与 Safe Mode ON 存在根本冲突，系统会阻止所有操作直至配置修正，可能导致自动化流程中断
3. 权限越界风险：若代理凭证权限配置不当（如 creator 角色尝试执行 admin 操作），可能导致操作失败或安全审计异常
4. 配额耗尽风险：高频自动化场景下易触发日发帖量或小时 API 限制，导致内容生成中断，需配合 bolta.quota.status 主动监控
5. 自动化内容风险：Autopilot 模式下的 bolta.cron.generate_and_schedule 直接发布无人工审核内容，存在品牌声誉和合规风险，文档要求定期抽检（建议 10%）验证语音一致性