chip-impl-module-structure

模块结构规划 Skill

任务

从微架构文档提取结构信息，规划 RTL 实现所需的端口、子模块、文件清单。

输入

• microarch_doc: 微架构文档路径
• cbb_docs: CBB 文档（来自 RAG 检索）

执行步骤

1. 用 Glob 搜索 {module}_work/ds/doc/ua/*.md 获取微架构文档列表。若文件不存在，暂停并提示用户
2. 从微架构 §4.1 提取端口列表（信号名/方向/位宽/类型/时钟域/复位值）
3. 从微架构 §5 确定子模块实例化列表
4. 确定文件清单：.v / _sva.sv / _intf.sv / .sdc / _tb.v
5. 创建工作目录结构 {module}_work/
6. 验证端口与微架构 §4.1 一致性

输出

• port_list: 端口列表（信号名/方向/位宽/类型）
• submodule_list: 子模块列表（模块名/功能/依赖）
• file_list: 文件清单
• work_dir: 工作目录路径

工作目录结构

{module}_work/
├── rtl/           — RTL 源码
├── syn/           — SDC + Makefile
├── ds/
│   ├── doc/       — CBB 清单
│   ├── run/       — 运行脚本
│   └── report/    — Lint/综合报告

Gate

端口列表必须与微架构 §4.1 完全一致。

架构冻结

本 Skill 不涉及架构决策，仅从微架构提取结构信息。

Metrics

执行完成后记录到 {work_dir}/ds/report/metrics/module_structure.json：

{"stage_id": "module_structure", "duration_ms": 0, "iteration_count": 1}

使用示例

示例 1：

• 用户：「根据 data_adpt 微架构文档规划模块结构」
• 行为：读取微架构 §4.1 提取端口列表，§5 确定子模块实例化，生成文件清单（.v/_sva.sv/_intf.sv/.sdc/_tb.v），创建工作目录

示例 2：

• 用户：「buf_mgr 有几个子模块，帮我列出端口和文件清单」
• 行为：从微架构文档提取各子模块端口（信号名/方向/位宽/类型），确认子模块依赖关系，输出 port_list、submodule_list、file_list

异常处理

场景	触发条件	处理动作
微架构端口列表缺失	§4.1 无端口表格	暂停，提示用户补充微架构端口定义
子模块定义不完整	§5 无子模块实例化列表	暂停，提示用户补充子模块设计
工作目录创建失败	路径权限或磁盘问题	提示用户检查路径权限
端口与微架构不一致	提取结果与 §4.1 矛盾	以微架构为准，标注差异项

检查点

检查前：

• 确认微架构文档路径有效且包含 §4.1 和 §5
• 确认目标工作目录可写

检查后：

• 确认 port_list 与微架构 §4.1 完全一致
• 确认 submodule_list 包含所有子模块
• 确认工作目录 {module}_work/ 已创建且结构正确
• 确认 metrics 已写入 {work_dir}/ds/report/metrics/module_structure.json