工具契约与执行边界

函数名不等于协议

读取工具要说明允许的ID、目录和返回长度。实现再次校验输入，不能相信模型遵守schema。错误类型帮助判断需要补充输入还是停止。

失败应可解释

区分ok/error以及是否可重试。无权限和参数错误不会因重复相同调用改善。写文件、发消息是独立权限层，首版只用已允许资料。

{"ok":true,"documentId":"guide-01","text":"..."}
{"ok":false,"error":{"code":"NOT_FOUND","retryable":false}}
{"ok":false,"error":{"code":"TIMEOUT","retryable":true}}

资料不扩大权限

README或正文要求改身份仍是资料。提示词提醒有用，但工具实现的权限才是实际边界。日志保存ID、耗时与结果类型，少保存敏感原文。