数字化方案生成

概述

按官方模板结构，生成竞赛/鉴定所需的完整交付文档：

1. 需求分析文档（交付物①，9章）——锚定实操评分"需求分析与方案设计"20分
2. 数字化解决方案文档（交付物②，9章＋审核与批准）——锚定实操评分"数字化解决方案设计"25分

章节骨架与官方 docx 模板一致，并融合竞赛评分知识与 PRD 书写规范（G/P/US/FR/NFR/R 编号体系、SMART 目标、验收标准"条件-操作-结果"格式）。两份文档通过统一编号体系互相印证，是高分核心特征。结构是唯一参考依据——正文内容一律依据用户提供的赛题/场景材料独立撰写，禁止套用、改写或复述任何模板示例内容（官方模板中的示例行与示例数值仅示意表格填法）。

触发词

执行流程

第 1 步：判定任务类型

按用户措辞判定要生成哪类文档（需求分析 / 解决方案 / 两者 / 细化设计）。未明说时，若用户提到"方案"但无"需求"，先确认；生成解决方案文档前若需求分析文档不存在，提醒用户两文档需编号互证，建议先生成或请用户提供已定稿的 P/FR 编号。细化设计任务要求解决方案文档已确认存在。

第 2 步：加载对应模板参考

生成前必须读取对应参考文件（按需加载）：

• 需求分析文档 → references/requirements-analysis-template.md
• 数字化解决方案文档 → references/digital-solution-template.md
• 细化设计（原型/AI coding） → references/prototype-ai-coding-design-guide.md
• 输出样式（md 与 docx 阶段均需读取） → references/document-style-guide.md
• Word 排版阶段（确认后转 docx 时） → references/doc-format-guide.md

参考文件为结构版：只含章节骨架、表格列定义与填写要求，不含可套用的场景示例。结构即唯一参考依据，不要向用户索要或引用原版模板文件。

第 3 步：收集场景输入

生成前确认以下信息；缺失时向用户询问，不得以默认场景擅自替代。仅当用户明确要求快速产出且同意假设时，方可按其确认的场景合理假设，并在文档中明确标注假设项：

1. 赛题场景与背景事实（若为备赛：赛题资料、痛点清单、违规分类参考规则）
2. 目标读者（竞赛评委 / 鉴定考官 / 企业客户）
3. 关键约束：业务规模、既有系统、工期分期、安全合规等级等量化基数
4. 已定稿的另一份文档的 P/FR/R 编号（保持互证一致）

第 4 步：生成 Markdown 草稿并等待确认【积分节约关键】

先输出 Markdown 草稿，不直接生成 docx。硬性写作规范：

• 独立创作：正文中的角色、痛点、规则、指标、数字一律依据用户提供的场景材料独立生成，禁止套用或改写任何示例内容
• 编号体系：目标 G-xx、痛点 P1-Pn、用户故事 US-xx、功能需求 FR-xx、非功能需求 NFR-xx、业务规则 R-xx、功能点 F-xx，全文档一套编号；解决方案文档中每个编号与需求分析文档完全一致
• 三级编号："章-节-条"；图表统一"图N-x 题名"并与文字呼应
• 全量化：禁用"大幅提升""较快响应"等模糊表述，性能/目标/效益一律给量化指标；量化数值须从场景基数测算或赛题给定资料得出
• SMART 目标：G-xx 含衡量指标＋目标值＋当前值＋衡量时间（当前值即痛点影响量化基数）
• 验收标准：FR 的验收标准用"条件-操作-结果"格式，可 Yes/No 判定，覆盖正常/异常/边界场景
• 表格化：权限矩阵、痛点分析表、功能清单表、数据字典、非功能表、六环闭环表、五类规则表——按参考文件中的列定义逐列填写，不留空列
• 规则可核验（解决方案第4章）：每条 R-xx 规则含判定条件＋数据字段＋阈值＋核验方式＋边界处理
• AI赋能三要素（解决方案第5章）：解决什么痛点（P编号）＋使用什么数据＋效果如何核验；禁止"引入大模型提升智能化水平"式空话
• 输出样式：md 结构标记、标题层级、表格规范、加粗强调、交叉引用、禁用词，一律遵循 document-style-guide.md（章节清晰/结构清晰/格式清晰/图表美观）
• 书写顺序（评审避坑，源自 PRD 书写实践）：痛点分析 → 建设目标 → 范围边界 → 用户角色与故事 → 功能需求 → 数据需求 → 非功能需求 → 接口 → 确认与附录——先定"为什么做"，再定"做到什么"，最后拆"怎么做"
• 篇幅控制：正文6-10页为宜，按要点给分不堆厚度

