| name | chip-impl-module-structure |
| description | Use when planning RTL module structure from microarchitecture docs. Triggers on '模块结构', '端口列表', '子模块划分', '文件清单', 'module structure', 'port list'. Extracts ports, submodule partitioning and file list from microarch docs. |
模块结构规划 Skill
任务
从微架构文档提取结构信息，规划 RTL 实现所需的端口、子模块、文件清单。
输入
microarch_doc: 微架构文档路径cbb_docs: CBB 文档（来自 RAG 检索）
执行步骤
- 用
Glob 搜索 {module}_work/ds/doc/ua/*.md 获取微架构文档列表。若文件不存在，暂停并提示用户
- 从微架构 §4.1 提取端口列表（信号名/方向/位宽/类型/时钟域/复位值）
- 从微架构 §5 确定子模块实例化列表
- 确定文件清单：
.v / _sva.sv / _intf.sv / .sdc / _tb.v
- 创建工作目录结构
{module}_work/
- 验证端口与微架构 §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
