@yottameta/yotta-skills-plugin 0.5.0 → 0.6.0

package/.agents/plugins/marketplace.json

@@ -12,7 +12,7 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Developer Tools",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
       "interface": {
         "displayName": "元阁 yotta-skills",

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Developer Tools",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
       "interface": {
         "displayName": "元阁 yotta-skills",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-skills-plugin",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "YuanGe (元阁) — orchestration and routing for the YottaMeta skill family, packaged as a YottaMeta Agent Plugin.",
   "license": "MIT",
   "keywords": [

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "yotta-skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
   "author": {
     "name": "YottaMeta",

package/skills/yotta-skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yotta-skills
-version: 0.5.0
+version: 0.6.0
 description: 元阁 -- 元阁全家技能的总编排策划 + 编排路由 + 一键安装器 + 技能盘点。路由层：--route / route_request 按需求摘要给出候选组合、调用顺序、角色、置信度、依据、已装/缺失状态与安装命令，只建议不自动安装；非元阁家族已装技能按 frontmatter description 机械匹配作并列候选（标注来源与未扫描状态，只读不自动调用）；策划层：按场景给出「该组合哪几个元技能、组合强在哪、怎么自动装+自动用」；安装层：一条命令把 YottaMeta 已发布的全部 yotta-* 技能装进指定智能体或目录；盘点层：--inventory / --reindex 扫描本机已装技能生成/更新注册表，新装技能自动被发现（install/update 后自动 re-index，会话开工可先跑 --reindex；自包含零依赖，不依赖任何元技能）；MCP 按需加载（可选：list_installed_skills/describe_skill/reindex/route_request，不常驻，未加载降级 CLI）。支持 --list 清单 / --route 路由 / install / update / --inventory / --reindex / --dry-run 预览 / --pin 锁版本。触发：需要批量安装或更新元阁全家技能、按场景组合多个元技能、路由或判断该用哪些技能、盘点或查看本机已装技能、重扫技能注册表、给某个智能体或目录一次性铺齐 yotta-* 技能、预览安装清单、锁版本安装、或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家/该用哪个技能/路由技能/盘点技能/查看已装技能 等。边界（Do NOT trigger）：只做「组合策划 + 静态路由建议 + 清单 + 下载 + 落位 + 汇总 + 盘点 + re-index」，不含技能本体、不做技能内容开发、不 -g 污染全局、不自动安装缺失技能；装前摘要仅供参考，安装决策由用户确认。
 license: MIT
 metadata:
@@ -179,6 +179,7 @@ npx -y @yottameta/yotta-skills --route "检查代码质量，别糊弄" --json
 ### MCP：按需加载（可选）
 
 本技能自带一个 MCP server：`yotta-skills`（`scripts/yotta-skills-mcp.py`，零依赖、数据不出本机），
+基于 MCP 最新协议 2026-07-28（无状态时代；向后兼容 2025-11-25 及更早握手客户端）。
 提供 `list_installed_skills`（盘点）/ `describe_skill`（单技能详情）/ `reindex`（强制重扫）/ `route_request`（静态编排路由）四个工具。
 
 **按需加载，不走常驻**：本技能与 MCP 均为按需触发。默认以 CLI 为主

package/skills/yotta-skills/scripts/yotta-skills-mcp.py

@@ -24,10 +24,12 @@ import subprocess
 import sys
 from pathlib import Path
 
-VERSION = "0.5.0"
+VERSION = "0.6.0"
 TOOL_NAME = "yotta-skills"
 CN_NAME = "元阁"
-MCP_PROTOCOL = "2025-03-26"
+MCP_PROTOCOL_MODERN = "2026-07-28"
+MCP_PROTOCOL_LEGACY = "2025-11-25"
+SERVER_INFO = {"name": TOOL_NAME, "version": VERSION}
 SERVERS = {TOOL_NAME: {"name": TOOL_NAME, "cn": CN_NAME, "version": VERSION}}
 
 _HERE = Path(__file__).resolve().parent
@@ -193,8 +195,41 @@ def mcp_tools():
     ]
 
 
+def _req_version(params):
+    """取请求声明的最新协议版本（modern _meta 字段）；无 = legacy。"""
+    meta = (params or {}).get("_meta") or {}
+    return meta.get("io.modelcontextprotocol/protocolVersion")
+
+
+def _modern_ok(payload, cache=None):
+    """modern 结果包装：resultType + _meta.serverInfo（list/discover 加 ttlMs/cacheScope）。"""
+    out = {"resultType": "complete"}
+    out.update(payload)
+    out["_meta"] = {"io.modelcontextprotocol/serverInfo": dict(SERVER_INFO)}
+    if cache:
+        out["ttlMs"] = cache[0]
+        out["cacheScope"] = cache[1]
+    return out
+
+
+def _unsupported_version(rid, pv):
+    return {
+        "jsonrpc": "2.0", "id": rid,
+        "error": {
+            "code": -32022,
+            "message": "Unsupported protocol version",
+            "data": {"supported": [MCP_PROTOCOL_MODERN], "requested": pv},
+        },
+    }
+
+
 def handle_message(msg):
-    """处理一行 JSON-RPC 消息，返回响应 dict；通知返回 None。"""
+    """处理一行 JSON-RPC 消息，返回响应 dict；通知返回 None。
+
+    双时代（dual-era）：请求 _meta 带 io.modelcontextprotocol/protocolVersion =
+    modern（2026-07-28 无状态，server/discover 取代握手）；无该字段 = legacy
+    （2025-11-25 及更早，initialize 握手），响应保持旧形状。
+    """
     if not isinstance(msg, dict) or msg.get("jsonrpc") != "2.0":
         rid = msg.get("id") if isinstance(msg, dict) else None
         return {"jsonrpc": "2.0", "id": rid, "error": {"code": -32600, "message": "invalid request"}}
@@ -205,14 +240,60 @@ def handle_message(msg):
     if method is None:
         return None
     params = msg.get("params") or {}
+    pv = _req_version(params)
+
+    if pv is not None:
+        # ---- modern（2026-07-28 无状态）----
+        if pv != MCP_PROTOCOL_MODERN:
+            return _unsupported_version(rid, pv)
+        if method == "server/discover":
+            return {
+                "jsonrpc": "2.0", "id": rid,
+                "result": _modern_ok({
+                    "supportedVersions": [MCP_PROTOCOL_MODERN],
+                    "capabilities": {"tools": {}},
+                    "instructions": "元阁 MCP（基于 MCP 最新协议 2026-07-28，向后兼容 2025-11-25 及更早握手）：本机技能盘点与静态编排路由 list_installed_skills/describe_skill/reindex/route_request；数据不出本机。",
+                }, (3600000, "public")),
+            }
+        if method == "tools/list":
+            return {
+                "jsonrpc": "2.0", "id": rid,
+                "result": _modern_ok({"tools": mcp_tools()}, (300000, "public")),
+            }
+        if method == "tools/call":
+            name = params.get("name")
+            arguments = params.get("arguments") or {}
+            handler = TOOL_HANDLERS.get(name)
+            if not handler:
+                return {
+                    "jsonrpc": "2.0", "id": rid,
+                    "result": _modern_ok({"content": [{"type": "text", "text": "未知工具: %s" % name}], "isError": True}),
+                }
+            try:
+                return {"jsonrpc": "2.0", "id": rid, "result": _modern_ok(handler(arguments))}
+            except Exception as e:  # noqa: BLE001
+                return {
+                    "jsonrpc": "2.0", "id": rid,
+                    "result": _modern_ok({"content": [{"type": "text", "text": "工具执行异常：%s" % e}], "isError": True}),
+                }
+        if method == "initialize":
+            return {
+                "jsonrpc": "2.0", "id": rid,
+                "error": {
+                    "code": -32601,
+                    "message": "initialize removed in MCP 2026-07-28; use server/discover. supported: ['2026-07-28']",
+                },
+            }
+        return {"jsonrpc": "2.0", "id": rid, "error": {"code": -32601, "message": "Method not found: " + str(method)}}
 
+    # ---- legacy（<=2025-11-25，initialize 握手；响应保持旧形状）----
     if method == "initialize":
         return {
             "jsonrpc": "2.0", "id": rid,
             "result": {
-                "protocolVersion": MCP_PROTOCOL,
+                "protocolVersion": MCP_PROTOCOL_LEGACY,
                 "capabilities": {"tools": {}},
-                "serverInfo": {"name": TOOL_NAME, "version": VERSION},
+                "serverInfo": SERVER_INFO,
             },
         }
     if method == "ping":
@@ -229,7 +310,10 @@ def handle_message(msg):
                 "result": {"content": [{"type": "text", "text": "未知工具: %s" % name}], "isError": True},
             }
         try:
-            return {"jsonrpc": "2.0", "id": rid, "result": handler(arguments)}
+            return {
+                "jsonrpc": "2.0", "id": rid,
+                "result": handler(arguments),
+            }
         except Exception as e:  # noqa: BLE001
             return {
                 "jsonrpc": "2.0", "id": rid,
@@ -237,7 +321,6 @@ def handle_message(msg):
             }
     return {"jsonrpc": "2.0", "id": rid, "error": {"code": -32601, "message": "Method not found: " + str(method)}}
 
-
 def main():
     """stdio 主循环：读行 -> JSON-RPC -> 响应行。"""
     try: