天枢 × AI-Agent 编排 MCP server —— 驱动 Codex、TraeWork、ZCode、Kimi Code 与 Qoder CN 完成项目开发、验收、失败返修与再验收闭环。
Server has 11 tools with explicit schemas (Zod), descriptions, and capability annotations. However, descriptions are verbose (200-400+ chars, exceeding the 10-1024 optimal range), parameter descriptions are sparse or missing, and output schemas are undocumented. Tool names follow verb_noun convention well. Error handling and recovery guidance are absent. Schemas are present but lack granular parameter documentation.
仅在用户明确审阅并授权后批准视觉基准。必须核对候选摘要与批准说明;自动返修禁止调用。宿主必须实施实际审批控制。
取消运行中任务:CLI agent 终止进程树;GUI agent(codex 等)尽力点击界面停止按钮并等待 GUI 空闲(有界超时),未确认停止时结果中明示。排队中任务直接移除。对已处于终态的 GUI 任务,本调用兼任人工确认入口:人工核实窗口中已无残留运行后调用,可清除 meta 的 guiStopUnconfirmed 待确认标记(不改终态)。
恢复处于 needs_user 的任务。zcode:agent_question 时 message 发往原会话,关闭旧实例/登录/系统权限场景中 message 仅作已处理确认。codex:user_confirmation 时重新接入观察 GUI 内运行(不发送消息);login_required 时复检环境后重发任务书。qoder:Agent 提问通过专用答题控件回复;多题 message 使用完整问题文字到答案的 JSON 对象。审批或环境处理后仅恢复观察,提交不明时禁止重发。
查看当前 agent 适配与可执行探测结果(含未安装/调研占位提示)。
取某轮验收报告全文(report.md)。round 缺省取最新一轮。
列出历史任务(可按项目路径 / 状态过滤,limit 默认 50)。
Descriptions are excessively verbose (200-400+ chars), exceeding the 10-1024 optimal range. run_task and continue_task descriptions are 300+ chars with dense technical jargon. LLMs waste tokens parsing these; clarity suffers.
Parameter descriptions are missing or minimal. PrepareBaselineSchema and ApproveBaselineSchema are imported but their parameter docs are not visible in source. Input schemas exist but lack per-parameter descriptions for LLM guidance.
Output schemas are undocumented. No tool description states what fields are returned or their structure. LLMs cannot plan downstream calls or extract required data without knowing response shape.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | <=2025-11-25 | v2 |
准备视觉基准候选,返回摘要与预览;不采用正式基准。需要用户授权。
查询任务状态 / 进度 / 最近日志尾部(默认 agent.log 末 40 行)。返回任务 meta 与日志片段。
手动返修:把终态任务(failed/needs_attention)重新入队续跑,同一 agent/项目与轮次记账。feedback 为追加指示(建议带上一次验收失败摘要)。
派活:启动外部 AI-Agent 开发任务并可自动验收返修,异步返回 taskId。ZCode 要求 model=供应商/模型,不支持 mode;TraeWork 的 model 可选并支持 Work/Code/Design mode。task/context 内的 ZCode 项目路径引用会在发送前校验。Qoder CN 要求已有 projectPath 和可读 planDoc;modelSource 可选 default/custom,省略模型或等级则沿用当前设置。思考等级通过模型管理保存为全局偏好,权限模式不变;macOS research 禁止派发。可选 idempotencyKey(1..128 字符):同一 key 在 TTL(默认 24h)内重复提交恒返回原 taskId 与当前状态、不新建任务,参数变更则报冲突——重试请复用同一 key。
对已完成任务或项目路径执行一次验收(不改源码):自动命令检查 + 代码分析(相对 git 基线)。可用 extraChecks 临时加验。需任务/项目二选一。可选 idempotencyKey:同一 key 重试不重跑验收——执行中的同键请求返回进行中提示,已完成的直接返回既有报告与轮次,参数变更则报冲突。
Error handling and recovery guidance are absent. No tool description explains what errors can occur, whether they are retryable, or what the LLM should do next. Agents cannot self-correct on failures.
Destructive tools (approve_visual_baseline, cancel_task, rework_task) lack confirmation or dry-run patterns. Descriptions warn against misuse but provide no mechanism to prevent accidental execution.