Home / lanlan0811 / tianshu-mcp · GitHub

tianshu-mcp SKILL.md skillA

tianshu-mcp from lanlan0811/tianshu-mcp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lanlan0811/tianshu-mcp/tianshu-mcp@git:20261102.e412735

Pins git:20261102.e412735 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lanlan0811/tianshu-mcp
Path
skills/tianshu-mcp/SKILL.md
Versions recorded
7
Latest version
git:20261102.e412735, committed Nov 2, 2026
First version recorded
Oct 6, 2026
Size
39,112 bytes
Repository stars
11
License
Apache-2.0

让外部 AI-Agent（codex/zcode/kimicode/opendesign/minimax）做项目开发并自动验收、失败返修的编排方法。当任务需要“叫一个 AI-Agent 去开发/改代码/补测试并验收，不行就返修”时先加载本技能：按它用 mcp__tianshu-mcp__ 的 8 个工具（run_task/query_task/manage_task/verify_task/query_info/wait_task/prepare_visual_baseline/approve_visual_baseline）派活、等待、验收、返修、视觉基准，并按硬失败错误码快速定位卡点。小改动或纯问答不需要。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# tianshu-mcp 编排技能：叫外部 AI-Agent 开发并验收

**你是总指挥，不是开发**。你不改项目代码，只通过本 MCP 派活、轮询、读报告、驱动返修，并把结论如实汇报给用户。

**首行强指令**：动手前读完本文件。任务书模板、六种派活示例、meta 字段全表（§4）、错误码速查（§5）、项目级验收配置模板、needs_user/取消示例在同目录 `usage-examples.md`，需要时用读取文件工具查看，长方法论不必背。

---

## 0. 一分钟心智模型

```text
run_task（秒回 taskId，异步）
   → wait_task 阻塞等到停点（终态或 needs_user；超时后再调一次继续等）
   → 需要进度细节时 query_task 轮询（5–10 秒一次）
        ├─ needs_user      → §5：让用户在客户端处理 → manage_task(action="continue") 恢复
        ├─ 硬失败           → §9：读 agentEndReason，不要当“agent 没做好”重试
        └─ 终态            → §6：读 query_info(type="report") 的 checks / analysis / visual
   → 验收失败且 autoFixRounds>0 → 自动返修（先落修复计划，再回原会话）
   → 人工不满意 → manage_task(taskId, action="rework", feedback=针对性摘要)
```

三条不变式：

1. **异步契约**：`run_task` 只返回 `taskId`；严禁把它当同步调用等结果。
2. **验收是唯一裁判**：agent 说“完成”不算通过，`query_info(type="report")` 的 checks 才算。
3. **不空转**：同一诊断只重试一次；第二次仍失败就带证据汇报，或换 agent / 缩小任务。

---

## 1. 工具面（8 个，v0.9.0 起由 13 个按域合并）

| 工具 | 能力 / 审批 | 作用 | 关键入参 |
|---|---|---|---|
| `run_task` | write + 审批 | 派活给外部 agent；**异步**返回 `taskId` | 见 §3 |
| `query_task` | read | 轮询状态 + agent 日志尾（`tailLines` 缺省 40 行） | `taskId`、`tailLines?` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lanlan0811/tianshu-mcp/tianshu-mcp@sha256:c10e7e6105b773d7

The line at the top of this page pins the label git:20261102.e412735, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_itomaolqcqtmpqzg.svg)](https://markdownregistry.com/a/art_itomaolqcqtmpqzg)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Oct 6, 2026 and Nov 2, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261102.e412735 latest2026-11-02 e412735 39,112 BA view · diff
git:20261102.8c8335d2026-11-02 8c8335d 41,374 BA view · diff
git:20261008.70d88692026-10-08 70d8869 41,714 BA view · diff
git:20261008.e6f0b762026-10-08 e6f0b76 41,663 BA view · diff
git:20261007.3d168262026-10-07 3d16826 40,890 BA view · diff
git:20261006.ee417ec2026-10-06 ee417ec 40,873 BA view · diff
git:20261006.455e0742026-10-06 455e074 40,562 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (39112 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

lanlan0811/tianshu-mcp · 11 stars · license Apache-2.0 · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_itomaolqcqtmpqzg
GET https://markdownregistry.com/api/v1/resolve?ref=lanlan0811/tianshu-mcp/tianshu-mcp
GET https://markdownregistry.com/api/v1/blob/c10e7e6105b773d7a7279deca35b54262067ce3332052f6a6b09f70fc9402190

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

Browse by kind, by grade A, or by owner.