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 (56)
按质量分展示前 50 个（共 56 个），完整列表请用安装命令预览或逐个打开详情。
指导编写Archestra后端单元测试，涵盖Vitest双项目隔离策略、HTTP边界MSW mocking及模块mock规范。
编写或修改后端单元测试
配置Vitest测试环境
处理HTTP客户端模拟
npx skills add archestra-ai/archestra --skill archestra-dev-backend-tests -g -y
指导在 Archestra 平台后端添加或修改 API 路由、模型及服务。涵盖路由注册、权限配置（RBAC）、Zod 校验及代码生成规范，确保符合安全与架构标准。
修改 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工具并行执行评估，最终输出推荐建议。
需要分析基准测试运行结果
生成性能改进建议报告
npx skills add archestra-ai/archestra --skill archestra-dev-bench-analysis -g -y
用于编写、调试和运行 Archestra Playwright E2E 测试，支持 API/UI 固定装置、WireMock 模拟及本地/CI 环境配置。
编写或调试 E2E 测试脚本
配置 WireMock 模拟服务
启动或停止 Docker-lite/Tilt E2E 测试环境
注册新的 Playwright spec 文件
npx skills add archestra-ai/archestra --skill archestra-dev-e2e -g -y
用于修改 Archestra 前端 Next.js/React 代码、UI 组件、表单、TanStack Query hooks 及生成 API 客户端的规范。
修改平台前端 UI 组件或表单
使用 TanStack Query 进行数据获取
调用生成的 API SDK 客户端
npx skills add archestra-ai/archestra --skill archestra-dev-frontend -g -y
提供 Archestra 系统故障排查指南，涵盖 Sentry/Tempo/Prometheus 等工具使用，分析数据库连接压力、部署回归及配置问题，指导定位后端 50x 错误和运行时异常。
Archestra 系统故障排查
后端 50x 错误调查
数据库连接压力分析
部署回归问题定位
npx skills add archestra-ai/archestra --skill archestra-dev-investigate -g -y
指导如何添加LLM提供商、修改代理适配器、修复流式传输及模型处理相关Bug，涉及后端路由、类型定义、前端UI及常量配置。
添加新的LLM提供商
修改代理适配器或路由
修复流式传输或工具调用翻译错误
编辑模型获取器或模型处理逻辑
修改提供商凭证或枚举
npx skills add archestra-ai/archestra --skill archestra-dev-llm-providers -g -y
提供基于Drizzle的数据库迁移工作指南，涵盖Schema变更、数据迁移SQL编写、大表操作规范及冲突解决。包含常用命令与一致性校验流程，确保迁移安全并避免阻塞生产写入。
修改Drizzle Schema
生成或编辑迁移SQL
处理迁移元数据冲突
执行数据库状态变更
npx skills add archestra-ai/archestra --skill archestra-dev-migrations -g -y
提供 Archestra 可观测性（追踪、指标、OpenTelemetry）的规范，包括命名约定、本地环境搭建及 URL。
修改追踪或指标配置
设置本地可观测性环境
npx skills add archestra-ai/archestra --skill archestra-dev-observability -g -y
用于清理平台pnpm工作区中过期的CVE临时锁定和冗余依赖覆盖。通过验证版本成熟度或重新解析，安全移除不再需要的强制覆盖规则，保持依赖图整洁。
清理过期的npm pnpm override
移除冗余的依赖锁定配置
npx skills add archestra-ai/archestra --skill archestra-dev-override-sweep -g -y
清理 Archestra 开发环境中未使用的 worktree、本地分支、孤立进程及 OrbStack Kubernetes 资源，同时保留活跃的 Tilt 栈和未完成工作，确保系统整洁且不影响正常开发流程。
需要释放开发环境资源时
清理废弃的 Git worktree 或本地分支时
停止无用的后台进程或 K8s 资源时
npx skills add archestra-ai/archestra --skill archestra-dev-resource-cleanup -g -y
定义 Archestra 仓库中 Rust 代码的编码规范，涵盖 NAPI 绑定层与独立 Rust 工作区。规定采用“无聊 Rust”风格，强调核心逻辑与 Node 解耦、最小化公共 API、严格输入验证及可观测性集成，旨在提升代码库的可维护性与质量。
编辑平台或 AI-Labs 下的 Rust 代码
审查 Rust 项目的架构与类型设计
检查 NAPI 边界的数据转换与验证逻辑
npx skills add archestra-ai/archestra --skill archestra-dev-rust-napi -g -y
指导测试选型与分层，涵盖后端Vitest、前端及E2E规范。强调测试有效性原则，明确本地检查与合并队列流程，并指引调用专用技能处理队列监控与修复。
询问测试该写在哪里或是否必要
需要配置Vitest环境或Mock规则
处理合并队列的CI失败与修复
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 推导名称，通过 HTTP 探测远程端点获取工具列表及认证信息，编码图标并校验清单格式，最终生成 PR 供人工审核。
需要添加新的 MCP 服务器到公共目录
准备或审查 MCP 目录条目 PR
npx skills add archestra-ai/archestra --skill archestra-mcp-catalog-entry -g -y
负责将 PR 加入合并队列，监控直至合并完成，并诊断修复 CI 失败。需全程跟进直至成功或发现阻塞项，不轻易交还开发者。
用户请求将 PR 加入合并队列
需要监控 PR 合并状态
排查和修复合并组中的 CI 失败
npx skills add archestra-ai/archestra --skill archestra-merge-queue -g -y
指导在打开或更新 Archestra PR 时撰写符合规范的标题和描述，确保元数据准确反映最终代码变更。
需要为 Pull Request 编写标题
需要为 Pull Request 编写详细描述
npx skills add archestra-ai/archestra --skill archestra-pr-hygiene -g -y
Run a design arena: a coordinator fans out N subagents (default 7) that each prototype one UI section through a different lens, switchable in-app via a temporary prototype selector, refined in rounds.
npx skills add archestra-ai/archestra --skill design-arena -g -y
Use for visual design direction on greenfield, user-facing surfaces — marketing and landing pages, generated apps, portfolio-style or standalone pages. NOT for routine Archestra platform UI work (dashboards, data tables, settings, forms, existing components) — use archestra-dev-frontend for that. Upstream intent: anti-slop frontend skill for landing pages, portfolios, and redesigns; the agent reads the brief, infers the right design direction, and ships interfaces that do not look templated.
npx skills add archestra-ai/archestra --skill design-taste-frontend -g -y
管理 Archestra 软件发布流程，涵盖 Beta 与 Stable 版本发布、修复回溯移植、新稳定分支切分及配置保护。通过执行 Git 和 GitHub API 操作自动化处理发布 PR、监控合并队列并验证最终状态。
需要发布 Beta 或 Stable 版本
需要将修复补丁回溯移植到旧版本分支
需要创建新的稳定发布线
需要配置发布保护策略
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
