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

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 项发现

v1.0.0 — First Release

从 16 个独立技能到一套能自己跑的 SE 工作流引擎：给定一个目标，AI 自动走完 Define → Design → Document → Verify → Validate 全流程，自查自修，只在真卡住时才找你。

本版在原始 5 个技能 + 5 个命令的基础上，新增了 自主式 Goal Mode、引导式 Pipeline Mode、16 个技能全连通、审查清单精简、技能触发精度优化 和 产物可追溯与状态持久化，并全面更新了所有文档。

---

新增 .claude/commands/se-goal.md 斜杠命令。用户只需说一句 /se-goal 完成温度传感器的SE全流程，AI 自动执行整个 Define → Design → Document → Verify → Validate 链，不在每阶段停下来问你要不要继续。

CLAUDE.md 新增 ~150 行 Goal Mode 规则，定义了完整的 Plan → Act → Observe → Reflect 循环协议：

• Plan：解析目标、检测输入、报告计划链（仅一次）
• Act：按 phase + domain 规则自动选择技能并执行，不询问用户
• Observe：运行每个技能的验证清单，逐项检查证据
• Reflect：全部通过 → 下一阶段；部分失败 → 自动修正重试（最多 3 次）；3 次耗尽 → 升级给用户

停止条件：追溯矩阵零缺口（成功）/ 同一阶段 3 次重试失败 / 总执行超 20 次 / 用户中断。每阶段完成后只报告一行简洁状态，不啰嗦。

CLAUDE.md 新增 ~60 行 Pipeline Mode 规则，覆盖触发到执行的完整链路：

• 短语级触发关键词（中英双语，如 帮我做需求 help me with requirements），区分 Pipeline Mode 和 Goal Mode 的触发条件
• 三步阶段检测：目录扫描 → 内容质量验证（Grep REQ-XXX / MOD-XXX / IF-XXX ID，检查文件大小 > 500B）→ 区分"未开始 / 进行中 / 已完成"
• 自然语言选项：不再问"16 个技能你要哪个"或罗列技能名，而是展示 2-4 个描述产出的自然语言选项
• 跨会话恢复：新会话启动时先读 docs/versions.json，恢复上次阶段状态

skills/using-se-skills/SKILL.md 新增 ~80 行 Pipeline Conduction 章节，包含每阶段的选项生成器和措辞模板，以及特殊场景路由规则（测试方案 → test-plan-review，发布包 → release-review）。

所有 16 个技能的 SKILL.md 新增 ## After This Skill 段落，声明：

• 上游依赖（运行前需要什么产物）
• 下游消费（产出喂给哪个技能）
• 替代路径（同级可选分支，如 SW 路径 vs HW 路径）
• 质量检查（traceability-matrix 随时可跑，不必等到最后）

管线图从 16 个孤岛变成一个完整的有向图，Claude Code 可以从任何需求追溯到任何测试用例。

新增 docs/versions.json：

• 15 个 artifact 条目，每个声明所属 skill、产出文件、版本、状态、depends_on 上游依赖
• 14 条依赖关系，下游技能运行前可验证上游是否已 produced
• 5 个阶段检查点（define / design / document / verify / validate）
• 跨会话恢复：新会话自动读取，恢复阶段进度
• 版本一致性：下游技能运行前检查所有 depends_on 均为 produced 状态，否则上报缺失前置

CLAUDE.md 执行协议新增 Record 步骤：每个技能完成后更新 versions.json。

---

21 个 references/*.md 文件批量精简：

• 表格从 49 列精简到 12 列（仅保留编号 + 检查内容）
• 移除的列：评估 类别 状态 备注/参考 检查要求人 检查人 批准要求人
• 移除的章节：**CHIPSEA CONFIDENTIAL** 标记、修订记录 (Revision History)、适用范围 (Scope)、参考文件 (Reference)、目的 (Objectives)、**评估**: YES/NO 内联标记
• 清理模板占位值（OK → [待评估]，No → [待评估]）
• 标题格式统一修正

总行数从 ~2500+ 降至 1210 行，减少约 50%。

16 个 skill 的 YAML description 全部重写，解决"用户说 review，7 个技能抢答"的问题。三项原则：

• 中文触发词前置：需求分解 而非 Transforms raw inputs...，匹配用户实际用语
• 每个 description 第一句唯一：不再有 5 个 skill 以相似句式开头
• 显式 NOT 声明：每个 description 末尾声明自己不是什么，帮助 Claude Code 排除最相似的技能

Review 家族 7 个 skill 的去模糊化效果：

用户说	之前可能命中	现在精确命中
"帮我审查代码"	design-review 或 code-static-review	code-static-review（NOT for reviewing design docs）
"帮我做设计审查"	7 个 review skill 都可能	design-review（四视角对抗式设计审查 唯一标识）
"审查测试报告"	test-plan-review 或 test-report-review	test-report-review（NOT for reviewing the test plan itself）

元技能从"技能发现参考"升级为 管道引导器：

• 新增 Pipeline Conduction 章节：阶段检测协议 + 每阶段选项生成器
• 新增 After This Skill 段落：声明 conductor 角色和路由表
• Quick Reference 更新为 16 个技能

---

• 命令表新增 /se-goal（标记为 🚀 自主式模式）

• 新增 Pipeline Mode vs Goal Mode 四维度对比表（触发方式 / 阶段切换 / 验证失败 / 用户交互）

• 命令数 5→6，技能数 15→16

• using-se-skills 描述更新为管道引导器

• 项目结构新增 se-goal.md

• 完整目录结构（含所有 artifact 子目录和产物类型）

• versions.json 文档说明（15 个条目、14 条依赖、5 个检查点、跨会话恢复）

• 两种工作模式参考表

• 16 个技能完整目录树（按 Define/Design/Document/Verify/Validate 分组）

• 6 个命令完整列表 + 模式分类

• 管道架构说明（CLAUDE.md 是运行时行为定义）

• 验证规则更新（After This Skill 约定、versions.json 一致性检查）

• [Unreleased] 章节详细记录所有 v2 变更（Goal Mode、Pipeline Mode、技能链、清单精简、description 优化、versions.json、文档更新）

• 原始初始版本改名 [0.1.0]，避免与当前 v1.0.0 冲突

---

新增文件：
  .claude/commands/se-goal.md      自主模式入口
  docs/versions.json               产物版本清单 + 管道状态持久化

修改文件：
  CLAUDE.md                        +200 行（Pipeline Mode + Goal Mode + 跨会话恢复）
  README.md                        重构命令表 + 模式对比 + 技能数更新
  docs/README.md                   重构目录结构 + versions.json 说明
  AGENTS.md                        完全重写（16 技能 + 6 命令 + 管道架构）
  CHANGELOG.md                     首次完整变更记录
  .gitignore                       排除非插件文件
  skills/*/SKILL.md × 16           description 重写 + After This Skill
  references/*.md × 21             精简 50%（4~9 列 → 1~2 列）

总计：43 文件，+2600 / -1900 行