# Chip Impl Module Structure

> 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: `zhaixin244-wq/chip-impl-module-structure` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zhaixin244-wq/chip-impl-module-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaixin244-wq/chip-impl-module-structure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhaixin244-wq (https://skillmd.com/u/zhaixin244-wq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhaixin244-wq/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`：
```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`