1. 架构设计与需求审计工作流
本工作流覆盖芯片研发与验证前置的设计规范审核、需求一致性验证、规格抽取与 HAL 文档生成,IP 级与 SoC 级各有一套审查 Skill。通过对原始设计文档与需求规范的自动化处理与静态审查,确保在开始编写验证环境与测试计划前获取无歧义的规范说明。
编排工作流:ic-audit-design-auto
ic-audit-design-auto 是本阶段的自动化审查编排 Skill。当执行设计审查流水线时,该 Skill 依次调用 ic-audit-prd-spec 与 ic-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 产出的清单无法指导行动。
- 输入说明:
$0SoC 规格说明书 (.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的职责。 - 输入说明:
$0SoC 集成 Spec (.md);$1SoC 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 审查)。在每个审查阶段完成后暂停,等待用户确认审查结果后再继续执行。
