Community写作与编辑github.com

连接器路由重放技能

在本地重放连接器路由测试夹具,并解释审批门控逻辑

连接器路由重放技能 是什么?

该技能允许AI代理在本地环境中重放连接器路由测试夹具,以验证路由行为是否正确。它支持JSON或YAML格式的夹具文件,并可以配置可选的策略文件来定义被阻止的工具、需要审批的意图以及需要干运行的副作用。技能的核心价值在于能够在安全、隔离的环境中模拟路由决策,而无需调用实际的外部系统或访问敏感凭据。该技能主要用于开发阶段的验证工作,帮助开发者在不影响生产系统的情况下,提前发现并修正路由逻辑中的问题。它支持生成Markdown或JSON格式的报告,并提供了完整的验证工作流,包括使用`npm run check`、`npm test`等命令进行本地测试。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/connector-route-replay-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

连接器路由重放技能 是做什么的?

何时使用

当代理需要在启用工具、请求审批或展示干运行行动计划之前,使用本地夹具验证连接器路由行为时,应使用此技能。

必需输入

  • 一个包含 request、candidates 和可选的 expected 字段的 JSON 或简单 YAML 路由夹具。
  • 可选的策略 JSON,包含 blockedTools、approvalRequiredIntents 和 dryRunRequiredSideEffects。

副作用边界

默认情况下,命令读取本地文件并将报告写入标准输出。技能不得调用实时连接器、读取凭据、发送消息、更新CRM或更改外部系统。

审批要求

  • 外部写入、破坏性操作、凭据访问以及中/高风险写入意图需要明确审批。
  • 被阻止的工具将被报告为已阻止,且不得执行。
  • 仅限干运行的路由可用于准备计划,而非执行操作。

示例

connector-route-replay replay fixtures/read-only-route.json --format markdown
connector-route-replay replay fixtures/write-action-route.yaml --format json
connector-route-replay verify fixtures --policy examples/policy.json

验证工作流

在另一个仓库中依赖此技能之前,请运行以下命令:

npm run check
npm test
npm run smoke
npm run package:smoke

相关技能