ic-dev-toolkit

数字IC开发 Claude Code 插件。提供 HDL 编码规范、项目脚手架、CDC/风格/综合前检查。

安装

claude plugin add /path/to/ic-dev-toolkit     # 本地安装
claude plugin add github:你的用户名/ic-dev-toolkit  # 从 GitHub 安装

功能

Skills（自动 + 手动触发）

命令	说明	触发方式
/ic:init [路径]	初始化IC项目目录结构和配置	手动
ic:hdl-coding-style	HDL编码规范（命名、FSM、CDC等）	写 .v/.sv 时自动加载

Agents（通过对话调用）

Agent	说明	用法示例
cdc-reviewer	CDC路径安全检查	"用 cdc-reviewer 检查 rtl/ahb_bridge.v"
hdl-style-checker	HDL编码规范检查	"用 hdl-style-checker 检查 rtl/ 目录"
pre-syn-checker	综合前质量检查	"用 pre-syn-checker 检查所有RTL文件"

Hooks（自动执行，强制约束）

Hook	触发时机	功能
check_locked	Edit/Write/MultiEdit 之前	阻止修改包含 // CLAUDE-LOCKED 标记的文件

使用方法：在不希望被Claude修改的关键文件（如已release的golden RTL、IP核源码、综合脚本）头部20行内任意位置加上注释标记：

// CLAUDE-LOCKED
// 此文件已锁定，请勿修改
module golden_axi_master(
    ...
);

之后Claude试图Edit/Write该文件时会被自动阻止。需要修改时手动移除该标记即可。

初始化后的项目结构

your-ic-project/
├── CLAUDE.md                              ← 项目级配置（填写项目信息）
├── process.txt                            ← 变更日志
├── .gitignore
├── .claude/
│   ├── skills/hdl-coding-style/SKILL.md   ← HDL规范（本地副本）
│   └── agents/
│       ├── cdc-reviewer.md
│       ├── hdl-style-checker.md
│       └── pre-syn-checker.md
├── rtl/                                   ← RTL 源码
├── tb/                                    ← Testbench
├── syn/                                   ← 综合脚本和约束
├── sim/                                   ← 仿真脚本
├── doc/                                   ← 设计文档
└── scripts/                               ← 辅助脚本

配套全局 CLAUDE.md

建议将精简版全局规范放到 ~/.claude/CLAUDE.md，控制通用行为和工作流。 全局规范不包含 HDL 内容，HDL 规范由本插件按需加载。

更新

claude plugin update ic

自定义

初始化后，项目内的 .claude/skills/ 和 .claude/agents/ 是独立副本，可以根据项目需求自由修改，不影响插件本体。