Agent Skills
› archestra-ai/archestra
archestra-ai/archestra
GitHub指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW mocking及模块mock规范。
Install All Skills
npx skills add archestra-ai/archestra --all -g -y
Skills in Collection (53)
Showing top 50 of 53 by quality score. Use the install list command or open individual skills for the rest.
指导编写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
