tianshu-mcp

Overview Schema Source Related Servers Discussions Admin

run_task

run_task

Idempotent

Launch external AI-agent development tasks asynchronously, returning a taskId, with automatic verification and failure rework loops.

Instructions

派活：启动外部 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。可选 dryRun=true 进入干跑模式（先审后做）：agent 只分析规划、输出将要修改的文件清单与方案、不动源码；验收引擎只做静态分析（引用文件是否存在、拟改位置是否存在、明显逻辑冲突），跳过 typecheck/test/build。dryRun 需提供 projectPath、忽略 autoVerify、不进入自动返修；产物为独立报告（meta.dryRunReportFiles，不消耗验收轮次）与方案文档（meta.dryRunPlanDoc，可直接作为后续正式任务的 planDoc）。默认关闭。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`mode`	No
`task`	Yes
`model`	No
`dryRun`	No
`agentId`	No
`context`	No
`planDoc`	No
`autoVerify`	No
`modelSource`	No
`projectPath`	No
`designSystem`	No
`autoFixRounds`	No
`taskTimeoutMs`	No
`idempotencyKey`	No
`reasoningLevel`	No
`designDirection`	No
`acceptanceOverride`	No
`allowCreateProject`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.7.6Sep 30, 2026
- addedInput schema / properties / designDirection
```
Added value: +{
+  "minLength": 1,
+  "type": "string"
+}
```
Changed1 schema field changedv0.6.7Sep 24, 2026
- addedInput schema / properties / dryRun
```
Added value: +{
+  "type": "boolean"
+}
```

Changed1 schema field changedv0.6.4Sep 24, 2026

