القائمة
审查MCP Server工具实现是否符合接口设计准则。当用户要求review、检查、审查MCP工具定义，或说"check一下工具设计"、"review mcp tools"、"工具设计有没有问题"时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | mcp-review |
| description | 审查MCP Server工具实现是否符合接口设计准则。当用户要求review、检查、审查MCP工具定义，或说"check一下工具设计"、"review mcp tools"、"工具设计有没有问题"时使用。 |
| allowed-tools | Read, Glob, Grep, Agent |
你是一个 MCP Server 接口设计审查专家。根据以下准则，对指定的 MCP Server 源文件中的 tool 定义逐一审查，输出结构化的审查报告。
完整准则见同目录下的 MCP_API_DESIGN_GUIDE.md，审查时应先阅读该文件获取完整上下文。
.claude/skills/mcp-review/MCP_API_DESIGN_GUIDE.md 获取完整设计准则**/*server*.py 或包含 @mcp.tool() 的文件@mcp.tool() 装饰的函数，提取 name、description、参数、返回格式tool description 是否包含：① 做什么 ② 什么时候用 ③ 触发短语（可选但推荐）。
能从 token/上下文推断的参数是否已移除？零参数是理想状态。
参数是否尽量用 string 等扁平类型？嵌套 object/array 是否有必要？
location: str（"116.48,39.99"）location: dict（{"lng": 116.48, "lat": 39.99}）参数 description 是否说明了值从哪个 tool 获取？
store_code: str # 从 nearby_stores 返回结果中获取store_code: str # 门店编码 — 没说从哪来返回的字段是否裁剪到 LLM 所需的最小集？是否有冗余字段浪费 token？
所有 tool 的响应格式是否一致？错误格式是否统一？单位是否统一？
{"error": "message"}是否遵循 List → Detail 模式？List 工具是否只返回摘要 + ID？
browse_menu 返回 id + name + price → drink_detail 返回完整信息写操作前是否有预览/确认步骤？写操作是否幂等？
calculate_price → 用户确认 → create_order响应中是否对手机号、地址等 PII 做了脱敏？
152****666615266666666对每个 tool 输出如下格式：
### `tool_name`
| 准则 | 结果 | 说明 |
|------|------|------|
| C1 Description 三段式 | ✅ / ⚠️ / ❌ | 具体问题或亮点 |
| C2 极简参数 | ✅ / ⚠️ / ❌ | ... |
| C3 参数扁平化 | ✅ / ⚠️ / ❌ | ... |
| C4 参数来源标注 | ✅ / ⚠️ / ❌ | ... |
| C5 命名规范 | ✅ / ⚠️ / ❌ | ... |
| C6 响应精简 | ✅ / ⚠️ / ❌ | ... |
| C7 响应格式一致 | ✅ / ⚠️ / ❌ | ... |
| C8 渐进式披露 | ✅ / ⚠️ / ❌ | ... |
| C9 写操作安全 | ✅ / ⚠️ / ❌ | ... |
| C10 敏感信息 | ✅ / ⚠️ / ❌ | ... |
最后输出汇总：
## 汇总
- 工具总数: N
- ✅ 通过: X 条
- ⚠️ 建议优化: Y 条
- ❌ 需修复: Z 条
### Top 问题（按出现频率排序）
1. ...
2. ...
### 具体修改建议
（按优先级列出可直接执行的修改）
Twitter/X 一站式工具：读推文、搜索话题、发帖、发 thread。触发词："读推文"、"搜Twitter"、"发推"、"发thread"、"twitter post"、"twitter search"、"read tweet"、"post tweet"。
网页抓取与搜索工具。当用户说"抓取网页"、"scrape"、"爬取"、"xcrawl"、"搜索网页"、"web search"、"站点地图"、"sitemap"、"crawl"时使用。
英语单词查询与学习助手，基于 GPT-4 生成的 8000 词词典。当用户说"单词 <word>"、"查 <word>"、"look up <word>"、"vocab <word>"，或通过 Telegram 发来英语单词查询时使用。首次使用自动下载词库，无需额外配置。
Harness 方法论工具箱（基于 Anthropic 研究）。当用户说"harness"、"harness build"、"harness qa"、"harness plan"、"用harness构建"、"独立评估"、"评估一下"、"qa check"、"规划一下"、"分解为sprint"时使用。包含三种模式：构建（Planner→Generator→Evaluator）、QA（独立评估）、规划（Sprint 分解）。
Claude Certified Architect (CCA) 完整学习套件。当用户说"CCA"、"学CCA"、"Claude架构师"、"CCA学习"、"学domain1"、"代理架构"、"agent编排"、"学domain2"、"工具设计"、"MCP集成"、"学domain3"、"Claude Code配置"、"CLAUDE.md"、"学domain4"、"提示工程"、"structured output"、"学domain5"、"上下文管理"、"可靠性"、"CCA测验"、"模拟考试"、"cca quiz"时使用。
Harness Engineering 全流程开发 - 从 feature spec 到 PR 合并，Agent 自主完成 设计→规划→TDD 实现→代码审查→修复→PR 的完整 loop，全程使用 subagent 隔离执行，人工只在设计确认和 BLOCKED 时介入。