Agent Skills
› archestra-ai/archestra
archestra-ai/archestra
GitHub指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW模拟及模块Mock规范，确保测试性能与准确性。
Install All Skills
npx skills add archestra-ai/archestra --all -g -y
Skills in Collection (35)
指导编写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双项目隔离策略、HTTP边界MSW模拟及模块Mock规则，旨在提升测试性能与可靠性。
编写或修改后端单元测试
配置Vitest测试环境
处理HTTP客户端模拟
设置模块Mock
npx skills add archestra-ai/archestra --skill archestra-dev-backend-tests -g -y
用于在 Archestra 平台后端添加或修改 API 路由、模型、服务及权限配置。涵盖路由注册、RBAC 鉴权设置、代码生成及 Fastify/Zod 规范，确保后端接口开发符合安全与架构标准。
修改 backend/src/routes 下的路由文件
新增 API 端点并配置权限
更新后端数据模型或服务逻辑
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 测试用例
配置 WireMock 或测试夹具
设置本地或 CI 环境的 E2E 依赖
npx skills add archestra-ai/archestra --skill archestra-dev-e2e -g -y
用于修改 Archestra 前端 Next.js/React 代码、UI 组件、表单及数据获取的规范。涵盖 TanStack Query 使用、生成 API 客户端调用、类型复用及错误处理策略，确保前端开发一致性与类型安全。
修改平台前端 UI 组件或表单
实现前端数据获取逻辑
使用生成的 API 客户端
处理前端查询错误与 Toast
npx skills add archestra-ai/archestra --skill archestra-dev-frontend -g -y
针对 Archestra 系统的故障排查指南，涵盖 Sentry、Tempo 等工具使用，以及数据库连接压力、部署回归和配置问题的分析与定位。
Archestra 系统故障调查
后端 50x 错误分析
数据库连接压力排查
部署回归问题定位
npx skills add archestra-ai/archestra --skill archestra-dev-investigate -g -y
用于在 Archestra 平台中添加 LLM 提供商、配置代理适配器及路由、处理流式传输与工具调用转换，以及管理模型获取和凭证逻辑。
添加新的 LLM 提供商
修改代理适配器或提供商路由
修复流式传输或工具调用翻译错误
编辑模型获取器或处理逻辑
调整提供商凭证或枚举常量
npx skills add archestra-ai/archestra --skill archestra-dev-llm-providers -g -y
处理 Drizzle 数据库迁移任务，包括生成迁移、编辑 SQL、解决冲突及验证一致性。
修改 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-workspace.yaml 中已过期或冗余的 CVE 覆盖项。分两种模式：移除成熟临时引脚或删除不再需要的覆盖，确保最小变更范围并验证依赖图稳定性。
需要清理过期的 pnpm 覆盖配置
检查并移除冗余的依赖覆盖
npx skills add archestra-ai/archestra --skill archestra-dev-override-sweep -g -y
定义仓库内Rust代码的编码规范，涵盖NAPI集成与独立工作区。强调编写清晰、可复用的库代码，严格分离核心逻辑与JS绑定层，规范类型建模及输入验证。
编辑或审查Rust代码
构建或测试Rust模块
设计NAPI接口
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 文档页面，涵盖新功能文档、重写及文案修正。通过浏览器自动化 MCP 验证软件实际行为，遵循严格的语气和内容规范生成简洁准确的 Markdown 文档。
需要编写新的功能文档
需要重写或优化现有文档页面
需要修正文档中的语气或文案错误
npx skills add archestra-ai/archestra --skill archestra-docs-writer -g -y
用于向 Archestra MCP 目录添加新服务器，自动从 URL 推导名称、探测远程端点获取工具与认证信息、编码图标并校验清单，最终生成 PR。
向公共 MCP 目录添加新服务器
准备或审查目录条目 PR
npx skills add archestra-ai/archestra --skill archestra-mcp-catalog-entry -g -y
规范 Archestra 项目的 PR 标题和描述，确保符合约定式提交格式，内容基于实际变更和证据，避免冗余信息。
打开或更新 Archestra 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文件，用于处理计算奖金或汇总销售额等报表任务。通过openpyxl读取数据完成分析。
需要计算销售奖金
需要汇总销售总额
生成基于销售数据的报表
npx skills add archestra-ai/archestra --skill sales-ledger -g -y
将现有的 Agent PoC/试点配置迁移至 Archestra 实例。通过发现、映射和应用的自动化流程，处理 MCP 配置、脚本等资产，确保在隔离环境中零依赖运行，并提供产品判断与最终报告。
用户希望将现有 Agent 设置迁移到 Archestra
需要将 PoC 或试点项目转换为 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迁移的安全操作规范。明确区分安全元数据操作与高风险全表重写操作，严禁在事务中创建索引，要求使用并发索引命令并在预发布环境审计表大小以规避生产阻塞风险。
需要修改大表或高频写入表的数据库结构
执行涉及interactions表的Drizzle迁移生成或运行
npx skills add archestra-ai/archestra --skill archestra-dev-interactions-migrations -g -y
