技能介绍

要解决的问题

一次典型的 MaaS 平台 POC 部署，信息散落在聊天窗口、Excel 表格和邮件正文里：客户硬件没记全、现场部署命令是从别人文档里抄的、失败之后不知道该回滚什么、不同工程师各写各的进度，最后复盘只剩一堆碎片。这个技能要解决的就是「部署过程不可结构化、不可追溯、不可协作」这三件事。

核心机制：模板驱动的七阶段流程

整个技能围绕 PV3 七阶段（P1-P7） 设计：客户信息收集 → POC 信息 → 物料包 → 用例演练 → 现场部署 → 现场演示 → 复盘沉淀。每一阶段遵循同一个循环：

先发模板：进入阶段时原样输出 assets/templates/Px-*.md，不摘要、不截断，让用户填写后回传
解析 + 校验：按 - 字段名: [值] 提取字段，空、____、TBD、TODO 一律判缺失；日期、IP、枚举值（如版本仅 5.0/5.5）做合理性校验
缺项即拦截：输出《待补充清单》并暂停，不进入下一步；通过后才写入 ops-records/{项目名}/progress.md

模板支持 .md、.txt、.xlsx（openpyxl）、.docx（python-docx），官方附录表格会自动映射到同一字段模型。

自动化脚本兜底

模板解决「信息完整性」，脚本解决「执行可重复性」。P3 用 scripts/p3-check.sh 检查物料存在性、大小阈值、磁盘空间和版本一致性；P5 用 scripts/p5-deploy.sh --phase all 做幂等、断点续传的一键部署，前置 snapshot.sh 备份 etcd 与数据库，部署后用 healthcheck.sh 一次性验证集群、Pod、Harbor、GPU 等项；失败可用 --rollback-db 恢复，用 cleanup.sh --phase 分阶段卸载。SSH 免密、SQL 导入这类需要人工的步骤，脚本会暂停提示而非擅自跳过。

飞书作为唯一进度真源

每次阶段落实后，progress.md 增量同步到飞书知识沉淀父文档下的项目子文档，团队异地也能对齐最新进度；解决的问题写入多维表格和全局知识库，离线时降级到本地 issues.md 草稿，恢复后补同步。

注意点

依赖 feishu-config.json（token 配置）和 ops-records/{项目名}/deploy.env（节点 IP、VIP、版本），两者缺失时需按 references/feishu.md 首次配置
阶段落实由主导人单点写入，避免并发覆盖
cleanup.sh 属危险操作，必须输入大写 YES 确认；它只负责卸载组件，不替代正式的资源审批流程
问题诊断依赖拍照分析和云知识库检索，离线状态下只能给出通用排查思路，无法检索历史案例