optimize-agentic-mcp 是一个面向 MCP（Model Context Protocol）服务器的审计、优化与架构设计技能，定位为 MCP 服务器的“智能体就绪度”入口。它不编写 SDK 代码，而是负责诊断问题、给出修改建议、指向适用的参考文档、路由到配套技能实施修复，并规划验证方式。
一、用途与触发场景 当用户提出以下需求时使用该技能：审计或审查现有 MCP 服务器、判断 MCP 服务器是否“智能体就绪”、优化 MCP 服务器、诊断智能体误用工具的原因、设计新的 MCP 服务器、判断某功能应做成 MCP 还是 CLI、评估工具设计/模式/认证/上下文预算、处理返回上下文过多或工具选择错误的问题、进行 MCP 生产就绪加固，以及在 SDK v1、SDK v2、mcp-use 之间选择框架。
该技能不适用于：编写或修复原始 @modelcontextprotocol/sdk v1 代码、编写或修复 @modelcontextprotocol/server v2 alpha 代码、编写或修复 mcp-use/server 代码、对 MCP 服务器进行实时 CLI 冒烟测试、在 mcp-use/server 上强制 TypeScript 整洁架构分层、CLI 智能体就绪度（非 MCP）、将 SDK v1 代码迁移到 v2。这些情况应路由到对应的配套技能。
二、两种工作模式 模式 A——审计/优化现有 MCP 服务器：适用于已存在 MCP 形态代码的情况。先运行辅助脚本（audit-mcp-server.sh、measure-context-budget.sh），再用 tree、rg 等命令确认框架、入口点、工具注册、模式、传输与认证配置。随后评分并排定优先级，产出审计输出契约，包括目标路径与检测到的框架、覆盖工具接口/模式与响应/错误/安全与认证/上下文与成本/客户端兼容性/运维与测试/架构的评分卡、按优先级排列的发现项（含严重程度、证据路径与行号、影响、建议修复、配套技能路由）、验证计划以及假设与未触及项。审计/审查请求止于报告，优化/修复请求则应用范围内修改并验证。
模式 B——架构设计新 MCP 服务器：适用于尚无 MCP 形态代码，或用户希望在现有服务器之外新建服务器的情况。按参考文档中的访谈流程进行，选择框架与配套技能，交叉检查设计阶段的模式可移植性与架构陷阱。若 MCP 并非合适原语，则建议改用 CLI、智能体技能或更小的脚本。架构草图确认后再交接给选定的配套技能。架构输出契约包括所选框架与配套技能、MCP 优于 CLI/智能体技能/更小原语的理由、安全态势、上下文预算态势、生产就绪风险以及实现前后的验证计划。
三、硬性规则 该技能列出了一系列承载性规则，包括：先探索代码库再提问；审计请求止于报告，优化/修复请求才应用修改并验证；每条发现都引用文件路径与行号；一次只处理一个服务器；将工具映射到用户意图而非一对一包装 REST 端点；模式嵌套不超过一层，保留 3–6 个必填参数；为 LLM 消费精心整理工具响应，不返回原始上游 JSON；工具失败使用结果内容中的 isError，协议错误保留给传输层；服务端校验所有 LLM 输入；新远程部署使用 Streamable HTTP 而非 SSE；工具超过约 20 个时使用渐进式发现；工具描述视为提示工程；对采样、elicitation、roots 做能力门控；使用带受众检查的 OBO，不将用户令牌转发给上游 API；每次应用修改后验证。
四、配套技能路由 该技能将具体实现工作路由到配套技能：build-mcp-server-sdk-v1（生产默认原始 SDK，客户端兼容性最广）、build-mcp-server-sdk-v2（全新项目，接受 v2 alpha 风险）、build-mcp-use-server（HTTP 优先的 TypeScript 服务器，使用 mcp-use/server 约定）、convert-mcp-server-sdk-v1-to-v2（迁移现有 SDK v1 代码）、test-by-mcpc-cli（可重复的 stdio/Streamable HTTP 冒烟检查与编辑后验证）、apply-clean-mcp-architecture（TypeScript mcp-use/server 的层边界与依赖方向问题）、optimize-agentic-cli（CLI 优先或 CLI 智能体就绪度场景）。
五、参考文档与决策树 技能提供按主题组织的参考文档路由表，涵盖工具设计、工具描述、工具响应、模式设计、错误处理、安全、威胁目录、认证与身份、上下文工程、缓存经济学、渐进式发现、智能体模式、组合、提示门控、资源与提示、会话与状态、测试、传输与运维、部署平台、客户端兼容性、模型行为、示例服务器、注册表与分发等。同时提供决策树，帮助判断需要关注 MCP 服务器的哪个方面，并给出常见陷阱与修复方式，例如避免将每个 REST 端点包装为工具、避免深层嵌套 JSON 模式、避免返回原始 API JSON、避免对工具失败抛出协议错误、避免缺少输入校验、避免急切注册 20 个以上工具、避免模糊的工具描述、避免编辑后不做实时验证、避免对新远程部署使用 SSE、避免忽略会话清理。
六、限制 该技能本身不编写 SDK 代码，只做诊断、开方与路由。其参考文档中的阈值属于诊断线索而非结论。具体框架选择、安全实现、部署平台等细节需依据对应参考文档与配套技能。资料未提供该技能的收费、价格、平台支持范围或具体效果数据。