Skip to main content
Glama

wb_todo_del

Delete a todo permanently by providing its ID prefix. Requires explicit confirmation because the action cannot be undone.

Instructions

删除待办(不可恢复,慎用)。对应 CLI:todo del。参数:id*(id 前缀)。写操作须 confirm:true。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesid 前缀
confirmNo写操作必传 true(安全门)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv5.10.1

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

没有任何注解,描述承担了行为披露责任。它明确说明了破坏性结果(不可恢复)和安全门(confirm:true),这对删除类工具至关重要。但未说明 id 前缀匹配到多个待办时的行为、返回结果或权限要求,略有不完整。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

描述极其精简,先用“不可恢复,慎用”突出关键风险,再以简短句说明 CLI 对应、参数和安全要求。每句话都有信息量,没有冗余内容。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

作为简单的删除工具,描述覆盖了用途、不可逆性、参数和确认要求,配合完整 schema 已足够支撑调用。但没有提及 id 前缀匹配多个待办时的处理方式,也没有输出说明,在无 output schema 的情况下略显不足。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema 描述覆盖率达到 100%,id 和 confirm 的说明都已存在于输入 schema 中。描述中的“id 前缀”和“写操作须 confirm:true”基本是对 schema 信息的重复,没有提供额外语义,因此维持基线 3 分。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述以明确的动词“删除”和资源“待办”开头,并附加“不可恢复”的警示,核心用途一目了然。与兄弟工具 wb_todo_done、wb_todo_edit、wb_todo_tag 相比,删除语义和不可逆性足以区分。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述明确说明这是删除操作、不可恢复、需谨慎使用,并且写操作必须传 confirm:true,提供了关键使用约束。但没有显式说明何时应使用删除而非 wb_todo_done(标记完成),因此未达到满分。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.