copy_homework

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

沒有任何註解，因此描述承擔全部說明負擔。它透露了有用的複製語意（來源作業的設定會沿用，只有標題和日期可調整），但沒有說明哪些內容不會被複製（例如繳交紀錄、成績），也沒有說明建立後學生是否會看到，還沒有說明 consentToken 參數所暗示的同意權杖要求，也沒有說明會回傳什麼。

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?

對於一個建立型工具來說，這已達到最低可接受程度：它說明了工具做什麼以及參數由結構描述完整記錄，但沒有輸出結構描述，而且描述沒有告訴代理成功後會拿到什麼（新的作業 ID？），也沒有告訴代理同意權杖要求。

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?

結構描述覆蓋率為 100%，因此所有五個參數（包括 consentToken 與日期格式）都已有結構描述說明——基準值為 3。描述只補充了 newTitle/newDeadline 是為了方便而提供的主要調整項，除此之外沒有增加超出結構描述的内容。

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?

明確的動詞+資源：「複製既有作業」以現有作業為範本建立新一輪作業，並將其對應到作業清單中的「複製」按鈕。它隱含地與 create_homework（從零開始）區分開來，但並未明確點名同類工具。

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?

它說明這是助教功能，並描述了情境（複製後僅需調整標題和截止日期），這隱含了使用時機。但描述沒有明確說明何時不應使用它，也沒有點名任何替代工具（例如 create_homework 或 copy_exam），而是留給代理推斷。

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