readable-verilog-generator
VerifiedUse when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.
assets/verilog_quality_gates.json
View on GitHub{
"version": 9,
"name": "verilog_quality_gate_catalog",
"description": "Unified VG catalog for readable Verilog RTL generation, review, and semantic validation.",
"total_rules": 136,
"active_rules": 136,
"reserved_rules": 0,
"status_counts": {
"active": 136
},
"active_level_counts": {
"BLOCKER": 64,
"WARNING": 72
},
"policy": {
"active": "Every catalog rule executes through the unified Verilog quality gate.",
"strict": "Any non-pass BLOCKER blocks delivery; WARNING findings also block strict delivery."
},
"diagnostic_contract": {
"report_version": 3,
"contract_version": 1,
"finding_fields": [
"rule_id",
"status",
"severity",
"location",
"problem",
"evidence",
"guidance"
],
"location_scopes": [
"source",
"file",
"cross_file",
"project"
],
"statuses": [
"failed",
"inconclusive",
"error",
"not_run"
],
"risk_levels": [
"low",
"medium",
"high",
"critical"
],
"example_kinds": [
"verilog",
"pseudocode",
"configuration",
"none"
],
"status_obligation": "Every applicable active non-passed rule must emit at least one actionable finding; passed rules emit no finding."
},
"config": {
"max_combinational_operations_per_target": 3,
"packed_dynamic_lookup_block_bits": 1024
},
"rules": [
{
"gate_id": "VG000",
"rule_key": "existing_vg000",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG000 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG001",
"rule_key": "existing_vg001",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG001 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG002",
"rule_key": "existing_vg002",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG002 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG003",
"rule_key": "existing_vg003",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG003 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG004",
"rule_key": "existing_vg004",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG004 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG005",
"rule_key": "existing_vg005",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG005 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG006",
"rule_key": "existing_vg006",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG006 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG007",
"rule_key": "existing_vg007",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG007 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG008",
"rule_key": "existing_vg008",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG008 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG009",
"rule_key": "existing_vg009",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG009 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG010",
"rule_key": "existing_vg010",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG010 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG011",
"rule_key": "existing_vg011",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG011 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG012",
"rule_key": "existing_vg012",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG012 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG013",
"rule_key": "existing_vg013",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG013 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG014",
"rule_key": "existing_vg014",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG014 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG015",
"rule_key": "existing_vg015",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG015 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG020",
"rule_key": "existing_vg020",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG020 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG021",
"rule_key": "existing_vg021",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG021 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG022",
"rule_key": "existing_vg022",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG022 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG023",
"rule_key": "existing_vg023",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG023 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG024",
"rule_key": "existing_vg024",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG024 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG025",
"rule_key": "existing_vg025",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG025 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG030",
"rule_key": "existing_vg030",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG030 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG031",
"rule_key": "existing_vg031",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG031 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG040",
"rule_key": "existing_vg040",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG040 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG041",
"rule_key": "existing_vg041",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG041 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG042",
"rule_key": "existing_vg042",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG042 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG050",
"rule_key": "existing_vg050",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG050 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG051",
"rule_key": "existing_vg051",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG051 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG052",
"rule_key": "existing_vg052",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG052 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG053",
"rule_key": "existing_vg053",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG053 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG054",
"rule_key": "existing_vg054",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG054 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG055",
"rule_key": "existing_vg055",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG055 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG056",
"rule_key": "existing_vg056",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG056 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG057",
"rule_key": "existing_vg057",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG057 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG058",
"rule_key": "existing_vg058",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG058 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG059",
"rule_key": "existing_vg059",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG059 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG060",
"rule_key": "existing_vg060",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG060 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG061",
"rule_key": "existing_vg061",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG061 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG062",
"rule_key": "existing_vg062",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG062 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG063",
"rule_key": "existing_vg063",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG063 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG064",
"rule_key": "existing_vg064",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG064 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG065",
"rule_key": "existing_vg065",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG065 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG066",
"rule_key": "existing_vg066",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG066 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG067",
"rule_key": "existing_vg067",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG067 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG068",
"rule_key": "existing_vg068",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG068 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG069",
"rule_key": "existing_vg069",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG069 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG070",
"rule_key": "existing_vg070",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG070 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG071",
"rule_key": "existing_vg071",
"level": "WARNING",
"status": "active",
"topic": "既有可读性与结构规则",
"summary": "保留 VG071 在 v0.6.3 中已经实现的 Verilog 质量检查语义。"
},
{
"gate_id": "VG072",
"rule_key": "op_no_xz_arith",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "禁止在算术操作时使用包含“x”或者“z”的值。"
},
{
"gate_id": "VG073",
"rule_key": "clk_single_domain",
"level": "WARNING",
"status": "active",
"topic": "时钟",
"summary": "建议仅使用一个时钟域。"
},
{
"gate_id": "VG074",
"rule_key": "op_no_logic_on_vector",
"level": "WARNING",
"status": "active",
"topic": "运算符",
"summary": "避免在向量运算中使用逻辑运算符。"
},
{
"gate_id": "VG075",
"rule_key": "rst_no_sync_async_mix",
"level": "BLOCKER",
"status": "active",
"topic": "复位",
"summary": "禁止在同一条复位线路中同时使用异步复位和同步复位。"
},
{
"gate_id": "VG076",
"rule_key": "case_no_overlap",
"level": "WARNING",
"status": "active",
"topic": "分支语句",
"summary": "case语句中的分支语句避免重叠。"
},
{
"gate_id": "VG077",
"rule_key": "rst_one_signal_per_always",
"level": "WARNING",
"status": "active",
"topic": "复位",
"summary": "建议在同一个always 语句中只使用同一个复位信号。"
},
{
"gate_id": "VG078",
"rule_key": "op_no_xz_condition",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "禁止 X/Z 参与条件判断或一般数据选择;仅允许同模块 inout 端口的连续 open-drain 0/Z 三态赋值。"
},
{
"gate_id": "VG079",
"rule_key": "comb_blocking_assign",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "组合电路必须使用阻塞赋值,禁止使用非阻塞赋值。"
},
{
"gate_id": "VG080",
"rule_key": "loop_no_nonindex_arith",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "禁止在for语句中对循环变量之外的变量进行算术运算。"
},
{
"gate_id": "VG081",
"rule_key": "repeat_const_count",
"level": "WARNING",
"status": "active",
"topic": "循环语句",
"summary": "避免在repeat语句表达式中使用变量。"
},
{
"gate_id": "VG082",
"rule_key": "rst_no_glitchy_comb",
"level": "BLOCKER",
"status": "active",
"topic": "复位",
"summary": "禁止使用有竞争冒险情况的组合逻辑输出作为复位信号。"
},
{
"gate_id": "VG083",
"rule_key": "loop_no_reset_logic_mix",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "复位部分和逻辑部分禁止出现在同一个for循环中。"
},
{
"gate_id": "VG084",
"rule_key": "case_item_in_range_width",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "case语句的所有分支表达式必须在控制表达式的范围之内,并且数据位宽一致。"
},
{
"gate_id": "VG085",
"rule_key": "op_rel_width_match",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "关系操作符左边与右边的数据位宽必须一致。"
},
{
"gate_id": "VG086",
"rule_key": "fsm_has_initial_state",
"level": "BLOCKER",
"status": "active",
"topic": "状态机结构",
"summary": "状态机必须设置初始状态。"
},
{
"gate_id": "VG087",
"rule_key": "synth_no_reset_override",
"level": "BLOCKER",
"status": "active",
"topic": "与综合器相关的编码准则",
"summary": "禁止使用综合工具改变代码的复位属性。"
},
{
"gate_id": "VG088",
"rule_key": "branch_cond_scalar",
"level": "WARNING",
"status": "active",
"topic": "分支语句",
"summary": "if语句和条件运算符的条件表达式避免为向量,建议由单位宽信号组成。"
},
{
"gate_id": "VG089",
"rule_key": "clk_no_comb_clock",
"level": "BLOCKER",
"status": "active",
"topic": "时钟",
"summary": "禁止将组合逻辑的输出作为时钟信号。"
},
{
"gate_id": "VG090",
"rule_key": "case_control_not_constant",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "禁止在case语句的控制表达式中使用固定值。"
},
{
"gate_id": "VG091",
"rule_key": "array_index_simple",
"level": "WARNING",
"status": "active",
"topic": "结构说明语句",
"summary": "建议数组索引为简单的信号,避免使用表达式。"
},
{
"gate_id": "VG092",
"rule_key": "loop_at_least_once",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "循环语句必须至少满足一次循环条件。"
},
{
"gate_id": "VG093",
"rule_key": "rst_no_async_to_data_pin",
"level": "BLOCKER",
"status": "active",
"topic": "复位",
"summary": "禁止将异步的置位/复位信号连接到非置位/复位管脚。"
},
{
"gate_id": "VG094",
"rule_key": "fsm_default_reset_regs",
"level": "BLOCKER",
"status": "active",
"topic": "状态机结构",
"summary": "状态机在default状态时,必须把状态机中所有寄存器重置为确定状态(复位状态或者空闲状态)。"
},
{
"gate_id": "VG095",
"rule_key": "latch_no_gate_primitive",
"level": "BLOCKER",
"status": "active",
"topic": "锁存器",
"summary": "禁止使用基本逻辑门来描述锁存器。"
},
{
"gate_id": "VG096",
"rule_key": "clk_avoid_gating",
"level": "WARNING",
"status": "active",
"topic": "时钟",
"summary": "避免使用门控时钟。"
},
{
"gate_id": "VG097",
"rule_key": "conn_port_width_match",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "模块端口的数据位宽与实例化信号的数据位宽必须一致。"
},
{
"gate_id": "VG098",
"rule_key": "fsm_no_dead_unreachable",
"level": "BLOCKER",
"status": "active",
"topic": "状态机结构",
"summary": "状态机禁止出现死锁状态和不可达状态。"
},
{
"gate_id": "VG099",
"rule_key": "rst_dedicated_generator",
"level": "WARNING",
"status": "active",
"topic": "复位",
"summary": "建议为复位产生电路创建独立的模块。"
},
{
"gate_id": "VG100",
"rule_key": "rst_no_internal_async_src",
"level": "WARNING",
"status": "active",
"topic": "复位",
"summary": "避免使用内部生成信号作为寄存器的异步复位信号。"
},
{
"gate_id": "VG101",
"rule_key": "branch_cond_no_xz",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "if语句的条件表达式与case语句的控制表达式中禁止出现“x”或者“z”。"
},
{
"gate_id": "VG102",
"rule_key": "rst_no_set_reset_pair",
"level": "WARNING",
"status": "active",
"topic": "复位",
"summary": "避免同时使用异步置位和异步复位信号。"
},
{
"gate_id": "VG103",
"rule_key": "assign_no_dup_condition",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "禁止在同一条件下对同一个信号进行重复赋值。"
},
{
"gate_id": "VG104",
"rule_key": "latch_no_comb_loop",
"level": "BLOCKER",
"status": "active",
"topic": "锁存器",
"summary": "禁止出现含有锁存器的组合逻辑环路。"
},
{
"gate_id": "VG105",
"rule_key": "case_item_constant_only",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "case语句的分支语句必须使用常量,禁止使用变量或者逻辑运算。"
},
{
"gate_id": "VG106",
"rule_key": "func_no_recursion",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "禁止调用递归函数。"
},
{
"gate_id": "VG107",
"rule_key": "clk_no_regout_clock",
"level": "BLOCKER",
"status": "active",
"topic": "时钟",
"summary": "禁止将寄存器的输出直接连接到其它寄存器的时钟管脚。"
},
{
"gate_id": "VG108",
"rule_key": "case_default_not_xz",
"level": "WARNING",
"status": "active",
"topic": "分支语句",
"summary": "case语句的default分支禁止赋值为“x”或者“z”。"
},
{
"gate_id": "VG109",
"rule_key": "comb_if_has_else",
"level": "WARNING",
"status": "active",
"topic": "分支语句",
"summary": "建议组合逻辑电路中if语句以else语句结尾。"
},
{
"gate_id": "VG110",
"rule_key": "ff_init_on_reset",
"level": "BLOCKER",
"status": "active",
"topic": "触发器",
"summary": "在复位或者初始化时,必须对触发器赋初值。"
},
{
"gate_id": "VG111",
"rule_key": "case_has_default",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "在case语句中必须使用default分支。"
},
{
"gate_id": "VG112",
"rule_key": "fsm_limit_state_count",
"level": "WARNING",
"status": "active",
"topic": "状态机结构",
"summary": "建议单个状态机的状态数不超过40个。"
},
{
"gate_id": "VG113",
"rule_key": "ff_no_mixed_reset_style",
"level": "BLOCKER",
"status": "active",
"topic": "触发器",
"summary": "禁止在同一个always 语句中混合使用有复位和无复位的触发器。"
},
{
"gate_id": "VG114",
"rule_key": "synth_no_full_case_attr",
"level": "WARNING",
"status": "active",
"topic": "与综合器相关的编码准则",
"summary": "避免使用“full_case”属性。"
},
{
"gate_id": "VG115",
"rule_key": "task_io_width_match",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "在task语句中,输入信号的位宽与输出信号的位宽必须一致。"
},
{
"gate_id": "VG116",
"rule_key": "ff_reset_condition_match",
"level": "BLOCKER",
"status": "active",
"topic": "触发器",
"summary": "复位信号的触发条件与进入条件必须一致。"
},
{
"gate_id": "VG117",
"rule_key": "sens_no_or_separator",
"level": "BLOCKER",
"status": "active",
"topic": "分支语句",
"summary": "禁止使用“|”和“||”连接敏感信号。"
},
{
"gate_id": "VG118",
"rule_key": "rst_no_logic_in_async_path",
"level": "WARNING",
"status": "active",
"topic": "复位",
"summary": "避免在异步复位线路中插入逻辑操作运算。"
},
{
"gate_id": "VG119",
"rule_key": "fsm_min_transition_flips",
"level": "WARNING",
"status": "active",
"topic": "状态机结构",
"summary": "建议尽量减少状态机在状态转换时的改变位数。"
},
{
"gate_id": "VG120",
"rule_key": "clk_single_edge",
"level": "WARNING",
"status": "active",
"topic": "时钟",
"summary": "避免同时使用时钟的上升沿和下降沿。"
},
{
"gate_id": "VG121",
"rule_key": "func_return_width",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "在function语句中,必须显式指定返回值的位宽。"
},
{
"gate_id": "VG122",
"rule_key": "op_no_arith_overflow",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "禁止算术运算结果出现位宽溢出。"
},
{
"gate_id": "VG123",
"rule_key": "loop_for_const_bounds",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "for语句的初始值和条件必须为常数,且禁止改变循环变量。"
},
{
"gate_id": "VG124",
"rule_key": "initial_forbidden",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "禁止使用initial语句。"
},
{
"gate_id": "VG125",
"rule_key": "literal_width_match",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "在数值<位宽><进制><数字>表示中,数值位宽必须与数值的实际位宽一致。"
},
{
"gate_id": "VG126",
"rule_key": "sens_list_complete_minimal",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "敏感信号列表中的敏感信号必须齐全,无遗漏,无冗余。"
},
{
"gate_id": "VG127",
"rule_key": "subprogram_no_global_write",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "在function和task语句中,禁止对全局信号进行赋值。"
},
{
"gate_id": "VG128",
"rule_key": "case_no_casex_casez",
"level": "WARNING",
"status": "active",
"topic": "分支语句",
"summary": "避免使用casex与casez语句。"
},
{
"gate_id": "VG129",
"rule_key": "seq_nonblocking_assign",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "时序电路必须使用非阻塞赋值,禁止使用阻塞赋值。"
},
{
"gate_id": "VG130",
"rule_key": "array_index_in_range",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "禁止数组索引越界。"
},
{
"gate_id": "VG131",
"rule_key": "assign_no_delay",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "禁止使用延时语句。"
},
{
"gate_id": "VG132",
"rule_key": "clk_only_clock_pin",
"level": "BLOCKER",
"status": "active",
"topic": "时钟",
"summary": "禁止将时钟信号连接在除寄存器时钟管脚之外的其它信号管脚。"
},
{
"gate_id": "VG133",
"rule_key": "task_no_timing_control",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "禁止在task语句中使用时序控制语句。"
},
{
"gate_id": "VG134",
"rule_key": "op_no_sign_mix",
"level": "BLOCKER",
"status": "active",
"topic": "运算符",
"summary": "禁止在算术表达式中同时出现无符号数和有符号数。"
},
{
"gate_id": "VG135",
"rule_key": "latch_separate_from_comb",
"level": "WARNING",
"status": "active",
"topic": "锁存器",
"summary": "建议将锁存器与其它组合逻辑电路分开描述。"
},
{
"gate_id": "VG136",
"rule_key": "comb_no_feedback",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "禁止在组合逻辑电路中使用反馈。"
},
{
"gate_id": "VG137",
"rule_key": "assign_width_match",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "赋值语句左右两边的数据位宽必须一致。"
},
{
"gate_id": "VG138",
"rule_key": "literal_explicit_base_width",
"level": "WARNING",
"status": "active",
"topic": "运算符",
"summary": "建议为parameter 数据和常数指定进制('d,'b,'h,'o)和位宽。"
},
{
"gate_id": "VG139",
"rule_key": "func_no_nonblocking",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "禁止在function语句中使用非阻塞赋值。"
},
{
"gate_id": "VG140",
"rule_key": "procedural_assign_to_wire",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "禁止在过程块中对 wire 信号赋值。"
},
{
"gate_id": "VG141",
"rule_key": "multiple_drivers",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "同一信号禁止存在多个独立驱动源。"
},
{
"gate_id": "VG142",
"rule_key": "wire_declaration_inline_assignment",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "禁止在 wire 声明语句中直接附带初始化赋值。"
},
{
"gate_id": "VG143",
"rule_key": "simulation_system_task_in_rtl",
"level": "BLOCKER",
"status": "active",
"topic": "结构说明语句",
"summary": "设计 RTL 中禁止使用 $display、$finish 或 $stop。"
},
{
"gate_id": "VG144",
"rule_key": "fsm_three_segment_procedural_next_state",
"level": "BLOCKER",
"status": "active",
"topic": "状态机",
"summary": "FSM 必须严格采用三段式结构,下一状态必须在独立组合过程内赋值,禁止使用 continuous assign。"
},
{
"gate_id": "VG145",
"rule_key": "comb_cone_max_three_sources",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "连续赋值与组合过程形成的完整 module 局部组合依赖锥最多允许三个源信号;仅豁免输出端口到时序 `_o` reg 的直接桥。"
},
{
"gate_id": "VG146",
"rule_key": "comb_operation_budget",
"level": "BLOCKER",
"status": "active",
"topic": "赋值语句和块语句",
"summary": "在完整 source closure 中,按 definition root、instance path、parameter specialization 与静态目标累计普通组合操作;structured associations 绑定 output,inout 保持 resolved boundary,寄存器只在 Q 输出切断。报告必须给出 root/path/specialization/target/child output/count/limit;未知 loop_presence 与 VG147 共享下界证据。"
},
{
"gate_id": "VG147",
"rule_key": "for_comb_operation_budget",
"level": "BLOCKER",
"status": "active",
"topic": "循环语句",
"summary": "在完整 source closure 中,包含展开 for occurrence 的目标按 definition root、instance path 与 parameter specialization 累计克隆操作。loop_presence=unknown 时 VG146/VG147 均 applicable:已知下界超限则两者 failed,否则两者 inconclusive,并共享 root/path/count/reason 证据。"
},
{
"gate_id": "VG148",
"rule_key": "functional_verilog_filename",
"level": "BLOCKER",
"status": "active",
"topic": "文件命名",
"summary": "Verilog/SystemVerilog 文件名不得以独立版本号或无功能含义的纯数字段结尾;功能标准中的数字 token 保持允许,工具只报告建议而不自动重命名。"
},
{
"gate_id": "VG149",
"rule_key": "testbench_filename_prefix",
"level": "BLOCKER",
"status": "active",
"topic": "文件命名",
"summary": "经名称、精确测试目录或用户确认识别的 testbench 必须使用非空 tb_<功能名> 文件名;普通命名但内容双证据疑似 testbench 时必须二次确认。"
},
{
"gate_id": "VG150",
"rule_key": "comments.semantic_integrity",
"level": "WARNING",
"status": "active",
"topic": "注释",
"summary": "实体 RTL 注释不得承载图谱、测试、验证或评审流程证据,也不得通过固定长度、周期重复的无关中文尾串填充注释;证据应保留在门禁报告中。"
},
{
"gate_id": "VG151",
"rule_key": "parameter_contract_coverage",
"level": "BLOCKER",
"status": "active",
"topic": "参数合同",
"summary": "设计需求中的参数合同按表达式引用的公开参数集合自动适用,不绑定模块名;每个可观察 parameter 必须有可求值且满足的合同。"
},
{
"gate_id": "VG152",
"rule_key": "packed_dynamic_lookup_resource",
"level": "BLOCKER",
"status": "active",
"topic": "资源结构",
"summary": "超过目录阈值的大型 packed 参数不得直接承担运行时动态查表;必须提供可识别的译码、memory/ROM 或目标器件原语结构。"
},
{
"gate_id": "VG153",
"rule_key": "read_without_driver",
"level": "BLOCKER",
"status": "active",
"topic": "信号生存性",
"summary": "被 RTL 逻辑读取的内部信号和输出端口必须存在可确认的驱动源,不能依靠未初始化或隐式网络状态。"
},
{
"gate_id": "VG154",
"rule_key": "unused_declaration",
"level": "WARNING",
"status": "active",
"topic": "信号生存性",
"summary": "内部声明必须参与当前模块的可观察逻辑;未使用的 parameter、localparam、net 或变量应删除或接入真实功能。"
},
{
"gate_id": "VG155",
"rule_key": "ready_valid_transfer_integrity",
"level": "BLOCKER",
"status": "active",
"topic": "接口握手",
"summary": "可确认的 ready-valid 通道消费行为必须同时受同一通道 valid 与 ready 控制,角色来自接口事实而非固定模块或目标名称。"
},
{
"gate_id": "VG156",
"rule_key": "naming.declaration_digit_tokens",
"level": "BLOCKER",
"status": "active",
"topic": "变量命名",
"summary": "变量声明名称按下划线切分后,任何含数字 token 必须完整命中受管协议、算法或速率白名单;v1、v2、w0、1、2 等序号式 token 禁止交付。"
},
{
"gate_id": "VG157",
"rule_key": "comments.version_markers",
"level": "BLOCKER",
"status": "active",
"topic": "注释",
"summary": "普通 RTL 注释不得出现 vN、verN、version N 或版本 N 等版本字样;仅 formatter 识别的固定双语文件头与修订历史范围豁免。"
},
{
"gate_id": "VG158",
"rule_key": "naming.functional_declaration",
"level": "BLOCKER",
"status": "active",
"topic": "变量命名",
"summary": "变量声明名称重复剥离受管前缀和 _o 后缀后,必须至少保留一个非占位、非泛化的功能词;未知领域术语默认视为有效。"
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |