Agent Skills
› archestra-ai/archestra
archestra-ai/archestra
GitHub指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW mocking及模块mock规范。
安装全部 Skills
npx skills add archestra-ai/archestra --all -g -y
集合内 Skills (53)
按质量分展示前 50 个（共 53 个），完整列表请用安装命令预览或逐个打开详情。
指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW mocking及模块mock规范。
编写或修改后端单元测试
配置Vitest测试环境
处理HTTP客户端模拟
npx skills add archestra-ai/archestra --skill archestra-dev-backend-tests -g -y
用于 Archestra 后端 API 开发，涵盖路由、模型、服务及权限配置。指导添加端点、遵循目录结构、处理 RBAC 权限映射及代码生成验证，确保符合平台规范。
修改 backend 路由或控制器
新增 API 端点
调整权限控制逻辑
运行代码生成
npx skills add archestra-ai/archestra --skill archestra-dev-backend -g -y
利用 Claude 子代理对 archestra-bench 运行结果进行 Map-Reduce 分析，生成 Tier-1/Tier-2 改进报告。通过 Rust 工具准备数据，使用 Workflow 工具并行执行各 rollout 的审查与聚合，无需 API Key。
需要分析基准测试轨迹并生成改进建议
处理 archestra-bench 运行结果以获取性能评估
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 开发，涵盖 UI 组件、TanStack Query 数据获取、生成 SDK 调用及错误处理规范。指导在 platform/frontend 目录下进行日常平台界面工作，确保类型安全与一致性。
修改 Archestra 前端代码
调整 UI 组件或表单
使用 TanStack Query 获取数据
调用生成的 API 客户端
npx skills add archestra-ai/archestra --skill archestra-dev-frontend -g -y
提供 Archestra 系统故障排查指南，涵盖 Sentry、Tempo、Prometheus 等工具使用，分析数据库连接压力与部署漂移等故障类型，辅助定位后端错误及基础设施问题。
Archestra 系统故障排查
后端 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
指导 Drizzle ORM 数据库迁移全流程，涵盖 Schema 变更、数据迁移、大表安全操作及冲突解决，提供常用命令与一致性校验方法。
修改 Drizzle 数据库模式
生成或编辑迁移 SQL 文件
处理迁移元数据的合并冲突
诊断 drizzle-kit 检查失败
npx skills add archestra-ai/archestra --skill archestra-dev-migrations -g -y
用于规范 Archestra 系统的可观测性实践，涵盖 Trace、Metrics 及本地环境配置。指导遵循 OTEL 语义标准命名属性与指标，避免随意创建自定义名称，并提供 Tilt 和 Docker Compose 启动本地监控栈（Tempo, Grafana, Prometheus）的命令及访问地址。
修改或新增 Trace span 属性
调整 Metrics 指标定义
配置 OpenTelemetry 相关设置
启动或调试本地可观测性环境
npx skills add archestra-ai/archestra --skill archestra-dev-observability -g -y
用于清理 pnpm-workspace.yaml 中过期的 CVE 临时锁定和冗余覆盖配置，确保依赖图整洁。
需要清理已成熟或不再需要的 pnpm 依赖覆盖项
询问关于 pnpm overrides 的维护或撤销操作
npx skills add archestra-ai/archestra --skill archestra-dev-override-sweep -g -y
清理 Archestra 开发环境中未使用的 worktrees、本地分支、进程及 OrbStack Kubernetes 资源，同时保留活跃的 Tilt 堆栈和未完成工作，确保环境整洁且不影响当前开发。
需要清理本地开发环境中的闲置 git worktree
需要释放被废弃的本地分支占用
需要停止并清理孤立的后台进程
需要回收 OrbStack 中不再使用的 Kubernetes 资源
npx skills add archestra-ai/archestra --skill archestra-dev-resource-cleanup -g -y
定义仓库内 Rust 代码的编码规范，涵盖 NAPI 绑定与独立工作区。强调库优先、简洁风格及核心逻辑与 Node 解耦，规定类型建模、边界验证及可观测性要求。
编写或审查 Rust 代码
检查 NAPI 绑定实现
重构 Rust 模块
npx skills add archestra-ai/archestra --skill archestra-dev-rust-napi -g -y
指导测试策略，判断测试层级与存在必要性。涵盖后端Vitest、E2E及前端规范，强调通过本地验证确保合并队列质量，优化CI成本。
决定测试该放在哪个层级
评估新测试的必要性
配置或优化CI/CD测试流程
npx skills add archestra-ai/archestra --skill archestra-dev-testing -g -y
用于编写和编辑 Archestra 用户文档，规范内容结构、语气及 Markdown 格式，确保文档简洁准确且面向终端用户。
编写新功能文档
重写或修订现有页面
修正文案语气或风格
捕获并添加文档截图说明
npx skills add archestra-ai/archestra --skill archestra-docs-writer -g -y
用于向 Archestra MCP 目录添加新服务器，自动推导名称、探测远程端点获取工具信息、编码图标并校验清单。
需要向公共 MCP 目录添加新的 MCP 服务器
准备或审查 MCP 目录条目 PR
npx skills add archestra-ai/archestra --skill archestra-mcp-catalog-entry -g -y
用于在创建或更新 Archestra 拉取请求时，撰写符合规范的标题和基于证据的描述。指导如何遵循提交规范、描述变更细节及验证最终差异，确保元数据准确且不含敏感信息。
打开新的拉取请求
更新现有拉取请求
npx skills add archestra-ai/archestra --skill archestra-pr-hygiene -g -y
管理 Archestra 版本发布流程，包括滚动 Beta 版、稳定补丁及完整稳定线切换。涵盖回溯修复、分支切割、配置保护、制品测试、失败恢复及发布审批等执行步骤。
需要回溯修复代码到稳定分支
创建或退役新的稳定发布分支
配置或修改发布保护规则
测试发布制品
恢复失败的发布运行
批准并发布新版本
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服务台工具提交工单，确保收集员工邮箱、系统、权限级别、理由及经理邮箱等所有必填字段，并在提交前验证策略合规性。
用户请求申请或设置系统/应用访问权限
需要为员工开通新系统访问权
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文件，用于处理计算奖金或汇总销售额等报表任务。Agent需读取挂载的文件并解析数据以生成报告。
需要计算销售奖金
需要汇总销售总额
基于销售账簿进行数据分析
npx skills add archestra-ai/archestra --skill sales-ledger -g -y
将现有的代理概念验证或试点项目迁移至Archestra实例。通过自动化脚本发现源配置，结合人工判断进行实体映射和计划制定，最终应用变更并生成报告，实现从旧有混乱配置到标准化架构的平滑过渡。
用户希望将现有代理PoC迁移到Archestra
需要转换或移植现有的代理设置
npx skills add archestra-ai/archestra --skill migrate-to-archestra -g -y