addedInput schema / properties / acceptanceOverride

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "checks": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "cmd": {
+            "anyOf": [
+              {
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "type": "array"
+              }
+            ]
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "optional": {
+            "type": "boolean"
+          },
+          "timeoutMs": {
+            "exclusiveMinimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "name",
+          "cmd"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "requireChanges": {
+      "type": "boolean"
+    },
+    "verifyConcurrency": {
+      "type": "number"
+    },
+    "visual": {
+      "additionalProperties": false,
+      "properties": {
+        "allowedOrigins": {
+          "default": [],
+          "items": {
+            "format": "uri",
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "baselineRoot": {
+          "default": "tests/visual/baselines",
+          "minLength": 1,
+          "type": "string"
+        },
+        "browser": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "mode": {
+                  "const": "managed",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "executablePath": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "mode": {
+                  "const": "chrome",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "executablePath": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "mode": {
+                  "const": "edge",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "executablePath": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "mode": {
+                  "const": "executable",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "mode",
+                "executablePath"
+              ],
+              "type": "object"
+            }
+          ],
+          "default": {
+            "mode": "managed"
+          }
+        },
+        "content": {
+          "additionalProperties": false,
+          "default": {},
+          "properties": {
+            "allowRemote": {
+              "default": false,
+              "type": "boolean"
+            },
+            "argsTemplate": {
+              "items": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "minItems": 1,
+              "type": "array"
+            },
+            "cache": {
+              "default": true,
+              "type": "boolean"
+            },
+            "command": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "cwd": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+            },
+            "enabled": {
+              "default": false,
+              "type": "boolean"
+            },
+            "env": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
+            },
+            "minConfidence": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
+            },
+            "samples": {
+              "default": 3,
+              "maximum": 9,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "timeoutMs": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 90000
+            }
+          },
+          "type": "object"
+        },
+        "contents": {
+          "default": [],
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "allowRemote": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/allowRemote"
+              },
+              "argsTemplate": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/argsTemplate"
+              },
+              "blocking": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/blocking"
+              },
+              "command": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/command"
+              },
+              "cwd": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/cwd"
+              },
+              "env": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
+              },
+              "expect": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/expect"
+              },
+              "files": {
+                "items": {
+                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "id": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
+              },
+              "samples": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/samples"
+              }
+            },
+            "required": [
+              "expect",
+              "id",
+              "files"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "defaults": {
+          "additionalProperties": false,
+          "default": {},
+          "properties": {
+            "capture": {
+              "default": "viewport",
+              "enum": [
+                "viewport",
+                "fullPage",
+                "element"
+              ],
+              "type": "string"
+            },
+            "colorScheme": {
+              "default": "light",
+              "enum": [
+                "light",
+                "dark",
+                "no-preference"
+              ],
+              "type": "string"
+            },
+            "locale": {
+              "default": "en-US",
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxDiffRatio": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold",
+              "default": 0.001
+            },
+            "pixelThreshold": {
+              "default": 0.1,
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "selector": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "timezone": {
+              "default": "UTC",
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "images": {
+          "default": [],
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "aspectRatio": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
+              },
+              "dpi": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
+              },
+              "fileSizeBytes": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
+              },
+              "files": {
+                "items": {
+                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "formats": {
+                "items": {
+                  "enum": [
+                    "png",
+                    "jpeg",
+                    "webp"
+                  ],
+                  "type": "string"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "height": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
+              },
+              "id": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
+              },
+              "optional": {
+                "default": false,
+                "type": "boolean"
+              },
+              "transparency": {
+                "enum": [
+                  "transparent",
+                  "opaque"
+                ],
+                "type": "string"
+              },
+              "width": {
+                "additionalProperties": false,
+                "properties": {
+                  "exact": {
+                    "exclusiveMinimum": 0,
+                    "type": "number"
+                  },
+                  "max": {
+                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
+                  },
+                  "min": {
+                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "required": [
+              "id",
+              "files"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "limits": {
+          "additionalProperties": false,
+          "default": {},
+          "properties": {
+            "artifactBytes": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 524288000
+            },
+            "concurrency": {
+              "default": 1,
+              "exclusiveMinimum": 0,
+              "maximum": 4,
+              "type": "integer"
+            },
+            "decodedPixels": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 32000000
+            },
+            "inputBytes": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 20971520
+            },
+            "itemTimeoutMs": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 60000
+            },
+            "navigationTimeoutMs": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 30000
+            },
+            "roundTimeoutMs": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 300000
+            },
+            "serviceTimeoutMs": {
+              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
+              "default": 60000
+            },
+            "stabilitySamples": {
+              "default": 3,
+              "exclusiveMinimum": 0,
+              "maximum": 3,
+              "minimum": 2,
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        },
+        "pages": {
+          "default": [],
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "baseline": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+              },
+              "capture": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/capture"
+              },
+              "content": {
+                "additionalProperties": false,
+                "properties": {
+                  "allowRemote": {
+                    "type": "boolean"
+                  },
+                  "argsTemplate": {
+                    "items": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                  },
+                  "blocking": {
+                    "default": false,
+                    "type": "boolean"
+                  },
+                  "command": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "cwd": {
+                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+                  },
+                  "env": {
+                    "additionalProperties": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "propertyNames": {
+                      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+                    },
+                    "type": "object"
+                  },
+                  "expect": {
+                    "maxLength": 4000,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "samples": {
+                    "maximum": 9,
+                    "minimum": 1,
+                    "type": "integer"
+                  }
+                },
+                "required": [
+                  "expect"
+                ],
+                "type": "object"
+              },
+              "id": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
+              },
+              "maskSelectors": {
+                "default": [],
+                "items": {
+                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                },
+                "type": "array"
+              },
+              "maxDiffRatio": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
+              },
+              "optional": {
+                "default": false,
+                "type": "boolean"
+              },
+              "pixel": {
+                "default": true,
+                "type": "boolean"
+              },
+              "pixelThreshold": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
+              },
+              "readySelector": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+              },
+              "route": {
+                "default": "/",
+                "type": "string"
+              },
+              "selector": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+              },
+              "source": {
+                "anyOf": [
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "type": {
+                        "const": "existing",
+                        "type": "string"
+                      },
+                      "url": {
+                        "format": "uri",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "type",
+                      "url"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "port": {
+                        "exclusiveMinimum": 0,
+                        "maximum": 65535,
+                        "type": "integer"
+                      },
+                      "root": {
+                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+                      },
+                      "type": {
+                        "const": "static",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "type",
+                      "root"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "args": {
+                        "default": [],
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      },
+                      "command": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "cwd": {
+                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot",
+                        "default": "."
+                      },
+                      "env": {
+                        "additionalProperties": {
+                          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                          "type": "string"
+                        },
+                        "default": {},
+                        "type": "object"
+                      },
+                      "readyUrl": {
+                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
+                      },
+                      "type": {
+                        "const": "command",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "type",
+                      "command",
+                      "readyUrl"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              "steps": {
+                "default": [],
+                "items": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "selector": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                        },
+                        "type": {
+                          "const": "click",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "type",
+                        "selector"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "selector": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                        },
+                        "type": {
+                          "const": "input",
+                          "type": "string"
+                        },
+                        "value": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "type",
+                        "selector",
+                        "value"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "selector": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                        },
+                        "type": {
+                          "const": "hover",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "type",
+                        "selector"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "selector": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                        },
+                        "type": {
+                          "const": "scroll",
+                          "type": "string"
+                        },
+                        "x": {
+                          "type": "number"
+                        },
+                        "y": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "type"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "durationMs": {
+                          "exclusiveMinimum": 0,
+                          "maximum": 60000,
+                          "type": "integer"
+                        },
+                        "selector": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
+                        },
+                        "state": {
+                          "enum": [
+                            "visible",
+                            "hidden"
+                          ],
+                          "type": "string"
+                        },
+                        "type": {
+                          "const": "wait",
+                          "type": "string"
+                        },
+                        "url": {
+                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
+                        }
+                      },
+                      "required": [
+                        "type"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "type": "array"
+              },
+              "storageState": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
+              },
+              "viewports": {
+                "items": {
+                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
+                },
+                "minItems": 1,
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "source"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "viewports": {
+          "default": [
+            {
+              "deviceScaleFactor": 1,
+              "height": 720,
+              "id": "desktop",
+              "width": 1280
+            },
+            {
+              "deviceScaleFactor": 1,
+              "height": 844,
+              "id": "mobile",
+              "width": 390
+            }
+          ],
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "deviceScaleFactor": {
+                "default": 1,
+                "exclusiveMinimum": 0,
+                "maximum": 4,
+                "type": "number"
+              },
+              "height": {
+                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width"
+              },
+              "id": {
+                "maxLength": 100,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
+                "type": "string"
+              },
+              "width": {
+                "exclusiveMinimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "id",
+              "width",
+              "height"
+            ],
+            "type": "object"
+          },
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedv0.6.2Sep 23, 2026
- addedInput schema / properties / idempotencyKey
```
Added value: +{
+  "type": "string"
+}
```

Changed2 schema fields changedv0.5.8Sep 22, 2026

addedInput schema / properties / modelSource

Added value: +{
+  "enum": [
+    "default",
+    "custom"
+  ],
+  "type": "string"
+}

changedInput schema / properties / reasoningLevel / enum

Previous value: -[
-  "低",
-  "中",
-  "高",
-  "low",
-  "medium",
-  "high"
-]New value: +[
+  "低",
+  "中",
+  "高",
+  "low",
+  "medium",
+  "high",
+  "max",
+  "极高",
+  "xhigh",
+  "最大",
+  "关闭思考",
+  "on",
+  "off"
+]

Changed2 schema fields changedv0.5.3Sep 15, 2026
- addedInput schema / properties / allowCreateProject
```
Added value: +{
+  "type": "boolean"
+}
```
- changedInput schema / required
```
Previous value: -[
-  "projectPath",
-  "task"
-]New value: +[
+  "task"
+]
```

Changed3 schema fields changedv0.3.1Sep 12, 2026

addedInput schema / properties / designSystem

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / planDoc

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / reasoningLevel

Added value: +{
+  "enum": [
+    "低",
+    "中",
+    "高",
+    "low",
+    "medium",
+    "high"
+  ],
+  "type": "string"
+}

Changed2 schema fields changedv0.1.9Sep 9, 2026

addedInput schema / properties / mode

Added value: +{
+  "enum": [
+    "Work",
+    "Code",
+    "Design"
+  ],
+  "type": "string"
+}

addedInput schema / properties / model

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

First observedv0.1.0Sep 7, 2026

TDQS

A4/5.0

Behavior4/5

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

Annotations only declare openWorld/write/idempotent/non-destructive; the description adds real behavioral detail beyond them: idempotency key TTL of 24h, conflict on changed parameters, dryRun's no-source-change contract and static-only acceptance skipping typecheck/test/build, and a global side effect (reasoning level persisted as a global preference while permission mode is unchanged). It does not describe return payload shape or failure modes, keeping it at 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?

Front-loaded with the core purpose and return contract, then provider-specific rules, then the optional idempotencyKey and dryRun behavior. It is one dense block with no headings or bullets, which makes the long provider-rule sentence hard to scan, but every clause carries operational information rather than filler.

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

Completeness3/5

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

For an 18-parameter tool with a deeply nested acceptanceOverride and no output schema, the description covers the primary flow, provider prerequisites and dry-run/idempotency semantics well. It nevertheless leaves several top-level parameters (agentId, designSystem, designDirection, autoFixRounds, taskTimeoutMs, allowCreateProject) and the entire acceptance-override mechanism unexplained, and no output schema exists to compensate.

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

Parameters3/5

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

Schema description coverage is 0%, so the description carries the full burden, and it explains task/context, model, mode, projectPath, planDoc, modelSource, reasoningLevel, idempotencyKey, dryRun and partially autoVerify. However it says nothing about agentId, designSystem, designDirection, autoFixRounds, taskTimeoutMs, allowCreateProject, or the large nested acceptanceOverride object, so a substantial share of the 18 parameters remains undefined.

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?

"启动外部 AI-Agent 开发任务并可自动验收返修，异步返回 taskId" states a specific verb (start a dev task), the resource (external AI-agent task), the async return contract (taskId), and the post-processing behavior (auto verification/rework). An agent can distinguish this from siblings like cancel_task, verify_task, rework_task and continue_task purely from the text.

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

Usage Guidelines4/5

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

Gives concrete when-to-use conditions per provider family (ZCode requires model=provider/model and no mode; TraeWork model optional with Work/Code/Design; Qoder CN requires projectPath plus readable planDoc), plus when to set dryRun and when to reuse idempotencyKey. It stops short of naming sibling tools as alternatives (e.g. use verify_task vs relying on autoVerify), so it is strong context without explicit routing.

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

Deploy Server

run_task

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools