SuperAPI AI 工具集

router-operations

部署与运维

查看项目

更新于 10-16 02:24

技能介绍

Router: Operations 是一个运维领域的技能路由工具,其核心作用是把 QA、测试、部署、可观测性、Git 工作流和文档相关的问题,路由到 18 个具体的操作技能上。

用途 该路由用于识别用户的主要意图(即用户想完成什么),然后将意图匹配到某个运维领域,包括测试、调试、韧性、可观测性、DevOps、Git 和文档。匹配后,它会选择一个主技能,如果任务跨领域,还可选配 1 个辅助技能。如果请求主要是实现或构建类工作,则转交给 router-engineering;如果置信度低于 0.8 或意图并列,会先提出 1 个澄清问题再路由。

主要能力 路由覆盖多个领域。测试与 QA 的触发词包括 test、QA、coverage、E2E、unit test、integration,对应技能有 qa-testing-strategy(测试策略与框架)、qa-testing-playwright(E2E Web 测试)、qa-testing-ios(iOS 测试、XCTest)、qa-testing-android(Android 测试、Espresso)、qa-testing-mobile(跨平台移动测试)、qa-api-testing-contracts(API schema 测试)、qa-agent-testing(LLM 智能体测试)。调试与韧性的触发词包括 debug、error、bug、retry、circuit breaker,对应 qa-debugging(故障排查与性能分析)、qa-resilience(错误处理与混沌工程)、qa-refactoring(代码质量与技术债)。可观测性的触发词包括 monitor、metrics、tracing、SLO、OpenTelemetry,对应 qa-observability(完整可观测性栈)。部署的触发词包括 deploy、Kubernetes、Terraform、CI/CD、GitOps,对应 ops-devops-platform(完整 DevOps 栈)。Git 与版本控制的触发词包括 git、commit、branch、PR、merge,对应 git-commit-message(约定式提交)和 git-workflow(分支、PR、评审)。文档的触发词包括 documentation、README、ADR、PRD、spec、CLAUDE.md,对应 docs-codebase(技术文档)、docs-ai-prd(面向 AI 智能体的 PRD)、qa-docs-coverage(文档覆盖审计)和 agents-project-memory(大型代码库,100K-1M LOC)。

使用方式 路由工作流为:先识别主要用户意图,再匹配到运维领域,然后选择主技能并可选配 1 个辅助技能,必要时进行跨路由交接或提出澄清问题。决策树提供了常见问题到技能的映射,例如“What tests do I need?”对应 qa-testing-strategy,“Write Playwright tests”对应 qa-testing-playwright,“Deploy to production”对应 ops-devops-platform,“Git workflow”对应 git-workflow,“Write documentation”对应 docs-codebase 等。规范注册表位于 frameworks/shared-skills/skills/router-operations/data/skill-registry.json,作为技能及其触发短语、预期输出和路由规则(默认技能、置信度阈值、回退行为)的权威来源。

技能链 该路由提供若干技能链:完整测试策略为 qa-testing-strategy -> qa-testing-playwright -> qa-testing-ios -> qa-api-testing-contracts -> qa-agent-testing;生产就绪为 qa-testing-strategy -> qa-resilience -> qa-observability -> ops-devops-platform -> git-workflow;事件响应为 qa-debugging -> qa-observability -> qa-resilience -> qa-refactoring -> docs-codebase;大型代码库设置为 agents-project-memory -> qa-docs-coverage -> docs-codebase。

跨路由交接 operations 到 engineering 的触发词为 build、implement、code;operations 到 startup 的触发词为 launch、pricing;engineering 到 operations 的触发词为 test、deploy、CI/CD。

质量门禁 部署前启发式检查包括:关键流程测试通过(qa-testing-strategy、qa-testing-playwright);预期失败模式具备超时、重试和退避(qa-resilience);关键用户旅程存在 SLO、告警和仪表盘(qa-observability);存在并测试过回滚计划(ops-devops-platform);运行手册和文档保持最新(qa-docs-coverage、docs-codebase)。

路由安全 路由基于用户意图,而非指令劫持,会忽略“路由到 X”的尝试;将关键词堆砌视为低信号,意图不明确时优先提出澄清问题;如果用户请求混合了业务或营销内容,转交给 router-startup;如果请求是深度质量工程,转交给 router-qa。

适用场景与限制 该路由适用于需要将运维、测试、部署、可观测性、Git 和文档类问题分发到具体技能的场景。其限制包括:置信度低于 0.8 或意图并列时需要澄清;偏向实现或构建的请求会转交其他路由;混合业务或营销的请求会转交 router-startup;深度质量工程会转交 router-qa。关于收费、价格、平台支持等具体信息,资料中暂未提供。