变更方案自动审核助手 v3.3.1

核心目标：基于 /home/deploy_template/ 下的标准变更方案模板，对用户提供的变更方案进行模板对比审核。默认直接返回精简 Markdown 审核报告，并同时生成 Word 审核报告落盘保存。变更方案和部署表是默认审核前提；只有用户明确强调不要部署表时，才跳过部署表一致性校验。

触发条件

输入前提

变更方案(.docx) — 必须提供，这是审核的核心材料。部署表(.xlsx) — 必须提供，除非用户强调不要部署表。

纳管表是可选增强材料；缺少纳管表时不阻塞审核。

核心流程（6步）

Step 0 — 输入校验（必须执行）

在处理任何文档内容之前，必须完成输入检查。

Step 0.1 必要输入校验

必须先确认存在变更方案 .docx 和部署表 .xlsx。仅当用户明确说不要部署表时，部署表可缺省。

缺少必要材料回复模板：

⚠️ 审核默认需要两份必要材料：变更方案(.docx) + 部署表(.xlsx)

当前仅收到：{文件名}
缺少：{变更方案(.docx) 或 部署表(.xlsx)}

请补充后重新提交；如果本次明确不需要部署表，请回复“不要部署表”或“跳过部署表校验”。

Step 0.2 可选材料处理

部署表和纳管表按以下规则处理：

• 无部署表且用户未明确不要部署表：暂停审核，要求补充部署表或确认跳过。
• 无部署表但用户明确不要部署表：只做模板结构、关键步骤、编辑质量审核；在报告"审核范围"中注明"按用户要求跳过部署表一致性校验"。
• 无纳管表：跳过 C 类纳管表校验；在报告"审核范围"中注明未做纳管状态校验。
• 用户明确要求全量审核时，必须要求补充纳管表后再执行 C 类校验。

Step 1 — 保存原始输入

任何输入在处理前必须先存档，防止后续覆盖：

from pathlib import Path
import shutil
from datetime import datetime

SKILL_DIR = Path.home() / '.hermes/skills/openclaw-imports/deploy-plan-review'
RAW_DIR = SKILL_DIR / 'data' / 'raw'
RAW_DIR.mkdir(parents=True, exist_ok=True)

ts = datetime.now().strftime('%Y-%m-%d_%H%M%S')
for label, src in [('plan', plan_path), ('deploy', deploy_path), ('manage', manage_path)]:
    if src and Path(src).exists():
        shutil.copy2(src, RAW_DIR / f'{ts}_{label}_{Path(src).name}')

Step 2 — 识别方案类型并确定模板（必须优先执行）

模板选择是本技能的核心。必须先根据用户给出的方案文件名关键词，在 /home/deploy_template/ 下定位最相近模板，再以该模板为基准审核。

Step 2.1 模板发现

运行时递归扫描 /home/deploy_template/ 下所有 .docx 模板，构建候选模板清单。不得使用硬编码模板清单代替实际目录；目录新增模板时应自动参与匹配。

Step 2.2 关键词提取优先级

按以下顺序提取关键词并打分：

1. 方案文件名：最高优先级。示例：9月10日-青海西宁三区-x86+culinux-新建存储集群扩容变更方案.docx
2. 用户文字描述/路径：如用户说"行业云存储新建"、路径中包含"行业云"。
3. 方案正文首页/标题/前两级标题：仅在文件名信息不足时使用。
4. 反问用户：私有云/行业云或场景无法唯一确定时再问。

Step 2.3 关键词路由规则

Step 2.4 指定示例的强制匹配

当方案名类似 9月10日-青海西宁三区-x86+culinux-新建存储集群扩容变更方案.docx：

• 青海西宁三区 命中行业云资源池命名特征；
• 新建存储集群 命中行业云存储新建场景；
• 必须优先选择：

/home/deploy_template/行业云/存储/_存储集群新建融合模板-涵盖所有存储集群新建场景-模板.docx

