Skip to main content
Glama

独行录 / opcmenu

回报成长行动的真实结果

report_growth_action_outcome
Idempotent

【需要登录】【何时用】get_my_growth_plan 里的某一步真做掉之后如实回报结果。note 写你实际做了什么、对方实际怎么回,别写计划——SUCCEEDED / LEARNED / BLOCKED 缺 note 会被直接拒。

【组合链】get_my_growth_plan → 取 actions[].id 或 completed[].id(needsResultReportIds 里的优先补)→ 本工具 → 返回体就是重排后的新计划,接着做下一步。

【口径/坑】① 会跑平台 LLM 并占一把 45 秒的状态锁:一条一条报,别并发;撞 409 别退避轮询,照返回体里的 exits 走。② requestId 是服务端幂等键,重试务必原样重传;换了内容就要换新的(留空自动生成)。③ STARTED 只是「开始做」的占位,做完事直接报三选一,别专门刷它;DEFERRED / STARTED 走不进补录腿。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
noteNo
outcomeYesSUCCEEDED 做成了 / LEARNED 没成但有发现 / BLOCKED 卡住了(这三个必须带 note)/ DEFERRED 暂缓 / STARTED 只是开始做
actionIdYes来自 get_my_growth_plan 的 actions[].id 或 completed[].id
requestIdNo幂等键 uuid:重试请原样重传同一个;留空自动生成

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.7/5.0
Behavior4/5

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

注释已提供readOnlyHint=false、idempotentHint=true等,描述额外披露了会跑LLM并占用45秒状态锁、409处理方式、requestId幂等细节、note必填规则等,这些超越了注释。描述与注释一致,无矛盾。因为注释已覆盖基础信息,描述增加的是具体行为细节,故评4分。

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

Conciseness4/5

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

描述较长但组织清晰,分为【需要登录】【何时用】【组合链】【口径/坑】等部分,每句都有价值。虽然部分信息有重复(如note要求),但整体紧凑,没有冗余。评4分因为略显啰嗦但可接受。

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

Completeness5/5

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

考虑到没有输出模式,描述说明了返回体就是重排后的新计划,提供了必要的上下文。工具涉及并发、幂等、状态锁等复杂行为,描述全部覆盖,没有遗漏关键信息。完整度很高。

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

Parameters5/5

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

模式覆盖75%,但描述对每个参数都提供了额外语义:note必须写实际做了什么,outcome枚举三选一且缺note会被拒,actionId来源明确,requestId是幂等键且重试需原样重传。这些补充了模式未说明或说明不完整的内容,对调用至关重要。

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?

描述明确说明这是用于报告成长计划中某一步的真实结果,动词'报告'、资源'成长行动结果',并指明前置是get_my_growth_plan中的步骤。与兄弟工具(如get_my_growth_plan)区分清楚,后者是获取计划,前者是回报结果。

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

Usage Guidelines5/5

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

描述给出了明确的时机(真做掉之后)、组合链(get_my_growth_plan→取id→本工具→下一步),并明确提到'别并发'、'撞409别退避轮询'等排除条件,还指出了STARTED仅作为占位不应专门刷。提供了完整的使用语境和替代选择。

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources