努伊概括

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

适用于 MCP 和技能输出

对于任一输出格式,泛化逻辑都是相同的: MCP 输出:编辑workbench/mcp_servers/<app>/<server>/operations/<tool>.py — async def execute(...) 的主体。 server.py中的FastMCP工具签名镜像了execute()签名,因此重命名参数还需要更新server.py装饰器参数。

重要规则(切勿违反)

切勿一次重写所有工具 - 为每个工具提出新名称和参数列表,并在编辑任何文件之前获得用户批准 始终保留现有的执行机制(URL、方法、标头、CDP 与 httpx),除非故意切换模式 - 仅 Python 函数接口更改记录中静态的硬编码值(会话路由参数、构建标签、bl、f_sid、reqid、 soc_app等)——不要向调用者公开基础设施参数

0a。查找并测试服务器

运行快速端到端测试:

0b。对结果进行分类

结果 · 诊断 · 下一步 200 使用真实数据 · 工具正常工作 — 跳到阶段 2(界面清理) No Tabby page matching '<domain>' · 目标站点上没有打开任何选项卡 · 在 Tabby 浏览器中打开站点,或 tabby session ensure --profile <id> 9222 上的连接被拒绝 · Tabby 会话未运行 · tabby session ensure --profile <id> CORS 错误 / credentials include not allowed · 跨源获取被阻止 ·使用--execution-mode http重新导出

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
Docker
运行环境要求
Python · Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
阶段 0 — 诊断执行策略

在接触工具名称或参数之前,请检查这些工具是否实际工作。

02
第 2 阶段 — 了解服务器

阅读`tools.json` - 记下所有工具名称及其原始参数名称。阅读每个 `operations/<name>.py` — 了解调用:URL、方法、请求主体结构,哪些参数是基础设施与业务输入。询问用户:*“您记录了哪些工作流程?用通俗易懂的语言描述您在做什么 - 例如:‘我搜索了 6 月 1 日从福塔雷萨飞往西雅图的 1 名成人航班’。”*

03
第 3 阶段 — 缩小每个工具的间隙

对于每个工具,仅询问了解哪些参数携带业务输入所需的问题:“此工具中的哪个参数控制[您描述的事物]?您知道在记录过程中使用了什么值吗?” “这个工具发布到`[endpoint]`——这是主要的[操作]吗?它需要用户提供什么输入?”对于不透明的主体:“请求主体似乎是二进制编码的。根据您所描述的内容(出发地、目的地、日期),您认为这些原始参数中的哪一个包含每个值?”

04
第 4 阶段 — 一次重写一个工具

对于每个工具,请遵循以下顺序:

05
阶段 5 — 测试后迭代

重写所有工具后,进行最后的文档刷新:然后告诉用户:“完成。`API.md`是最新的。请重新启动 Claude Code(关闭并重新打开,或运行`/reconnect`)以重新加载更新的工具。然后尝试调用工作流程 - 例如:‘搜索 6 月 1 日从福塔雷萨飞往西雅图的航班’。”当用户报告结果时,修复任何问题:问题·修复

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。