Skip to content

1. 架构设计与需求审计工作流

本工作流覆盖芯片研发与验证前置的设计规范审核、需求一致性验证、规格抽取与 HAL 文档生成,IP 级与 SoC 级各有一套审查 Skill。通过对原始设计文档与需求规范的自动化处理与静态审查,确保在开始编写验证环境与测试计划前获取无歧义的规范说明。


编排工作流:ic-audit-design-auto

ic-audit-design-auto 是本阶段的自动化审查编排 Skill。当执行设计审查流水线时,该 Skill 依次调用 ic-audit-prd-specic-audit-spec,并在每个阶段审查完成后暂停,等待用户确认后再进入下一阶段。


Skill 详解

1. ic-docx2md:Word / PDF 文档转 Markdown

  • 功能说明:将 .docx.pdf 文档转换为 Markdown 文件,自动提取文档中的嵌入图片,并调用视觉模型对图片内容进行分析补充(按尺寸过滤掉图标、分隔线等无信息量的小图)。
  • 输入说明.docx.pdf(PDF 走 pdf2md.py,与 docx 输出同一格式)。
  • 输出说明:指定的 .md 文件及提取的图片目录。
  • 用法/ic-docx2md <input.docx|input.pdf> <output.md>

2. ic-audit-spec:Spec 质量审查

  • 功能说明:串行执行 FSM(有限状态机)逻辑审查与 Spec 整体质量审查。扫描规范中是否存在未定义的异常跳转、死锁状态、未初始化的复位行为以及描述模糊的文字语句。
  • 输入说明:Markdown 格式的设计规范文档 (.md)。
  • 输出说明:输出两份结构化 Markdown 报告(FSM 逻辑审查报告Spec 整体质量审查报告)。

3. ic-audit-prd-spec:PRD 需求对比验证

  • 功能说明:以产品需求文档(PRD)为基准,逐条对比稽查 IP 需求是否在 Design Spec 中得到落实,检查功能点遗漏、寄存器位宽不一致或参数冲突。
  • 输入说明:PRD 需求文档 (.md) 与 Design Spec (.md)。
  • 输出说明:结构化 Markdown 需求验证报告。

3b. ic-audit-soc-spec:SoC 级 Spec 质量审查

  • 功能说明:按 IP 级 / 连接级 / 系统级三个验证角度,逐项核查 SoC 规格说明书是否提供了验证所需的信息。它回答的不是「这份文档写得好不好」——那是通用文档挑刺,对上百页的 SoC Spec 产出的清单无法指导行动。
  • 输入说明$0 SoC 规格说明书 (.md);$1 芯片寄存器描述文件 (.svd / IP-XACT .xml,选填);$2 报告输出目录(选填)。
  • 输出说明:三份 Markdown 审查报告,分别对应三个验证角度。
  • 寄存器降级模式:缺 $1 时不终止,但标为「A 主源」的审核点会失去唯一的第二来源;三份报告开头都会如实声明这一代价。
  • 不自行裁决冲突:Spec 与寄存器描述说法不一致时记 ⚠️ 并列出各方位置,交由人判断。

3c. ic-audit-soc-prd-spec:SoC 级需求验证

  • 功能说明:以 SoC PRD 为基准,逐条验证每条系统级需求是否在 SoC 集成 Spec 与芯片寄存器描述文件中得到落实。它回答的不是「某个 IP 有没有做到」——那是 IP 级审查 ic-audit-prd-spec 的职责。
  • 输入说明$0 SoC 集成 Spec (.md);$1 SoC PRD (.yaml);$2 芯片寄存器描述(选填);$3 输出路径(选填)。
  • 输出说明soc_review_result.md
  • 防呆校验:参数传反($0.yaml$1.md)会提示确认;PRD 的 scope 若为 ip 会提示改用 ic-audit-prd-spec

4. ic-gen-hal:硬件抽象层 (HAL) 文档生成

  • 功能说明:解析芯片 IP Spec (Markdown) 和寄存器描述文件 (.xml),自动生成硬件抽象层(HAL)说明文档。
  • 输入说明:IP Spec (.md) 及寄存器定义文件 (.xml)。
  • 输出说明:HAL 说明文档 (.md)。

5. ic-audit-design-auto:设计审查编排流水线

  • 功能说明:自动化设计审查流水线。依次自动调用 ic-audit-prd-spec(进行 PRD 需求验证)和 ic-audit-spec(进行 Spec 质量与 FSM 审查)。在每个审查阶段完成后暂停,等待用户确认审查结果后再继续执行。

基于 MIT 许可发布