chart_kuznets_cycle

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

没有提供任何注解，因此描述承担全部行为披露责任。描述仅说明'生成图表'，未提及是否覆盖已有文件、数据来源、计算所需时间、图表格式或失败条件。对于无注解的绘图工具，行为透明度严重不足。

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

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

单句描述没有冗余信息，简洁性本身合格。但这是'过简'而非精炼——一句话只传达了核心动作，缺少任何使用场景或参数说明，信息密度虽高但不足以支撑正确调用。

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

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

工具属于庞大家族（有chart_kondratiev_cycle、chart_kitchin_cycle、chart_juglar_cycle、kuznets_cycle、data_kuznets、data_kuznets_extended等），具备输出schema和2个可选参数，但描述仅有一句话。未说明图表数据来源、与kuznets_cycle/data_kuznets的分工、输出行为，对一个需要选择合适工具的场景来说完整性明显不足。

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

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

Schema描述覆盖率为0%，描述必须补偿参数含义，但描述对limit和output_path只字未提。虽然参数名暗示了'数量限制'和'输出路径'，且默认值给出了合理提示，但agent无法确知limit限制的是什么（数据点数？周期数？）以及output_path是否会被覆盖。描述完全未补偿schema的空白。

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

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

描述明确包含具体动词'生成'和资源'库兹涅茨周期分析图'，且附注'(房地产周期)'帮助理解概念。虽然与chart_kondratiev_cycle、chart_kitchin_cycle等同族图表工具能通过周期类型区分，但未说明与kuznets_cycle（数据工具）的区别，缺少显式的兄弟区分。

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

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

完全没有提供任何使用时机或替代方案的指引。在大量周期相关兄弟工具（chart_kondratiev_cycle、chart_juglar_cycle、kuznets_cycle、data_kuznets、data_kuznets_extended）并存的情况下，agent无法判断何时该选本工具而非data_kuznets获取数据或chart_kondratiev_cycle绘制其他周期，也没有说明先取数据再绘图的工作流。

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