并在报告中明确写出：本次审核基准模板：/home/deploy_template/行业云/存储/_存储集群新建融合模板-涵盖所有存储集群新建场景-模板.docx。

Step 2.5 模板不唯一时的反问

仅在无法判断私有云/行业云，或同一路径下多个模板得分接近且会影响审核结论时，才反问用户。反问必须说明原因，并告知用户审核是基于模板完成的。

反问示例：

我会根据 /home/deploy_template 下的标准模板进行对比审核，但当前文件名无法明确判断是“私有云”还是“行业云”场景。

请确认本次方案属于哪类：
1. 私有云
2. 行业云

用户确认后，继续定位模板并审核。不要在不确定云类型时擅自混用私有云和行业云模板。

Step 3 — 调用审核引擎

优先调用 scripts/generate_review_report.py，不要重复手写审核逻辑。调用时必须传入 Step 2 定位到的模板路径；如当前引擎尚未支持 template_path 参数，必须先按脚本现有能力完成审核，并在报告中单独补充模板对比结论。

import sys
sys.path.insert(0, str(Path.home() / '.hermes/skills/openclaw-imports/deploy-plan-review'))

from scripts.generate_review_report import run_audit

result = run_audit(
    plan_path="/path/to/变更方案.docx",
    deploy_path="/path/to/部署表.xlsx",  # 默认必须；仅用户明确不要部署表时可为 None
    manage_path="/path/to/纳管表.xlsx",  # 可选
    template_path="/home/deploy_template/行业云/存储/_存储集群新建融合模板-涵盖所有存储集群新建场景-模板.docx"
)

返回的 result 字典结构：

{
    "plan_name": "方案文件名（不含扩展名）",
    "template_path": "本次采用的模板路径",
    "plan": {...},        # 方案解析结果
    "deploy": {...},      # 部署表解析结果（用户明确不要部署表时可能为 None）
    "manage": {...},      # 纳管表解析结果（可能为 None）
    "findings": [...],    # 全部审核发现列表
    "docx_path": "output/审核报告_xxx.docx",
    "xlsx_path": "output/问题跟踪_xxx.xlsx",
    "summary": {
        "p0": N, "p1": N, "p2": N, "p3": N,
        "total": N,
        "conclusion": "通过/条件通过/不通过",
        "timestamp": "2026-05-09_143025",
    },
    "raw_archived": "data/raw/",
}

Step 4 — 默认返回精简 Markdown，并保存 Word 报告

审核完成后，默认在聊天窗口直接返回 Markdown 审核报告。内容要精简，优先列出结论、基准模板、风险统计和必须修改项，避免长篇过程描述。

默认 Markdown 格式：

## 审核结论：{通过/条件通过/不通过}
方案：{plan_name}
基准模板：{template_path}
审核范围：{模板对比 + 部署表一致性 / 模板对比（按用户要求跳过部署表一致性校验）}{+纳管表校验}
跳过项：{无 / 按用户要求跳过部署表一致性校验 / 未提供纳管表，跳过纳管状态校验}
风险统计：🔴P0={p0}  🟡P1={p1}  🔵P2={p2}  ⚪P3={p3}

### 必须修改
- {只列 P0/P1，最多 5 条；无则写“无”}

### 建议优化
- {只列关键 P2/P3，最多 3 条；无则写“无”}

Word报告已保存：{docx_path}
问题跟踪表：{xlsx_path 或 “未生成”}

同时必须生成 Word 报告并保存到 output/，路径写入 Markdown。除非用户明确要求，不要把完整 Word 内容逐段贴到聊天中。

Step 5 — 结果留存

所有过程文件统一在 skill 目录下：

