tianshu-mcp

Overview Schema Source Related Servers Discussions Admin

verify_task

verify_task

Idempotent

Verify a completed task or project path without editing source: automatically run command checks and analyze code against a Git baseline. Extra checks can be added; idempotency key prevents re-runs.

Instructions

对已完成任务或项目路径执行一次验收（不改源码）：自动命令检查 + 代码分析（相对 git 基线）。可用 extraChecks 临时加验。需任务/项目二选一。可选 idempotencyKey：同一 key 重试不重跑验收——执行中的同键请求返回进行中提示，已完成的直接返回既有报告与轮次，参数变更则报冲突。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`taskId`	No
`checksMode`	No
`baselineRef`	No
`extraChecks`	No
`projectPath`	No
`idempotencyKey`	No
`acceptanceOverride`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.6.4Sep 24, 2026

addedInput schema / properties / acceptanceOverride

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "checks": {
+      "items": {
+        "$ref": "#/properties/extraChecks/items"
+      },
+      "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.1.9Sep 9, 2026
- addedInput schema / properties / baselineRef / minLength
```
Added value: +1
```
- addedInput schema / properties / checksMode
```
Added value: +{
+  "enum": [
+    "append",
+    "replace"
+  ],
+  "type": "string"
+}
```
First observedv0.1.0Sep 7, 2026

TDQS

A3.9/5.0

Behavior4/5

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

The description adds meaningful behavioral detail beyond the annotations: it guarantees no source changes, explains idempotency semantics in detail (same key returns in-progress status, completed reruns return existing reports, parameter changes cause conflicts), and mentions the relative git baseline. This aligns with idempotentHint=true and destructiveHint=false, with no contradiction.

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?

The description is dense but efficient, front-loading the core purpose and safety guarantee before moving to parameter constraints and idempotency details. It is somewhat run-on but every clause carries useful information.

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

Completeness2/5

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

The tool is complex, with no output schema and a very large nested acceptanceOverride parameter, yet the description provides no information about return values, report structure, or the meaning of verification outcomes. It also does not explain checksMode or how to use acceptanceOverride, leaving significant gaps for an agent deciding how to configure a verification run.

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 must compensate. It explains taskId/projectPath mutual exclusivity, extraChecks, baselineRef via '相对 git 基线', and idempotencyKey behavior. However, it omits key parameters like checksMode and the large acceptanceOverride object, leaving important semantic gaps.

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?

The description clearly states it performs acceptance verification ('执行一次验收') on completed tasks or project paths, using automatic command checks and code analysis relative to a git baseline, and explicitly notes it does not modify source code. This distinguishes it from siblings like run_task, rework_task, and get_task_report.

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?

The description specifies when to use it: for completed tasks or project paths, and it states the mandatory selection between task and project ('需任务/项目二选一'). It also explains how extraChecks can augment verification. However, it does not explicitly name alternatives or exclusions relative to siblings such as query_task or get_task_report.

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

Deploy Server

verify_task

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools