Agent Skills
› archestra-ai/archestra
archestra-ai/archestra
GitHub管理 Archestra 版本发布，包括回修、稳定版切分及分支配置。通过 git 和 GitHub API 执行发布流程，处理预检、合并队列监控及状态验证，确保发布合规与安全。
Install All Skills
npx skills add archestra-ai/archestra --all -g -y
Skills in Collection (36)
管理 Archestra 版本发布，包括回修、稳定版切分及分支配置。通过 git 和 GitHub API 执行发布流程，处理预检、合并队列监控及状态验证，确保发布合规与安全。
需要回修修复到稳定分支
创建新的稳定发布线
配置或恢复发布保护设置
批准或重试失败的发布运行
npx skills add archestra-ai/archestra --skill managing-archestra-releases -g -y
指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW模拟及模块Mock规范，确保测试性能与准确性。
编写后端单元测试
修改现有测试用例
配置Vitest测试环境
npx skills add archestra-ai/archestra --skill archestra-dev-backend-tests -g -y
指导在 Archestra 后端添加或修改 API 路由、模型、服务及权限配置。涵盖路由注册、RBAC 权限映射、Zod 数据校验、错误处理规范及代码生成流程，确保符合平台后端开发标准。
需要新增或修改后端 API 接口
调整后端数据模型或服务逻辑
配置 API 端点权限或 OpenAPI 定义
npx skills add archestra-ai/archestra --skill archestra-dev-backend -g -y
利用 Claude 子代理对 archestra-bench 基准测试结果进行 Map-Reduce 分析，生成 Tier-1/Tier-2 改进报告。通过 Rust 工具准备数据，Workflow 并行执行审查，最终汇总为推荐建议。
需要分析基准测试运行结果
生成性能改进建议报告
npx skills add archestra-ai/archestra --skill archestra-dev-bench-analysis -g -y
用于编写、调试和运行 Archestra Playwright E2E 测试，涵盖 API/UI 固定装置、WireMock 模拟及本地/CI 环境配置。
编写或调试 E2E 测试用例
配置 Playwright 测试环境
设置 WireMock 模拟服务
运行端到端测试
npx skills add archestra-ai/archestra --skill archestra-dev-e2e -g -y
用于 Archestra 平台前端开发，涵盖 Next.js/React 组件修改、TanStack Query 数据获取、生成 SDK 使用及 API 错误处理规范。
修改 platform/frontend/ 下的代码
实现 UI 组件或表单
配置 TanStack Query 数据请求
调用生成的 API 客户端
npx skills add archestra-ai/archestra --skill archestra-dev-frontend -g -y
针对 Archestra 系统的故障排查指南，涵盖 Sentry、Tempo、Prometheus 等工具的使用，分析连接压力与部署漂移等问题，辅助定位后端错误及数据库异常。
Archestra 系统故障调查
Staging 环境问题排查
后端 50x 错误分析
数据库连接池耗尽排查
Kubernetes 运行时症状诊断
npx skills add archestra-ai/archestra --skill archestra-dev-investigate -g -y
指导在 Archestra 平台中新增 LLM 提供商、修改代理适配器或路由、修复流式传输及工具调用翻译 Bug，以及编辑模型获取器和凭证配置。
添加新的 LLM 提供商
修改代理适配器或提供商路由
修复流式传输或工具调用翻译错误
编辑模型获取器或处理逻辑
调整提供商凭证或常量
npx skills add archestra-ai/archestra --skill archestra-dev-llm-providers -g -y
指导 Archestra 项目使用 Drizzle 进行数据库迁移，涵盖模式变更、数据迁移脚本编写、大表安全操作及冲突解决流程。
修改 Drizzle 数据库 Schema
生成或编辑迁移 SQL 文件
处理迁移相关的 Git 合并冲突
诊断 drizzle-kit 检查失败
npx skills add archestra-ai/archestra --skill archestra-dev-migrations -g -y
指导在 Archestra 项目中配置可观测性栈，包括遵循 OpenTelemetry 规范命名指标和跨度、使用 Tilt/Docker 启动本地监控环境及访问相关服务 URL。
修改追踪或指标名称
配置本地可观测性环境
设置 OpenTelemetry 标签
npx skills add archestra-ai/archestra --skill archestra-dev-observability -g -y
用于清理 pnpm-workspace.yaml 中已过期或冗余的 CVE 依赖覆盖配置。自动解除成熟临时锁定并移除无效覆盖，确保依赖安全且精简，不生成新修复。
需要清理过期的 pnpm 依赖锁定
移除无效的依赖覆盖配置
npx skills add archestra-ai/archestra --skill archestra-dev-override-sweep -g -y
定义仓库内Rust代码的编码规范，涵盖NAPI绑定与独立工作区。强调库优先、简单实现及架构分层，规范类型建模、输入验证及可观测性集成。
编写或审查Rust代码
检查NAPI接口与核心逻辑分离
评估Rust架构设计
npx skills add archestra-ai/archestra --skill archestra-dev-rust-napi -g -y
指导测试策略决策，判断变更是否需要测试及选择合适层级（单元、集成或E2E），避免无意义的“噪音测试”，优先以最低成本捕获真实缺陷。
决定是否需要编写测试
选择测试层级（单元/集成/E2E）
审查测试是否存在冗余
npx skills add archestra-ai/archestra --skill archestra-dev-testing -g -y
用于编写和编辑 Archestra 产品文档的 Skill，规定内容结构、语气风格及写作流程，确保文档准确简洁。
撰写新功能文档
重写现有页面
修正文案或语气
捕获文档截图
npx skills add archestra-ai/archestra --skill archestra-docs-writer -g -y
用于向 Archestra MCP 目录添加新服务器或审查提交。自动从 URL 派生名称，探测远程服务端点以获取工具、传输和认证信息，处理图标编码并校验清单格式，最终生成 PR。
需要向公共 MCP 目录注册新的 MCP 服务器
准备或审查 MCP 目录条目的 Pull Request
npx skills add archestra-ai/archestra --skill archestra-mcp-catalog-entry -g -y
指导编写和修改 Archestra 后端单元测试，涵盖 Vitest 双项目隔离策略、MSW HTTP 边界模拟及模块 Mock 规范，旨在提升测试性能与稳定性。
编写后端单元测试
修改现有测试用例
配置 Vitest 测试环境
处理 HTTP 客户端模拟
npx skills add archestra-ai/archestra --skill archestra-dev-backend-tests -g -y
用于在 Archestra 后端添加或修改 API 路由、模型、服务及权限配置。涵盖路由注册、权限映射（防403错误）、代码生成及验证流程，确保后端接口开发符合规范。
添加新的后端 API 路由
修改现有后端路由或权限
更新后端数据模型或服务
npx skills add archestra-ai/archestra --skill archestra-dev-backend -g -y
将archestra-bench实验结果通过Map-Reduce模式转化为Tier-1/Tier-2改进报告。利用Rust工具准备数据，调用Claude子代理对每次运行进行独立评估（Map），最后汇总生成仓库级分析报告（Reduce）。
分析基准测试实验结果
生成性能改进建议报告
npx skills add archestra-ai/archestra --skill archestra-dev-bench-analysis -g -y
用于编写、调试和运行 Archestra Playwright E2E 测试，涵盖 API/UI 夹具、WireMock 支持测试及本地/CI 环境配置。
编写或调试 Playwright E2E 测试脚本
配置本地或 CI 的 E2E 测试依赖环境
npx skills add archestra-ai/archestra --skill archestra-dev-e2e -g -y
用于 Archestra 前端 Next.js/React 开发，涵盖 UI 组件、TanStack Query 数据获取、生成式 API 客户端使用及错误处理规范。
修改 platform/frontend/ 下的前端代码
涉及 UI 组件、表单或 TanStack Query hooks 的开发
调用生成的 API 客户端或处理前端数据获取
npx skills add archestra-ai/archestra --skill archestra-dev-frontend -g -y
Archestra系统故障排查指南，涵盖Sentry日志、Drizzle异常解析、DB连接池分析及K8s运行时诊断，提供具体工具使用与故障分类。
Archestra后端50x错误
数据库连接压力或超时
部署回归或迁移漂移
Staging环境故障调查
npx skills add archestra-ai/archestra --skill archestra-dev-investigate -g -y
指导在 Archestra 平台中新增 LLM 提供商、配置代理路由及处理流式/工具调用翻译的规范。涵盖后端类型定义、Fastify 插件注册、模型常量管理及前端密钥界面，确保集成符合架构标准。
添加新的 LLM 提供商
修改代理适配器或提供商路由
修复流式或工具调用翻译错误
编辑模型获取器或处理逻辑
更新提供商凭证或模型常量
npx skills add archestra-ai/archestra --skill archestra-dev-llm-providers -g -y
指导 Archestra 项目使用 Drizzle 进行数据库迁移，涵盖模式变更、数据迁移、大表处理及冲突解决。
修改 Drizzle 数据库模式
生成或编辑迁移 SQL 文件
排查 drizzle-kit 检查失败
解决迁移元数据合并冲突
npx skills add archestra-ai/archestra --skill archestra-dev-migrations -g -y
用于 Archestra 可观测性配置，涵盖 OpenTelemetry 规范、指标命名及本地环境搭建。
修改追踪或指标命名
配置本地可观测性栈
npx skills add archestra-ai/archestra --skill archestra-dev-observability -g -y
用于清理pnpm工作区中过期的临时CVE锁定或冗余的依赖覆盖配置。通过验证版本发布时间和重新解析依赖图，自动移除不再需要的安全补丁覆盖，保持依赖树整洁。
用户要求清理或审查pnpm覆盖规则
需要移除已过期的临时CVE锁定
检测并删除冗余的依赖覆盖
npx skills add archestra-ai/archestra --skill archestra-dev-override-sweep -g -y
定义仓库中Rust代码的编码规范，涵盖NAPI绑定与独立工作区。强调库优先、极简架构及类型安全，规范NAPI边界逻辑与输入验证，指导开发高质量可维护代码。
编写或重构Rust代码
检查Rust代码风格合规性
设计NAPI接口与核心逻辑分离
npx skills add archestra-ai/archestra --skill archestra-dev-rust-napi -g -y
指导决策测试用例的存在必要性及层级选择（单元、后端集成、前端集成或E2E），防止无效测试，优先使用低成本且能捕获真实Bug的测试策略。
决定是否需要编写测试
确定测试应放置的层级
审查测试是否存在冗余
npx skills add archestra-ai/archestra --skill archestra-dev-testing -g -y
用于撰写和编辑 Archestra 平台文档，通过浏览器自动化验证功能，遵循严格的简洁、事实导向语调规范，生成准确的用户指南。
编写新功能文档
重写现有页面
修正文案语气
更新截图说明
npx skills add archestra-ai/archestra --skill archestra-docs-writer -g -y
用于向 Archestra MCP 目录添加新服务器，自动从 URL 派生名称、探测远程端点填充工具与认证信息、获取图标并验证清单格式。
添加新的 MCP 服务器到公共目录
准备或审查目录条目 PR
npx skills add archestra-ai/archestra --skill archestra-mcp-catalog-entry -g -y
规范 Archestra 项目的 PR 标题和描述撰写，确保符合约定式提交规范，内容基于实际代码变更，避免冗余信息并保护敏感数据。
准备创建或更新 Pull Request
需要撰写或优化 PR 标题与描述
npx skills add archestra-ai/archestra --skill archestra-pr-hygiene -g -y
收集系统访问请求的完整信息，包括员工邮箱、系统、权限级别、理由及审批人邮箱。校验必填字段并依据访问策略合规性确认权限等级，最终通过IT服务台工具提交工单并返回票据ID。
用户请求申请或设置系统/应用访问权限
需要为特定员工开通系统访问权限
npx skills add archestra-ai/archestra --skill access-request-intake -g -y
提供基于捆绑脚本的密文解码功能，支持通过命令行参数传入密钥常量。适用于接收十六进制或混淆数据时，自动执行对应方案脚本还原明文，避免手动猜测字节，确保准确解密。
用户请求解码十六进制字符串
用户提供混淆的二进制或文本数据要求还原明文
需要运行特定加密方案的解密密令
npx skills add archestra-ai/archestra --skill cipher-decoder -g -y
提供Q3销售账簿Excel文件，用于计算奖金和汇总数据。当任务需要基于销售账簿进行报表生成或总额计算时触发，需使用电子表格库读取挂载的文件。
计算销售人员奖金
统计销售总额
生成销售报表
npx skills add archestra-ai/archestra --skill sales-ledger -g -y
将现有的智能体概念验证或试点项目迁移至 Archestra 实例。通过自动化脚本发现源配置，人工判断映射关系并生成计划，最终执行迁移并输出报告，支持离线环境。
用户希望将现有智能体 PoC 迁移到 Archestra
需要转换或移植现有的智能体设置到 Archestra
npx skills add archestra-ai/archestra --skill migrate-to-archestra -g -y
针对Drizzle迁移中操作大型热写表（如interactions）的风险规避指南。涵盖安全与高风险操作分类，强调禁止在事务中创建索引，并规定需先在预发环境审计数据规模，防止锁表导致服务中断。
执行涉及大表的数据库迁移前
检查或生成Drizzle迁移脚本时
评估Schema变更对生产环境写入性能的影响
npx skills add archestra-ai/archestra --skill archestra-dev-interactions-migrations -g -y
指导在修改高并发写入表（如interactions）时的Drizzle迁移规范，区分安全与高风险操作，严禁在事务中创建索引，要求使用CONCURRENTLY或预检审计以规避生产锁表风险。
执行涉及大表或高频写入表的数据库迁移
需要为关键业务表添加或删除索引
评估数据库变更对在线服务稳定性的影响
npx skills add archestra-ai/archestra --skill archestra-dev-interactions-migrations -g -y
