| name | chip-create-dir |
| description | Use when initializing chip module workspace directory structure. Triggers on '创建目录', '初始化目录', '目录结构', 'workspace', '工作目录', 'create dir'. Creates ds (design) and dv (verification) directory trees with standard subdirectories. |
Chip Create Directory
任务
为芯片模块创建标准化工作目录结构,初始化 <module_name>_work/ 根目录及 ds/dv 两级目录树。
依赖
执行步骤
- 确认模块名:用户输入
<module_name>(必填),如 axi_bridge、pcie_ctrl。命名规范:字母+数字+下划线。
- 确认父目录:用户输入
[parent_dir](可选),默认当前目录 .。
- 检查目录是否已存在:若
<module_name>_work/ 已存在,提示用户选择:覆盖/跳过/重命名。
- 执行创建:运行脚本或手动
mkdir -p 创建完整目录树。
- 验证结果:运行
tree 或 ls -R 确认所有目录存在。
调用命令:
bash .claude/skills/chip-create-dir/init_workdir.sh <module_name> [parent_dir]
目录结构
<module_name>_work/
├── ds/ # Design(设计)
│ ├── doc/ # 设计文档
│ │ ├── pr/ # PR 原始资料
│ │ ├── fs/ # 功能规格书(FS)
│ │ ├── ua/ # 微架构规格书(UA)
│ │ └── report/ # 设计报告
│ ├── rtl/ # RTL 源码
│ ├── lib/ # IP/CBB 库
│ ├── common/ # 公共头文件(.vh)、Interface(.sv)
│ └── run/ # 综合/实现运行目录
│
└── dv/ # Verification(验证)
├── doc/ # 验证文档
│ ├── chk_point/ # 验证检查点
│ ├── plan/ # 验证计划
│ └── report/ # 验证报告
├── env/ # 验证环境(UVM/自定义)
├── tb/ # Testbench
├── case/ # 测试用例
├── ral/ # 寄存器抽象层
└── run/ # 仿真运行目录
使用示例
bash .claude/skills/chip-create-dir/init_workdir.sh axi_bridge
bash .claude/skills/chip-create-dir/init_workdir.sh axi_bridge /d/work/project
创建完成后输出目录树摘要。
异常处理
| 场景 | 触发条件 | 处理动作 |
|---|
| 脚本不存在 | init_workdir.sh 找不到 | 用 mkdir -p 手动创建目录结构,输出创建日志 |
| 目录已存在 | 目标 _work 目录已存在 | 提示用户:覆盖/跳过/重命名,等待确认 |
| 权限不足 | mkdir 失败 | 提示权限问题,建议 chmod 或换目录 |
| 模块名非法 | 含空格/特殊字符 | 提示命名规范(字母+数字+下划线),等待修正 |
检查点
- 创建前:展示即将创建的目录结构,用户确认后执行
- 创建后:展示
tree 输出,确认所有目录存在