# Chip Create Dir

> Use when initializing chip module workspace directory structure. Triggers on '创建目录', '初始化目录', '目录结构', 'workspace', '工作目录', 'create dir'. Creates ds (design) and dv (verification) directory trees with standard subdirectories.

- Skill: `zhaixin244-wq/chip-create-dir` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zhaixin244-wq/chip-create-dir`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaixin244-wq/chip-create-dir/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-create-dir

---


# Chip Create Directory

## 任务
为芯片模块创建标准化工作目录结构，初始化 `<module_name>_work/` 根目录及 ds/dv 两级目录树。

## 依赖
- 无外部依赖，纯目录创建

## 执行步骤

1. **确认模块名**：用户输入 `<module_name>`（必填），如 `axi_bridge`、`pcie_ctrl`。命名规范：字母+数字+下划线。
2. **确认父目录**：用户输入 `[parent_dir]`（可选），默认当前目录 `.`。
3. **检查目录是否已存在**：若 `<module_name>_work/` 已存在，提示用户选择：覆盖/跳过/重命名。
4. **执行创建**：运行脚本或手动 `mkdir -p` 创建完整目录树。
5. **验证结果**：运行 `tree` 或 `ls -R` 确认所有目录存在。

**调用命令**：
```bash
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
# 在当前目录创建
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` 输出，确认所有目录存在