草稿以 .md 文件输出到工作区，文件名建议：需求分析文档-<场景名>.md / 数字化解决方案文档-<场景名>.md。呈现给用户并明确等待确认（确认内容、结构、数字无误，或提出修改意见）。用户确认前不得进入第 5 步。

第 5 步：确认后生成 Word

用户确认 md 草稿（或按意见修订并再次确认）后，再生成 docx。默认路线：本地公文排版引擎（免费，不消耗积分）：

python scripts/doc_format.py <草稿.md> --output "需求分析文档-<场景名>.docx" --no-disclaimer
# 需要自动插一页目录时追加 --toc

• 版式：A4 GB/T 9704 版心（上37 下35 左28 右26mm）、公文标题（方正小标宋简体 二号 居中）、一级标题黑体三号、二级标题楷体三号、三级标题仿宋三号、正文仿宋三号首行缩进2字符；命令用法与输入书写约定见 references/doc-format-guide.md
• 标题层级可直接生成目录：章/节/条自动套用 Word 内置「标题 1/2/3」样式（公文体、字体字号不变），成稿在 Word 中即为真正的一级/二级/三级标题——导航窗格可跳转，可用「引用→目录」生成目录；加 --toc 时引擎在标题后插一页自动目录（Word 目录域，打开文档自动刷新条目与页码，默认不插）
• 表格转 Word 原生表格（列宽按内容自适应、禁止行内跨页、超 6 列自动横排）；表题居中于表格上方
• 保留"图N-x"占位（流程图等由用户后续用 Visio 补充，提示 vsdx 为硬性交付项）
• 输入支持 md/doc/docx/wps/txt；.doc/.wps 经 LibreOffice/Word/WPS COM 转换，失败时提示另存为 .docx/.md
• 备选路线：用户明确需要官方模板视觉样式（封面、页眉页脚）时，走 tencent-docx 插件（full_pipeline）并按 document-style-guide.md 第9节映射落地：标题层级样式、表格样式模板（灰底表头＋细边框＋列宽分配）、封面版式、目录、页眉页脚页码、每章另起一页

内容零篡改纪律（硬性，逐条执行）：

1. 逐字保留：排版只改字体、字号、缩进、版心、页码与表格形态；不增、不删、不改写任何文字
2. 不生成任何草稿中没有的题注：图题/表题一律以草稿为准，禁止排版过程自动补写（如"表N 主要情况汇总"之类）
3. 占位块保全：每个 【图N-x …：待插入】 及其"图类型/图形要素/与正文对应/下游用途"各行必须完整出现在 Word 中，一块不漏（这是后续补图与 vsdx 交付的依据）
4. 转换后自检：运行 python scripts/verify_docx_fidelity.py <草稿.md> <成稿.docx>，确认"丢失片段 0"（Markdown 表格分隔行除外）后再交付

输出文件名建议：需求分析文档-<场景名>.docx / 数字化解决方案文档-<场景名>.docx

第 6 步（可选）：细化设计——服务原型生成与 AI coding

用户确认解决方案文档后，若用户需要原型或 AI coding 输入，读取 references/prototype-ai-coding-design-guide.md，按其格式输出细化设计包（同样先 md、确认后再转交付格式）：

