Skip to content

v2.0.0 — MCP 服务集成 · 钩子系统 · 文档预处理管道 · 质量修复

Latest
Latest

Choose a tag to compare

View all tags
@ddddjaak ddddjaak released this 26 Jun 03:07
· 2 commits to main since this release
v2.0.0
a3ba91d

v2.0.0 — 2026-06-26

版本概要

本版本新增 3 个 MCP 服务集成、SessionStart 钩子系统、4 通道文档预处理管道，并修复了 16 项项目审计发现的缺陷。

统计： 35 个文件变更，+3,725 / −48 行，8 个 commits（自 v1.0.0 起）

🆕 新增功能

MCP 服务集成（3 个新服务，通过 .mcp.json 配置）

MCP 服务 用途 启动方式
drawio 架构图生成（流程图/时序图/类图/状态机/ER 图） npx -y @drawio/mcp
visio 专业 .vsdx 图表（用户手册/数据手册用图） python -c "from visio_mcp_server.visio_server import main; main()"
math 工程计算（SNR/功耗/热分析/时序/波特率误差） uvx gnomon-mcp

draw.io MCP：

  • 支持 Mermaid.js、XML、CSV 三种输入格式
  • 首次使用自动通过 npx 下载安装，无需手动配置
  • 经历两轮迭代：drawio-mcp v1.6.0 在 Node.js 24 上崩溃（JSDOM 兼容性问题）；diagram-master 仅支持流程图；最终选定官方 @drawio/mcp

Visio MCP：

  • 支持创建/打开 .vsdx 文件、添加形状（矩形/圆形/菱形等）、连接形状（直线/折线/曲线）、添加文本、列出形状
  • 入口点使用通用 python -c 方式，不硬编码路径
  • 前提条件：Windows + Visio 桌面版已安装 + pip install office-visio-mcp-server

工程数学 MCP：

  • calc()：Python 数学表达式（sqrt、sin、cos、log、pi、e、统计函数）
  • calc_convert()：单位换算（米↔英尺、摄氏度↔华氏度、电压/电流/功率单位）
  • calendar()：日期计算、工作日统计
  • now()：当前日期时间多格式输出
  • Windows 兼容：mcp-mathematics 依赖 Unix 专有的 resource 模块，在 Windows 上无法运行；gnomon-mcp 跨平台可用
  • 典型场景：SNR 信噪比计算、功耗预算（P = V × I）、热分析（T_j = T_ambient + P × θ_JA）、时序参数计算、波特率误差、上拉电阻选值

SessionStart 钩子系统

  • hooks/hooks.json：SessionStart 钩子注册，参照 ae-skills 模式
    • 每次新会话启动时触发（非 /reload-plugins）
    • 执行 bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh
  • hooks/session-start.sh：在会话启动时自动注入 using-se-skills 元技能内容
    • 读取 skills/using-se-skills/SKILL.md 并以 JSON 格式输出，优先级为 IMPORTANT
    • 依赖 jq 进行 JSON 构建；若 jq 缺失则降级为 INFO 消息
    • 效果：每个新会话自动激活 SE 管道指挥器（阶段检测、引导式工作流）
    • 验证：/reload-plugins 输出显示 2 hooks（1 个 ae-skills + 1 个 se-skills）

四通道文档预处理管道

  • scripts/preprocess_pdf.py（709 行）：PDF → 结构化文本 + 表格 + 图表
    • 基于 PyMuPDF (fitz) 的文本提取，Tesseract OCR 备选
    • 表格质量评分，图表元数据提取
  • scripts/preprocess_xlsx.py（575 行）：Excel → Markdown 表格
    • 逐 Sheet 转换，合并单元格前向填充，表头行自动检测
  • scripts/preprocess_docx.py（476 行）：Word → 标题层级 + 段落 + 表格 + 图片
    • 保留文档结构（标题→大纲），表格边框/样式元数据
  • scripts/preprocess_pptx.py（412 行）：PowerPoint → 幻灯片文本 + 演讲者备注 + 嵌入图片
    • 逐 Slide 提取，形状类型检测，备注保留
  • scripts/extract_figures.py（214 行）：共享图表提取模块，含质量评分
  • scripts/extract_tables.py（206 行）：共享表格提取模块，含误检过滤
  • scripts/requirements.txt（26 行）：10 个 Python 依赖
  • 全部 4 通道支持 --verify 自动质量校验模式：
    • 文本密度检查、OCR 质量评估、乱码检测、表格误检过滤、空幻灯片检测
  • 集成：skills/requirements-decompose/SKILL.md 新增第 0 步 PREPROCESS 章节（~200 行）
  • references/：4 份处理指南参考文档

🔄 变更

requirements-decompose SKILL.md：

  • 新增第 0 步 PREPROCESS 章节（~200 行）：自动化文档摄入管道
    • PDF → 需求提取（OCR 备选）
    • DOCX → 标题结构化需求解析
    • PPTX → 逐页需求识别
    • XLSX → Sheet 化需求矩阵提取

🐛 修复

16 项项目审计发现（4 轮审查）：

CRITICAL 级别（阻断 Pipeline/Goal 模式阶段检测）：

  • 输出路径统一：docs/specs/ → docs/spec/，涉及 6 个文件
    • 4 个规格产出技能、2 个命令、追溯矩阵
    • 根因：技能写入 docs/specs/ 但管道指挥器检查 docs/spec/，导致自动化阶段检测静默跳过 Document 阶段

HIGH 级别：

  • design-review/SKILL.md：补全空白的 "See Also" 章节，添加 4 份参考检查单
  • 为 11 个缺失 Pipeline 引导文本的技能补齐（现 15/16 技能覆盖；using-se-skills 本身为指挥器）

MEDIUM 级别：

  • marketplace.json：描述从初版 5 个技能扩展至全部 16 个技能覆盖全生命周期
  • plugin.json + marketplace.json：作者名统一为 ddddjaak
  • agents/README.md：修正 persona 数量描述

跨包卫生清理：

  • 从 4 个技能中移除 7 处 ae-skills 技能名称引用
  • CONTRIBUTING.md：移除 ae-skills 脚本引用
  • 保留 CLAUDE.md 和 AGENTS.md 中的边界声明（显式策略，非跨包耦合）

LOW 级别：

  • using-se-skills/SKILL.md：技能计数 15+ → 16（精确计数）
  • 架构输出模板：为 3 个架构技能添加显式 Scope/Not-Covered 章节

🏗️ 基础设施

  • .gitignore：新增 draw.io 测试产物忽略规则
  • .mcp.json：3 个 MCP 服务配置，命令均为可移植形式（npx/python/uvx）

从 v1.0.0 以来的 Commits

  • bd4e793 feat: 添加 SessionStart 钩子，自动注入 using-se-skills 管道指挥器
  • 0310e6e feat: 添加 gnomon-mcp 工程计算服务（Windows 兼容）
  • 34d2a97 fix: drawio MCP 切换至官方 @drawio/mcp（jgraph）
  • 851e1aa feat: 添加 office-visio-mcp-server 专业 .vsdx 图表生成
  • b67b388 fix: 从 drawio-mcp 切换到 diagram-master 以兼容 Node 24
  • a0958d5 feat: 通过 .mcp.json 添加 drawio-mcp 服务
  • e805846 feat: 添加 4 通道文档预处理管道及质量验证
  • 07f6a2d fix: 解决 4 轮项目审计的 16 项发现
Assets 2
Loading