~/.hermes/skills/openclaw-imports/deploy-plan-review/
├── SKILL.md
├── scripts/
│   └── generate_review_report.py   # 审核引擎
├── output/                          # 审核报告输出
│   ├── 审核报告_方案名_2026-05-09_143025.docx
│   └── 问题跟踪_方案名_2026-05-09_143025.xlsx
├── data/
│   ├── raw/                         # 原始输入存档
│   │   ├── 2026-05-09_143025_plan_变更方案.docx
│   │   ├── 2026-05-09_143025_deploy_部署表.xlsx
│   │   └── 2026-05-09_143025_manage_纳管表.xlsx
│   └── 问题跟踪表.xlsx              # 全量历史问题库

审核基准

核心原则：所有审核以 /home/deploy_template/ 下的方案模板为基准，不主观判断。

必须在报告中写明本次实际采用的模板路径。若模板是通过用户确认后选择的，也要写明"已按用户确认的私有云/行业云场景选择模板"。

审核分四大类：

A类 — 结构合规性（以模板为准）

B类 — 数据一致性（方案 vs 部署表）

C类 — 纳管表交叉核验（新增）

D类 — 编辑质量

风险等级体系（四级）

🔴 高危风险（P0 — 必须改，不改将导致部署失败或业务中断）

🟡 中危风险（P1 — 建议改，不影响部署但影响正确性）

🔵 低危风险（P2 — 按需修改，规范性/编辑类问题）

⚪ 提示信息（P3 — 仅供参考）

审核结论判定

CLI 用法（可选）

审核引擎支持命令行独立运行：

cd ~/.hermes/skills/openclaw-imports/deploy-plan-review

python3 scripts/generate_review_report.py 
    --plan /path/to/变更方案.docx 
    --deploy /path/to/部署表.xlsx 
    --template /home/deploy_template/行业云/存储/_存储集群新建融合模板-涵盖所有存储集群新建场景-模板.docx

# 如有纳管表，再追加 C 类纳管校验
python3 scripts/generate_review_report.py 
    --plan /path/to/变更方案.docx 
    --deploy /path/to/部署表.xlsx 
    --template /path/to/模板.docx 
    --manage /path/to/纳管表.xlsx

# 仅当用户明确不要部署表时，才允许只做模板对比审核
python3 scripts/generate_review_report.py 
    --plan /path/to/变更方案.docx 
    --template /path/to/模板.docx

# JSON 输出（供程序调用）
python3 scripts/generate_review_report.py 
    --plan ... --template ... --deploy ... --manage ... 
    --json

边界情况

• 只有变更方案，且用户未明确不要部署表：暂停审核，提示补充部署表或确认跳过部署表校验
• 只有变更方案，且用户明确不要部署表：只审核模板结构和关键步骤，报告中注明"按用户要求跳过部署表一致性校验"
• 只有部署表或纳管表：拒绝解析，提示缺少变更方案 .docx
• 无法判断私有云/行业云：反问用户，说明审核将基于 /home/deploy_template/ 模板完成
• 模板候选不唯一：列出最可能的 2-3 个模板让用户选择，不要混用模板
• 无纳管表：跳过 C 类校验，并在审核范围中注明
• 无部署表：仅在用户明确不要部署表时才跳过 B 类数据一致性校验，并在审核范围中注明
• 部署表sheet名称不标准：自动搜索含"服务器"/"server"/"02"的sheet
• 纳管表列名不标准：自动检测"管理IP"/"Management IP"/"主机名"/"AZ"/"状态"/"管理平台"等常见列名
• 方案无章节标题：P1-07 判定为"缺少全部四章"
• 方案含多个方案：仅审核主要方案，其他部分忽略

参考

• 模板目录：/home/deploy_template/
• 模板结构分析：/root/模板结构分析报告.md
• 配套技能：deploy-fault-analyzer — 部署故障分析
• 设计参考：deploy-fault-analyzer v2.0 的 Step 0 存档、多源输入、统一目录结构等模式
• 编写者注意：Python 中文 f-string 引号陷阱见 references/pitfalls.md