Mark a prop as a signature prop to track its consistency across recurring shots, or unmark it by setting signature to false.
标记/取消「招牌道具」(会在多镜复现的关键道具,加强一致性追踪)。signature=false 取消。免费。
| Name | Required | Description | Default |
|---|---|---|---|
| prop_id | Yes | ||
| signature | No | 默认 true 标记;false 取消 |
Changes observed during successful MCP inspections.
v0.1.57Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
沒有 annotations，因此描述需承擔行為揭露責任。它揭露了變更語意（標記/取消）、效果（加強一致性追蹤）與免費成本，但未說明回傳值、冪等性，或 prop 是否需已存在。
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?
一句話即可完整表達動詞、資源、用途與 boolean 行為，資訊密度高且無冗詞，核心動作置於句首。
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?
此工具結構簡單（2 個參數、無巢狀物件），描述已涵蓋目的、使用情境、boolean 語意與成本。未說明回傳行為或前置條件，但對這個複雜度而言缺口不大。
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?
signature 參數在 schema 已有預設值與「false 取消」說明，描述進一步呼應此用法；但 prop_id 沒有描述，schema 覆蓋率僅 50%，描述也未補足 prop_id 的語意。
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?
描述以明確動詞「标记/取消」搭配資源「招牌道具」，並解釋其含義（多鏡復現、加強一致性追蹤），語意清楚且與其他 prop 相關工具（如 update_prop）可區分。
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?
描述說明了適用情境（關鍵道具在多鏡中復現、需要一致性追蹤），但沒有明確指出何時不該使用，也未點名替代工具。使用時機靠推斷而非顯式說明。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.