Requirements Spec Doc

生成或检查需求设计说明书章节,覆盖总体设计、业务流程、功能 IPO、内部接口、权限、数据需求和报表,并维护功能、流程、页面、字段之间的追溯。用于需求说明书、功能设计、IPO 表、流程说明和画面逻辑;不要用于 OpenAPI、数据库 DDL 或流程图 XML。

chenychenyu ed34eeb 12 files · 28.4 KB Updated

File contents

需求设计说明书

模式与文件边界

  • create:生成指定章节并验证本轮产物。
  • validate:只读执行 43 项检查。
  • review:与 validate 相同,只读给出评审结论,不默认保存报告。
  • repair:用户明确授权后修改既有说明书。

只允许写入模板定义的五类文件,不得创建 PLAN007-ipo.mdflow-xxx.md 等任意命名文件。先读取 文档骨架 确认目标位置。

执行流程

  1. 读取唯一规则源:需求说明书标准
  2. 按章节选择资源:
  3. 仅在需要结构对照时读取 examples/ 下的匿名合成样例;命令按钮处理逻辑达不到步骤级要素时,对照 IPO 颗粒度样例 补齐。
  4. 命令按钮的 Process 必须满足标准 §5.1 按钮级覆盖和 §5.2 GB 颗粒度基线;执行类活动与命令按钮一一对应。
  5. 保持流程编码、活动编码、功能编码、页面、权限岗位和字段集合可追溯。
  6. 记录 deliveryFormat:Markdown 阶段为 markdown-source,装配并渲染后的 Word 为 final-word
  7. 执行标准第十一章 43 项验证:先运行 wl-skills-design verify spec 获取 [M] 项机械结论(CLI 不可用时由 Agent 代执行),再逐项判定 [J] 项,合并为同一编号的报告。markdown-source 的 P01–P05 标记 Pending,不得判失败;缺业务事实使用 【待补充:说明】 并标记 Pending。

交付约束

  • 流程部分和 IPO 部分写入同一子模块文件。
  • 验证报告给出规则 ID、文件位置和差异集合,不能只写“已检查”。
  • 验证模式不修改既有文件;创建模式只修复本轮新内容。
  • 最终说明 Skill、章节路径、43 项结果和跨文档差异。

chenychenyu/wl-skills-design/tree/main/files/.github/skills/requirements-spec-doc commit ed34eebeef

Frequently asked questions

npx skillmds@latest add chenychenyu/requirements-spec-doc