Linting Prose in CI

说明与用途

在 CI 中对工具描述进行 lint 检查发现合同错误导致构建失败。添加使用提示并对齐描述修复了问题，构建成功。

问题

Wording changes in tool contracts can break agent behavior; they need to be treated like code changes and validated in CI.

结果

The linter caught contract issues that caused CI failures; fixing wording restored CI success and improved agent telemetry.

工作流

• Push commit with linter and contract changes
• GitHub Action runs contract linter
• Linter reports errors for missing provenance, usage cues, token budget, and drift
• Fix commit adds missing clauses and aligns descriptions
• GitHub Action runs linter again
• Linter passes with zero errors and alias warnings
• CI build succeeds

证据

The linter parses the contract straight out of the McpToolTrigger and McpToolProperty attributes, the authoritative copy, the same source the deployed description hash is computed from.

来源

The fix commit added when-to-call clauses to two tools ... and aligned the three Bicep descriptions with the C#. The build went green, and the budget rule priced the edit: the contract grew from 277 to 302 tokens, 25 tokens for two sentences of disambiguation, well under budget.

来源