SuperAPI AI 工具集

requirements-docx

办公与效率

查看项目

更新于 10-15 17:31

技能介绍

用途:把符合 USDM 模板结构的 Markdown 需求文档转换为专业排版的 Word(.docx)文件,用于客户提交。该技能只负责格式化,不创建或修改需求内容(需求编写由 usdm 和 ears 技能负责)。

主要能力:解析并校验输入 Markdown,提取元数据(Document ID、Version、Status、Author、Created、Last Updated)、需求(REQ-NNN 层级及 Reason/Description)、规格(SPEC-NNN)以及各类表格(Ticket References、Stakeholders、Glossary、Traceability Matrix、Open Questions、Change History)。生成含封面页(标题、Logo 占位、元数据表、保密声明)、自动目录、正文各章节、页眉页脚(页脚为 Page X of Y)的文档。支持 EARS 关键词(WHEN、WHILE、IF、THEN、WHERE 及 shall、may)加粗,表格统一表头样式(浅蓝底 #D5E8F0、浅灰边框)。

使用方式:读取用户指定的 Markdown 文件并校验,缺失 Document ID、Version、Author 等必填元数据时提示补充;若某需求缺少规格则警告并列出 ID。规划版式并与用户确认后,必须先阅读 references/docx-js-pitfalls.md,再读取样式与结构映射参考文件,检查或生成 scripts/usdm-md-to-docx.js,用 node 执行生成 .docx,按 Document ID 命名并报告路径与大小。可用 unzip 与 xmllint 检查 pStyle、gridCol;若安装了 soffice 可转 PDF 做视觉验证。

适用场景:需要将 USDM/EARS 需求文档整理为可交付 Word 版本的团队。

限制:仅支持符合 USDM 模板结构的 Markdown 输入;不生成或修改需求内容;视觉验证依赖 LibreOffice 是否安装。具体收费、价格与平台信息暂未提供。