Skip to content

Release v1.9.3 — Skill-MCP 协调配合能力 + 文档同步

Choose a tag to compare

View all tags
@qianzhiliang2026 qianzhiliang2026 released this 18 Jul 20:23
· 6 commits to main since this release
v1.9.3
8cf4fcf

🎯 本次发布核心

让 Skill 编排能力通过 MCP Prompts 原语内置到 MCP 服务器——用户无需安装任何 IDE 扩展包，在 Claude Desktop / Cursor / Trae 中输入 / 即可看到 7 个斜杠命令工作流，开箱即用。

✨ 新增功能

1. /submit-form MCP Prompt

补齐 form-submission Skill 的 Prompt 缺口，7/8 Skill 覆盖。7 步工具链：browser_open → browser_snapshot → browser_form_validate → browser_form_fill → browser_click → browser_assert → evidence_pack。

2. handlers/skill_map.js 模块

SKILL_TOOLS_MAP 单一数据源（显式常量，不解析 markdown），6 个纯内存计算函数：getSkillTools / getToolSkills / getAllSkillToolsMap / getReverseMap / extractToolsFromPromptMessages / validateConsistency。

3. skill_tools_map 工具

双向查询 Skill↔Tool 映射。支持 skillName（正向：返回工具链）或 toolName（反向：返回 Skill 列表）任选其一，anyOf JSON Schema 模式。

4. skill_consistency_check 工具

批量校验所有 Skill 引用工具与实际注册一致，不依赖外部文件。支持 strict（默认，缺失工具则失败）和 warn（仅警告）两种模式，含 mapDrift 字段检测 Prompt 与 SKILL_TOOLS_MAP 的漂移。

5. mcp_self_test 扩展

追加 skillConsistencyV2 字段（基于 handlers/skill_map.js，不依赖 PROJECT_ROOT 外部文件）。保留旧 skillConsistency 字段向后兼容。

📚 新增文档

  • docs/reference/skill-tools-map.md — 人工可读映射表（7 Skill 正向映射 + 30 工具反向映射 + 一致性校验说明 + AI 工作流场景）
  • docs/guide/skill-usage.md — 完整 Skill 使用指南（8 章：什么是 Skill → 三种形态 → 7 个工作流 → 3 种使用方式 → 客户端兼容性 → IDE 扩展包可选增强 → 4 个 FAQ → 相关文档）

🔄 文档同步

10 个文件的工具数从 134 同步到 136：README.md / README.en.md / AGENTS.md / standalone-start.js / docs/tools/overview.md / docs/skills/index.md / docs/skills/form-submission.md / docs/reference/tool-decision-matrix.md / docs/.vitepress/config.mts / CHANGELOG.md

README.md / README.en.md 重写"Skill + MCP"段落，去掉过时的"两者缺一不可"表述，明确"Skill 编排能力已通过 MCP Prompts 内置，IDE 扩展包仅为可选增强"。

🧪 测试验证

  • 单元测试：144/144 通过（prompts 13 + skill_map 29 + system_extra + handlers_network_system 14 + tools + atl）
  • 真实 MCP 工具调用：3 项 run_mcp 验证通过（skill_tools_map 正反查 + skill_consistency_check passed:true 7/7）
  • 文档构建：VitePress 站点构建成功（11.05s）
  • 包验证：npm pack dry-run 253 文件 794.8 kB，含全部新工具和文档

📦 升级方式

# MCP 配置中使用 npx（推荐）
npx -y @validpilot/ai-verify-mcp@1.9.3

# 或全局安装
npm install -g @validpilot/ai-verify-mcp@1.9.3

# 或项目内升级
npm install @validpilot/ai-verify-mcp@1.9.3

🔗 工具数变化

类别 v1.9.2 v1.9.3
Exploration & System 7 9 (+2)
总工具数 134 136

新增 2 个工具：

  • skill_tools_map — Skill↔Tool 双向映射查询
  • skill_consistency_check — Skill 工具引用一致性校验

📝 Commit

  • 8cf4fcf feat(v1.9.3): Skill-MCP 协调配合能力 + 文档同步（22 files, +1774/-35）

Full Changelog: v1.9.2...v1.9.3

Assets 2
Loading