tooltest-fix-loop

运行工具测试时使用,以验证 MCP 服务器、解释故障并迭代此存储库中的修复。

📖 中文导读:运行工具测试时使用,以验证 MCP 服务器、解释故障并迭代此存储库中的修复。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: tooltest-fix-loop description: Use when running tooltest to validate MCP servers, interpret failures, and iterate fixes in this repo.

Tooltest fix loop

Run tooltest and iterate

  • Identify how to start the repo’s MCP server (stdio or streamable HTTP).
  • Run tooltest against it:
    • tooltest stdio --command "<server start command>"
    • tooltest http --url "<server mcp url>"
  • Read the failure report, trace the failing tool call or protocol step, and fix the smallest viable patch.
  • Re-run tooltest until it exits 0; keep tool names and schemas stable unless a spec violation requires change.

Triage guidance

  • Treat failures as either protocol handling, tool schema validation, or runtime behavior; fix in that order.
  • Prefer backward-compatible fixes; add a regression test when a failure is deterministic or easy to reproduce.
  • When the failure is intermittent, keep the smallest reproduction from the report and turn it into a test.

Reporting

  • Summarize the changes and why they address the specific tooltest failures.
  • Include the final passing tooltest output snippet.