• 页面清单＋页面明细卡：每页标注所属 F-xx/FR-xx、组件、交互（条件-操作-结果）、空态/异常态、权限码、引用规则——原型工具逐页照此生成
• 数据模型：数据字典升级为建表级定义（字段/类型/约束/枚举域/索引）
• API 契约：由 FR 推导端点，含错误码与"执行规则"列（服务端必须重复执行全部 R-xx 校验）
• 状态机与规则判定表：R-xx 转判定表＋伪代码，供 AI coding 直接翻译；阈值时限进参数表
• AI coding 提示词包：按"数据层→规则层→接口层→页面层→测试层"组织上下文，附逐页提示词模板
• 核心纪律：页面 PG-xx、功能点 F-xx、需求 FR-xx、规则 R-xx、数据字段、API 端点五向一致，任何修改五处同步

第 7 步：交稿前自查（对照评分点）

需求分析文档自查：
- ☐ 第2/4章：角色覆盖赛题资料清单全部主体？含权限矩阵、端到端闭环主场景与异常分支？
- ☐ 第3章：痛点逐条根因化（缺规则/缺数据/缺机制三层）＋影响量化＋解法映射？
- ☐ 第4/5/6章：三类需求编号化可溯源、验收标准可判定、数据字典完整、非功能全量化？

解决方案文档自查：
- ☐ 1.3：FR→功能点覆盖矩阵100%覆盖，结论句"无遗漏、无偏离"？
- ☐ 3.2：六环闭环齐全，每环引用规则编号，含异常分支与统计反哺？
- ☐ 第4章：五类规则齐全且每条可核验？R-xx 编号被闭环表/功能清单/流程图/功能描述四处引用？
- ☐ 第5章：AI赋能点三要素齐全？
- ☐ 附录B：流程图文字稿已写（阈值/时限与第4章规则表数字一致），提示用户 vsdx 源文件为硬性交付项？

细化设计自查：见 prototype-ai-coding-design-guide.md 第10节（五向一致）。

样式自查：见 document-style-guide.md 第10节（标题无跳级断号、表题引用齐全、表头样式统一、量化数字与编号加粗、封面/目录/页眉页脚齐全、无模糊表述残留）。

两文档联合自查：P/FR/R 编号、量化数字、模块名称三处完全一致。

资源清单

• references/requirements-analysis-template.md——需求分析文档结构模板（官方docx 9章骨架＋评分点对照＋表格列定义＋填写要求＋PRD规范编号体系，不含可套用示例）
• references/digital-solution-template.md——数字化解决方案文档结构模板（官方docx 9章骨架＋评分点对照＋表格列定义＋填写要求＋依赖项/成功指标表＋AI赋能三要素，不含可套用示例）
• references/prototype-ai-coding-design-guide.md——细化设计指南（页面清单/页面卡/数据模型/API契约/状态机/规则工程化/权限/AI赋能规格/AI coding提示词包）
• references/document-style-guide.md——文档样式与排版规范（版式/字体层级/编号/表格/图/强调与交叉引用/语言细节/常见错误对照/md→docx映射/样式自查）
• references/doc-format-guide.md——doc-format 公文排版指南（命令用法/输入书写约定/GB/T 9704排版规则/与工作流衔接/常见问题，支持doc/docx/wps/txt/md输入）
• scripts/doc_format.py——doc-format 多格式排版入口（调用 scripts/format_document.py 引擎，输出公文格式 docx；--toc 插自动目录页）
• scripts/verify_docx_fidelity.py——排版保真校验（比对草稿 md 与成稿 docx，确认内容零丢失、占位块完好）
• scripts/format_document.py——公文排版引擎 v2.1.0（标题层级（Word 内置标题1/2/3）/表格/附件/页面设置/自动目录，依赖 python-docx）
• config/format.json——排版参数配置（GB/T 9704 版心、字体字号、标题层级模式）