[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71Y2KGWYM9T075F0ESHVT9G":3,"skill-same:01M71Y2KGWYM9T075F0ESHVT9G":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":49,"commitSha":50,"skillDirectory":5,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M71Y2KGWYM9T075F0ESHVT9G","vivado-analysis",null,"当用户需要 Vivado 设计分析、时序报告解释或时序收敛方面的帮助时使用此技能。这包括 report_timing 解释（slack 计算、路径分析、时钟 skew\u002F不确定性）、report_timing_summary 签发验证、report_qor_assessment（QoR 评分 1-5，评估类别）、report_qor_suggestions（自动优化建议，.rqs 工作流程）、report_design_analysis（时序路径特性、复杂度\u002FRent 分析、拥塞分析）、report_methodology（设计规则符合性）、report_utilization（资源使用分析）、report_cdc（时钟域交叉检查）、report_drc（设计规则检查）、report_bus_skew、时序收敛策略（setup\u002Fhold 违规解决、拥塞缓解）、消息严重性管理以及设计检查豁免。此技能提供分析和解释知识——如需执行 TCL 命令使用 vivado-tcl，如需修改约束使用 vivado-constraints，如需更改实现策略使用 vivado-impl。","ra9fael\u002Fxilinx-skills","ra9fael","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F42881610?v=4","01M71XZ3B4BV0N7JVGFJEC9CY0","飞","01M71XZ3BRK8TJRT44W0YDR0ZG",3,"GPL-2.0","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-analysis\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"vivado analysis","analysis","utilization","报告","tcl","评估","DRC","timing","规则","impl","summary","design","计算","constraints","methodology","cdc","report","assessment","setup","slack","2026-11-10 13:45:54",false,"---\nname: vivado-analysis\ndescription: 当用户需要 Vivado 设计分析、时序报告解释或时序收敛方面的帮助时使用此技能。这包括 report_timing 解释（slack 计算、路径分析、时钟 skew\u002F不确定性）、report_timing_summary 签发验证、report_qor_assessment（QoR 评分 1-5，评估类别）、report_qor_suggestions（自动优化建议，.rqs 工作流程）、report_design_analysis（时序路径特性、复杂度\u002FRent 分析、拥塞分析）、report_methodology（设计规则符合性）、report_utilization（资源使用分析）、report_cdc（时钟域交叉检查）、report_drc（设计规则检查）、report_bus_skew、时序收敛策略（setup\u002Fhold 违规解决、拥塞缓解）、消息严重性管理以及设计检查豁免。此技能提供分析和解释知识——如需执行 TCL 命令使用 vivado-tcl，如需修改约束使用 vivado-constraints，如需更改实现策略使用 vivado-impl。\n---\n\n# Vivado 设计分析与时序收敛指南\n\n基于 UG906（v2025.2）。此技能帮助解释分析报告并做出时序收敛决策。完整命令语法请参阅 REFERENCE.md。如需执行 TCL，请使用 vivado-tcl。如需修改约束，请使用 vivado-constraints。如需实现策略，请使用 vivado-impl。\n\n## 时序路径基础\n\n四种常见路径类型：\n```\n1. 输入端口 → 寄存器       （受 set_input_delay 约束）\n2. 寄存器 → 寄存器         （受时钟周期约束）\n3. 寄存器 → 输出端口      （受 set_output_delay 约束）\n4. 输入端口 → 输出端口    （组合路径，set_max_delay）\n```\n\n路径结构（三个部分）：\n```\n源时钟路径 → 数据路径 → 目标时钟路径\n（时钟源      （launch 引脚   （时钟源\n 到 launch     到 capture      到 capture\n 单元）        单元输入）       单元）\n```\n\nSlack 公式：\n- **最大延迟（Setup\u002FRecovery）：** `slack = data_required_time - data_arrival_time`\n- **最小延迟（Hold\u002FRemoval）：** `slack = data_arrival_time - data_required_time`\n\n## 最大\u002F最小延迟分析工艺角选择\n\n| 分析类型 | 源时钟 | 数据路径 | 目标时钟 |\n|-----------|--------|----------|----------|\n| Setup\u002FRecovery（最大延迟）| Slow_max | Slow_max | Slow_min |\n| Setup\u002FRecovery（最大延迟）| Fast_max | Fast_max | Fast_min |\n| Hold\u002FRemoval（最小延迟）| Slow_min | Slow_min | Slow_max |\n| Hold\u002FRemoval（最小延迟）| Fast_min | Fast_min | Fast_max |\n\n**关键规则：** 来自不同工艺角的延迟在 slack 计算中**绝不混合**在同一条路径上。\n\n## 报告选择指南\n\n| 目标 | 命令 | 何时使用 |\n|------|------|----------|\n| 快速时序签发 | `report_timing_summary` | 实现后，比特流前必需 |\n| 分析特定路径 | `report_timing -from\u002F-to\u002F-through` | 调试特定失败路径 |\n| 整体 QoR 评分（1-5）| `report_qor_assessment` | 布线后，评估收敛可能性 |\n| 自动优化提示 | `report_qor_suggestions` | 时序收敛卡住时 |\n| 路径特性 | `report_design_analysis` | 深入分析逻辑层级、扇出、物理分布 |\n| 方法学符合性 | `report_methodology` | 流程早期捕获方法学违规 |\n| 资源使用 | `report_utilization` | 综合或实现后 |\n| CDC 检查 | `report_cdc` | 综合后，验证时钟域交叉 |\n| 拥塞分析 | `report_design_analysis -congestion` | 布局后，如果时序恶化 |\n| 设计规则检查 | `report_drc` | 比特流生成前 |\n| 总线 skew | `report_bus_skew` | 如果存在 set_bus_skew 约束（不在 report_timing_summary 中）|\n\n## 时序报告头字段\n\n| 字段 | 含义 |\n|------|------|\n| Slack | 正值 = 满足时序。负值 = 违规 |\n| Source | 起点单元 + launch 时钟（边沿、名称、周期）|\n| Destination | 终点单元 + capture 时钟（边沿、名称、周期）|\n| Path Group | 包含终点的时钟组（异步引脚 → async_default）|\n| Path Type | Max（setup\u002Frecovery）或 Min（hold\u002Fremoval）；工艺角（Slow\u002FFast）|\n| Requirement | 时钟周期（相同时钟）或最小正增量（不同时钟）|\n| Data Path Delay | 逻辑部分的总延迟 |\n| Logic Levels | 数据路径中每种原语类型的计数 |\n| Clock Path Skew | 目标 - 源插入延迟 + CPR |\n| CPR | Clock Pessimism Removal — 共享时钟电路校正 |\n| Clock Uncertainty | TSJ + TIJ + DJ + PE + UU（见下方）|\n\n### 时钟不确定性组成部分\n| 组成部分 | 来源 |\n|----------|------|\n| TSJ（总系统抖动）| 两个时钟上的组合系统抖动 |\n| TIJ（总输入抖动）| 来自 set_input_jitter 约束 |\n| DJ（离散抖动）| 硬件原语（MMCM\u002FPLL）|\n| PE（相位误差）| 时钟信号之间的相位变化 |\n| UU（用户不确定性）| 来自 set_clock_uncertainty 约束 |\n\n### 路径详情中的延迟类型\n| 值 | 含义 |\n|-----|------|\n| Unplaced | 单元未布局，延迟已估计 |\n| Estimated | 单元已布局但未布线 |\n| Routed | 最终布线延迟 |\n\n## 时钟相移模式（器件默认值）\n\n| 器件系列 | 默认模式 | 行为 |\n|----------|----------|------|\n| 7 Series | WAVEFORM | 修改时钟波形边沿 |\n| UltraScale | WAVEFORM | 修改时钟波形边沿 |\n| UltraScale+ | LATENCY | 建模为 MMCM\u002FPLL 插入延迟 |\n| Versal | LATENCY | 建模为 MMCM\u002FPLL 插入延迟 |\n\n**警告：** 将 7 Series\u002FUltraScale 设计迁移到 UltraScale+ 会改变相移建模。审查并删除用于相移的遗留多周期路径约束。\n\n## QoR 评估解释（report_qor_assessment）\n\n### 分数含义\n| 分数 | 解释 | 操作 |\n|------|------|------|\n| 1 | 设计可能无法完成实现 | 需要重大重新设计 |\n| 2 | 将完成但无法满足时序 | 需要显著优化 |\n| 3 | 可能无法满足时序 | 需要针对性优化 |\n| 4 | 可能满足时序 | 轻微调整可能就够 |\n| 5 | 将满足时序 | 继续生成比特流 |\n\n### 五个评估类别\n| 类别 | 检查内容 |\n|------|----------|\n| Utilization | 器件、SLR、Pblock 级别的资源使用 |\n| Netlist | 逻辑结构、DONT_TOUCH 属性、高扇出网络 |\n| Clocking | setup 和 hold 路径上的时钟 skew |\n| Congestion | 导致布线拥塞的网表结构 |\n| Timing | 每时钟组的 WNS\u002FTNS\u002FWHS\u002FTHS，网络\u002FLUT 预算 |\n\n每个显示 **OK** 或 **REVIEW** 状态。带星号（*）的项目不直接影响分数，但影响收敛。\n\n### ML 策略可用性\n满足**所有**条件时可用：\n- opt_design 使用 Explore 或 Default 指令运行\n- phys_opt_design 已启用\n- 设计完全布线\n- UltraScale 或 UltraScale+ 器件系列\n\n### 自动终止\n设置 `MIN_RQA_SCORE` 属性（1-5）以自动终止低于阈值的运行。\n\n## QoR 建议工作流程\n\n```\nreport_qor_suggestions          ← 生成建议\n        ↓\nwrite_qor_suggestions file.rqs  ← 导出到文件\n        ↓\nread_qor_suggestions file.rqs   ← 在下次运行中导入\n        ↓\nSuggestions auto-apply          ← 如果 AUTOMATIC=Yes\n```\n\n### 建议分类\n| 维度 | 值 |\n|------|-----|\n| 来源 | GENERATED（当前运行）\u002F EXISTING（从 .rqs 导入）|\n| 状态 | APPLIED \u002F FAILED TO APPLY |\n| 生成阶段 | opt_design \u002F place_design \u002F phys_opt_design \u002F route_design |\n| 适用阶段 | 建议应在哪里应用 |\n| 自动 | Yes（自动应用）\u002F No（需要手动操作）|\n\n### 建议类别\nClocking、Congestion、Utilization、Timing、Netlist、XDC、Strategy\n\n## 设计分析解释（report_design_analysis）\n\n### 时序路径特性 — 五个类别\n| 类别 | 字段 |\n|------|------|\n| Timing | Path Type, Requirement, Slack, Timing Exception |\n| Logic | Start\u002FEnd Pin Primitives, Pins, Logic Levels, Routes |\n| Physical | Arch Boundary Crossings (IO\u002FRAM\u002FDSP\u002FNOC), Pblock restrictions, Bounding Box, Net Fanout\u002FDetour |\n| Property | Combined LUT pairs, MARK_DEBUG, DONT_TOUCH, Fixed constraints |\n| DFX | DFX Path Type, Boundary Nets, Boundary Fanout |\n\n### 复杂度（Rent 指数）解释\n| Rent 指数 | 复杂度 | 操作 |\n|------------|--------|------|\n| \u003C 0.65 | 低到正常 | 无需操作 |\n| 0.65 - 0.85 | 高 | 审查层次结构，考虑布局规划 |\n| > 0.85 | 非常高 | 重新设计层次结构，减少连接 |\n\n**平均扇出：** \u003C 4 正常，4-5 布局困难，> 5 实现失败风险。\n\n### 拥塞级别解释\n| 级别 | 影响 | 操作 |\n|------|------|------|\n| 3-4 | 轻微 | 通常可接受，除非时序预算紧张 |\n| 5+ | 显著 QoR 影响 | 应用拥塞缓解策略 |\n\n## 时序收敛决策树\n\n### Setup 违规解决\n```\n检测到 Setup 违规\n   ├─ 检查逻辑层级（report_design_analysis）\n   │   └─ 高逻辑层级 → 流水线寄存器 \u002F 重定时（vivado-synth: -global_retiming）\n   ├─ 检查扇出（report_design_analysis）\n   │   └─ 高扇出 → MAX_FANOUT 属性 \u002F phys_opt 复制（vivado-impl）\n   ├─ 检查物理分布（report_design_analysis -congestion）\n   │   └─ 大边界框 → Pblock 布局规划（vivado-constraints）\n   ├─ 检查时钟 Skew\n   │   └─ 负 skew → 审查时钟树，BUFG 布局\n   └─ 检查时序异常\n       └─ 缺失\u002F错误约束 → 在 XDC 中修复（vivado-constraints）\n```\n\n### Hold 违规解决\n```\n检测到 Hold 违规\n   ├─ 检查 fast-corner 延迟\n   │   └─ 非常短的数据路径 → 添加延迟单元（phys_opt_design hold fix）\n   ├─ 检查时钟 Skew\n   │   └─ 大正 skew → 审查时钟树平衡\n   └─ 检查跨 SLR 路径（SSI 器件）\n       └─ SLR 交叉 → SLR 感知布局（vivado-impl）\n```\n\n### 拥塞缓解\n```\n拥塞级别 ≥ 5\n   ├─ 检查利用率（report_utilization）\n   │   └─ > 80% LUT → 减小设计尺寸或使用面积优化综合\n   ├─ 检查高扇出网络\n   │   └─ 复制驱动器（phys_opt_design 扇出优化）\n   ├─ 尝试拥塞聚焦策略\n   │   └─ vivado-impl: Congestion_* 策略\n   └─ 布局规划\n       └─ 在器件上分散逻辑（Pblocks, vivado-constraints）\n```\n\n## 消息严重级别\n\n| 严重性 | 含义 | 需要操作 |\n|--------|------|----------|\n| Status | 常规处理反馈 | 无 |\n| Info | 过程\u002F设计反馈 | 无 |\n| Warning | 约束未按预期应用，可能导致次优结果 | 审查 |\n| Critical Warning | 输入\u002F约束不符合最佳实践，通常导致错误 | 建议修复 |\n| Error | 停止设计流程的问题 | 必须修复 |\n\n**提示：** 提升警告严重性：`set_msg_config -id \"Common 17-81\" -new_severity \"CRITICAL WARNING\"`\n\n## 设计检查豁免系统\n\n### 何时豁免\n- 具有外部同步的已知安全 CDC 交叉\n- 不适用于您的设计的 DRC 检查\n- 被设计意图覆盖的方法学检查\n\n### 豁免通配符\n| 关键字 | 匹配 |\n|--------|------|\n| `*CELL` | 任何单元 |\n| `*NET` | 任何网络 |\n| `*PIN` | 任何引脚 |\n| `*PORT` | 任何端口 |\n| `*CLOCK` | 任何时钟 |\n| `*` | 任何字符串 |\n\n豁免自动保存在检查点中。使用 `write_waivers` 导出，使用 `read_xdc` 或 `source` 导入。\n\n**无法删除 AMD IP 豁免。**\n\n## 综合分析与收敛技术\n\n### RTL 优化：整数范围约束\n明确定义信号范围以减少逻辑深度：\n```verilog\n\u002F\u002F 之前：32 位计数器，深度比较器逻辑\nreg [31:0] counter;\n\u002F\u002F 之后：范围约束，更小比较器\nreg [9:0] counter;  \u002F\u002F 如果最大值 \u003C 1024\n```\n\n### 深度内存分解\n| 属性 | 目的 | 效果 |\n|------|------|------|\n| RAM_DECOMP | 控制内存分解策略 | 功耗 vs 面积权衡 |\n| CASCADE_HEIGHT | 精细级联深度控制 | 限制 BRAM 级联链深度 |\n\n### RAMB 利用率（非 2 的幂深度）\n当内存深度不是 2 的幂时，综合可能过度分配 BRAM。使用地址解码器手动分区以获得最佳利用率。检查 `report_utilization` 和综合日志以了解内存映射。\n\n### RAMB 输出寄存器推断\nBRAM 输出触发器之前的多个逻辑层级阻止 DOA 寄存器推断 → 时序恶化。重构 RTL 以允许 BRAM 输出寄存器使用（参见 vivado-impl examples\u002Fug906\u002F 的前后对比）。\n\n## 可配置报告策略\n\n| 策略 | 阶段 | 焦点 |\n|------|------|------|\n| Vivado 综合默认报告 | 综合 | 仅利用率 |\n| Vivado 实现默认报告 | 实现 | 标准报告 |\n| UltraFast 方法学报告 | 实现 | 方法学符合性 |\n| Performance Explore 报告 | 实现 | 时序探索 |\n| 时序收敛报告 | 实现 | 详细时序分析 |\n| 无报告 | 两者 | 跳过所有报告 |","# Vivado 设计分析与时序收敛指南\n\n基于 UG906（v2025.2）。此技能帮助解释分析报告并做出时序收敛决策。完整命令语法请参阅 REFERENCE.md。如需执行 TCL，请使用 vivado-tcl。如需修改约束，请使用 vivado-constraints。如需实现策略，请使用 vivado-impl。\n\n## 时序路径基础\n\n四种常见路径类型：\n```\n1. 输入端口 → 寄存器       （受 set_input_delay 约束）\n2. 寄存器 → 寄存器         （受时钟周期约束）\n3. 寄存器 → 输出端口      （受 set_output_delay 约束）\n4. 输入端口 → 输出端口    （组合路径，set_max_delay）\n```\n\n路径结构（三个部分）：\n```\n源时钟路径 → 数据路径 → 目标时钟路径\n（时钟源      （launch 引脚   （时钟源\n 到 launch     到 capture      到 capture\n 单元）        单元输入）       单元）\n```\n\nSlack 公式：\n- **最大延迟（Setup\u002FRecovery）：** `slack = data_required_time - data_arrival_time`\n- **最小延迟（Hold\u002FRemoval）：** `slack = data_arrival_time - data_required_time`\n\n## 最大\u002F最小延迟分析工艺角选择\n\n| 分析类型 | 源时钟 | 数据路径 | 目标时钟 |\n|-----------|--------|----------|----------|\n| Setup\u002FRecovery（最大延迟）| Slow_max | Slow_max | Slow_min |\n| Setup\u002FRecovery（最大延迟）| Fast_max | Fast_max | Fast_min |\n| Hold\u002FRemoval（最小延迟）| Slow_min | Slow_min | Slow_max |\n| Hold\u002FRemoval（最小延迟）| Fast_min | Fast_min | Fast_max |\n\n**关键规则：** 来自不同工艺角的延迟在 slack 计算中**绝不混合**在同一条路径上。\n\n## 报告选择指南\n\n| 目标 | 命令 | 何时使用 |\n|------|------|----------|\n| 快速时序签发 | `report_timing_summary` | 实现后，比特流前必需 |\n| 分析特定路径 | `report_timing -from\u002F-to\u002F-through` | 调试特定失败路径 |\n| 整体 QoR 评分（1-5）| `report_qor_assessment` | 布线后，评估收敛可能性 |\n| 自动优化提示 | `report_qor_suggestions` | 时序收敛卡住时 |\n| 路径特性 | `report_design_analysis` | 深入分析逻辑层级、扇出、物理分布 |\n| 方法学符合性 | `report_methodology` | 流程早期捕获方法学违规 |\n| 资源使用 | `report_utilization` | 综合或实现后 |\n| CDC 检查 | `report_cdc` | 综合后，验证时钟域交叉 |\n| 拥塞分析 | `report_design_analysis -congestion` | 布局后，如果时序恶化 |\n| 设计规则检查 | `report_drc` | 比特流生成前 |\n| 总线 skew | `report_bus_skew` | 如果存在 set_bus_skew 约束（不在 report_timing_summary 中）|\n\n## 时序报告头字段\n\n| 字段 | 含义 |\n|------|------|\n| Slack | 正值 = 满足时序。负值 = 违规 |\n| Source | 起点单元 + launch 时钟（边沿、名称、周期）|\n| Destination | 终点单元 + capture 时钟（边沿、名称、周期）|\n| Path Group | 包含终点的时钟组（异步引脚 → async_default）|\n| Path Type | Max（setup\u002Frecovery）或 Min（hold\u002Fremoval）；工艺角（Slow\u002FFast）|\n| Requirement | 时钟周期（相同时钟）或最小正增量（不同时钟）|\n| Data Path Delay | 逻辑部分的总延迟 |\n| Logic Levels | 数据路径中每种原语类型的计数 |\n| Clock Path Skew | 目标 - 源插入延迟 + CPR |\n| CPR | Clock Pessimism Removal — 共享时钟电路校正 |\n| Clock Uncertainty | TSJ + TIJ + DJ + PE + UU（见下方）|\n\n### 时钟不确定性组成部分\n| 组成部分 | 来源 |\n|----------|------|\n| TSJ（总系统抖动）| 两个时钟上的组合系统抖动 |\n| TIJ（总输入抖动）| 来自 set_input_jitter 约束 |\n| DJ（离散抖动）| 硬件原语（MMCM\u002FPLL）|\n| PE（相位误差）| 时钟信号之间的相位变化 |\n| UU（用户不确定性）| 来自 set_clock_uncertainty 约束 |\n\n### 路径详情中的延迟类型\n| 值 | 含义 |\n|-----|------|\n| Unplaced | 单元未布局，延迟已估计 |\n| Estimated | 单元已布局但未布线 |\n| Routed | 最终布线延迟 |\n\n## 时钟相移模式（器件默认值）\n\n| 器件系列 | 默认模式 | 行为 |\n|----------|----------|------|\n| 7 Series | WAVEFORM | 修改时钟波形边沿 |\n| UltraScale | WAVEFORM | 修改时钟波形边沿 |\n| UltraScale+ | LATENCY | 建模为 MMCM\u002FPLL 插入延迟 |\n| Versal | LATENCY | 建模为 MMCM\u002FPLL 插入延迟 |\n\n**警告：** 将 7 Series\u002FUltraScale 设计迁移到 UltraScale+ 会改变相移建模。审查并删除用于相移的遗留多周期路径约束。\n\n## QoR 评估解释（report_qor_assessment）\n\n### 分数含义\n| 分数 | 解释 | 操作 |\n|------|------|------|\n| 1 | 设计可能无法完成实现 | 需要重大重新设计 |\n| 2 | 将完成但无法满足时序 | 需要显著优化 |\n| 3 | 可能无法满足时序 | 需要针对性优化 |\n| 4 | 可能满足时序 | 轻微调整可能就够 |\n| 5 | 将满足时序 | 继续生成比特流 |\n\n### 五个评估类别\n| 类别 | 检查内容 |\n|------|----------|\n| Utilization | 器件、SLR、Pblock 级别的资源使用 |\n| Netlist | 逻辑结构、DONT_TOUCH 属性、高扇出网络 |\n| Clocking | setup 和 hold 路径上的时钟 skew |\n| Congestion | 导致布线拥塞的网表结构 |\n| Timing | 每时钟组的 WNS\u002FTNS\u002FWHS\u002FTHS，网络\u002FLUT 预算 |\n\n每个显示 **OK** 或 **REVIEW** 状态。带星号（*）的项目不直接影响分数，但影响收敛。\n\n### ML 策略可用性\n满足**所有**条件时可用：\n- opt_design 使用 Explore 或 Default 指令运行\n- phys_opt_design 已启用\n- 设计完全布线\n- UltraScale 或 UltraScale+ 器件系列\n\n### 自动终止\n设置 `MIN_RQA_SCORE` 属性（1-5）以自动终止低于阈值的运行。\n\n## QoR 建议工作流程\n\n```\nreport_qor_suggestions          ← 生成建议\n        ↓\nwrite_qor_suggestions file.rqs  ← 导出到文件\n        ↓\nread_qor_suggestions file.rqs   ← 在下次运行中导入\n        ↓\nSuggestions auto-apply          ← 如果 AUTOMATIC=Yes\n```\n\n### 建议分类\n| 维度 | 值 |\n|------|-----|\n| 来源 | GENERATED（当前运行）\u002F EXISTING（从 .rqs 导入）|\n| 状态 | APPLIED \u002F FAILED TO APPLY |\n| 生成阶段 | opt_design \u002F place_design \u002F phys_opt_design \u002F route_design |\n| 适用阶段 | 建议应在哪里应用 |\n| 自动 | Yes（自动应用）\u002F No（需要手动操作）|\n\n### 建议类别\nClocking、Congestion、Utilization、Timing、Netlist、XDC、Strategy\n\n## 设计分析解释（report_design_analysis）\n\n### 时序路径特性 — 五个类别\n| 类别 | 字段 |\n|------|------|\n| Timing | Path Type, Requirement, Slack, Timing Exception |\n| Logic | Start\u002FEnd Pin Primitives, Pins, Logic Levels, Routes |\n| Physical | Arch Boundary Crossings (IO\u002FRAM\u002FDSP\u002FNOC), Pblock restrictions, Bounding Box, Net Fanout\u002FDetour |\n| Property | Combined LUT pairs, MARK_DEBUG, DONT_TOUCH, Fixed constraints |\n| DFX | DFX Path Type, Boundary Nets, Boundary Fanout |\n\n### 复杂度（Rent 指数）解释\n| Rent 指数 | 复杂度 | 操作 |\n|------------|--------|------|\n| \u003C 0.65 | 低到正常 | 无需操作 |\n| 0.65 - 0.85 | 高 | 审查层次结构，考虑布局规划 |\n| > 0.85 | 非常高 | 重新设计层次结构，减少连接 |\n\n**平均扇出：** \u003C 4 正常，4-5 布局困难，> 5 实现失败风险。\n\n### 拥塞级别解释\n| 级别 | 影响 | 操作 |\n|------|------|------|\n| 3-4 | 轻微 | 通常可接受，除非时序预算紧张 |\n| 5+ | 显著 QoR 影响 | 应用拥塞缓解策略 |\n\n## 时序收敛决策树\n\n### Setup 违规解决\n```\n检测到 Setup 违规\n   ├─ 检查逻辑层级（report_design_analysis）\n   │   └─ 高逻辑层级 → 流水线寄存器 \u002F 重定时（vivado-synth: -global_retiming）\n   ├─ 检查扇出（report_design_analysis）\n   │   └─ 高扇出 → MAX_FANOUT 属性 \u002F phys_opt 复制（vivado-impl）\n   ├─ 检查物理分布（report_design_analysis -congestion）\n   │   └─ 大边界框 → Pblock 布局规划（vivado-constraints）\n   ├─ 检查时钟 Skew\n   │   └─ 负 skew → 审查时钟树，BUFG 布局\n   └─ 检查时序异常\n       └─ 缺失\u002F错误约束 → 在 XDC 中修复（vivado-constraints）\n```\n\n### Hold 违规解决\n```\n检测到 Hold 违规\n   ├─ 检查 fast-corner 延迟\n   │   └─ 非常短的数据路径 → 添加延迟单元（phys_opt_design hold fix）\n   ├─ 检查时钟 Skew\n   │   └─ 大正 skew → 审查时钟树平衡\n   └─ 检查跨 SLR 路径（SSI 器件）\n       └─ SLR 交叉 → SLR 感知布局（vivado-impl）\n```\n\n### 拥塞缓解\n```\n拥塞级别 ≥ 5\n   ├─ 检查利用率（report_utilization）\n   │   └─ > 80% LUT → 减小设计尺寸或使用面积优化综合\n   ├─ 检查高扇出网络\n   │   └─ 复制驱动器（phys_opt_design 扇出优化）\n   ├─ 尝试拥塞聚焦策略\n   │   └─ vivado-impl: Congestion_* 策略\n   └─ 布局规划\n       └─ 在器件上分散逻辑（Pblocks, vivado-constraints）\n```\n\n## 消息严重级别\n\n| 严重性 | 含义 | 需要操作 |\n|--------|------|----------|\n| Status | 常规处理反馈 | 无 |\n| Info | 过程\u002F设计反馈 | 无 |\n| Warning | 约束未按预期应用，可能导致次优结果 | 审查 |\n| Critical Warning | 输入\u002F约束不符合最佳实践，通常导致错误 | 建议修复 |\n| Error | 停止设计流程的问题 | 必须修复 |\n\n**提示：** 提升警告严重性：`set_msg_config -id \"Common 17-81\" -new_severity \"CRITICAL WARNING\"`\n\n## 设计检查豁免系统\n\n### 何时豁免\n- 具有外部同步的已知安全 CDC 交叉\n- 不适用于您的设计的 DRC 检查\n- 被设计意图覆盖的方法学检查\n\n### 豁免通配符\n| 关键字 | 匹配 |\n|--------|------|\n| `*CELL` | 任何单元 |\n| `*NET` | 任何网络 |\n| `*PIN` | 任何引脚 |\n| `*PORT` | 任何端口 |\n| `*CLOCK` | 任何时钟 |\n| `*` | 任何字符串 |\n\n豁免自动保存在检查点中。使用 `write_waivers` 导出，使用 `read_xdc` 或 `source` 导入。\n\n**无法删除 AMD IP 豁免。**\n\n## 综合分析与收敛技术\n\n### RTL 优化：整数范围约束\n明确定义信号范围以减少逻辑深度：\n```verilog\n\u002F\u002F 之前：32 位计数器，深度比较器逻辑\nreg [31:0] counter;\n\u002F\u002F 之后：范围约束，更小比较器\nreg [9:0] counter;  \u002F\u002F 如果最大值 \u003C 1024\n```\n\n### 深度内存分解\n| 属性 | 目的 | 效果 |\n|------|------|------|\n| RAM_DECOMP | 控制内存分解策略 | 功耗 vs 面积权衡 |\n| CASCADE_HEIGHT | 精细级联深度控制 | 限制 BRAM 级联链深度 |\n\n### RAMB 利用率（非 2 的幂深度）\n当内存深度不是 2 的幂时，综合可能过度分配 BRAM。使用地址解码器手动分区以获得最佳利用率。检查 `report_utilization` 和综合日志以了解内存映射。\n\n### RAMB 输出寄存器推断\nBRAM 输出触发器之前的多个逻辑层级阻止 DOA 寄存器推断 → 时序恶化。重构 RTL 以允许 BRAM 输出寄存器使用（参见 vivado-impl examples\u002Fug906\u002F 的前后对比）。\n\n## 可配置报告策略\n\n| 策略 | 阶段 | 焦点 |\n|------|------|------|\n| Vivado 综合默认报告 | 综合 | 仅利用率 |\n| Vivado 实现默认报告 | 实现 | 标准报告 |\n| UltraFast 方法学报告 | 实现 | 方法学符合性 |\n| Performance Explore 报告 | 实现 | 时序探索 |\n| 时序收敛报告 | 实现 | 详细时序分析 |\n| 无报告 | 两者 | 跳过所有报告 |",{"name":5,"description":7},"main","2713ffd8a8fb17d50ccd55714af0d8c5829e3e2f",0,"https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills","https:\u002F\u002Fgithub.com\u002Fra9fael","https:\u002F\u002Fgithub.com\u002Fra9fei\u002Fblog\u002Fissues","Coincidence-Oriented Programming","2026-05-07 01:52:06",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add ra9fael\u002Fxilinx-skills --skill vivado-analysis",{"tool":63,"command":64},"bunx","bunx skills add ra9fael\u002Fxilinx-skills --skill vivado-analysis",{"tool":66,"command":67},"pnpm","pnpm dlx skills add ra9fael\u002Fxilinx-skills --skill vivado-analysis","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-analysis\u002FSKILL.md",true,[71],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"REFERENCE.md","REFERENCE","参考文档",17966,"https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-analysis\u002FREFERENCE.md",[78,88,103,118,143,158],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":44},"01M71Y65DRAP7ZKNWFY94BHB9D","xilinx-docs","当用户需要查找xilinx官方文档时使用该技能","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fxilinx-docs\u002FSKILL.md",[],[85,86,87],"xilinx docs","docs","文档",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":95,"publishedAt":44},"01M71Y5K7NEZF32CFVNVHV0YXV","vivado-tcl","当用户想要生成、编写或执行 Vivado\u002FVitis TCL 脚本用于 FPGA 设计流程时使用此技能。包括创建项目、运行综合\u002F实现、编程设备、使用 IP Integrator 块设计、插入调试核、管理约束、仿真以及任何 Vivado 自动化任务。当用户提及 Vivado、Vitis、FPGA、硬件设计的 TCL 脚本、比特流生成、XDC 约束、ILA\u002FVIO 调试或任何 Xilinx\u002FAMD FPGA 工具链任务时触发。此技能生成并执行 TCL——它不分析 Vivado 输出或报告。对于调试策略和调试核配置决策使用 vivado-debug，对于时序分析使用 vivado-analysis。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-tcl\u002FSKILL.md",[94],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[96,28,35,97,25,98,99,100,101,102,27],"vivado tcl","debug","生成","ip","自动化","FPGA","工具",{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":110,"publishedAt":44},"01M71Y55MVEMB29C0YK8CX5F55","vivado-synth","当用户需要 Vivado 综合策略选择、综合属性配置、synth_design 选项调优、资源推断控制（RAM\u002FDSP\u002FSRL\u002FBRAM）、层次结构优化（flatten_hierarchy、KEEP_HIERARCHY）、OOC（离屏）综合、增量综合、RTL linting、块级综合（BLOCK_SYNTH）或任何综合优化决策时使用此技能。当用户提及综合策略、综合指令、综合属性、资源映射控制、FSM 编码、重定时或询问如何优化综合结果以获得更好的面积\u002F时序\u002F功耗时触发。此技能提供决策知识——如需执行 TCL 命令，请使用 vivado-tcl 技能。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-synth\u002FSKILL.md",[109],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[111,35,112,113,114,115,116,28,117],"vivado synth","fsm","定时","linting","keep","block","hierarchy",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":44},"01M71Y4GPRVZP5C8VD1D7METEW","vivado-sim","当用户需要 Vivado 仿真策略、流程选择和调试方面的帮助时使用此技能。这包括行为仿真（RTL 功能验证）、综合后仿真（网表功能验证）、实现后时序仿真（SDF 反标注，时序验证）、Vivado 仿真器 xsim 使用（xvlog\u002Fxvhdl\u002Fxelab\u002Fxsim 三步流程，launch_simulation 工程模式）、第三方仿真器集成（Questa\u002FModelSim\u002FVCS\u002FXcelium\u002FRiviera\u002FActiveHDL，compile_simlib，export_simulation）、SAIF\u002FVCD 功耗仿真（open_saif\u002Flog_saif，open_vcd\u002Flog_vcd，read_saif + report_power）、仿真网表生成（write_verilog -mode funcsim\u002Ftimesim，write_sdf）、xsim 调试命令（add_force、add_wave、log_wave、add_bp、step、run、restart、get_objects、get_value）、仿真属性和设置、glbl.v 使用，或选择正确仿真方法进行验证或功耗分析的任何问题。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-sim\u002FSKILL.md",[],[125,126,127,98,128,129,40,130,131,132,133,134,135,136,137,138,139,140,141,142],"vivado sim","sim","vcs","launch","run","compile","simulation","open","read","write","export","power","objects","get","add","Verilog","mode","value",{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":150,"publishedAt":44},"01M71Y45TYXDCYV3R9ZNN546VG","vivado-impl","当用户需要 Vivado 实现策略选择和优化方面的帮助时使用此技能。这包括 opt_design（逻辑优化指令和选项）、place_design（布局指令、拥塞分析、PSIP 物理综合）、phys_opt_design（物理优化 - 扇出\u002F布局\u002F布线\u002FSLR 交叉\u002F寄存器优化、hold 修复）、route_design（布线指令、拥塞解决、预布线关键网络）、power_opt_design（时钟门控、BRAM 功耗优化）、增量实现（read_checkpoint -incremental、auto_incremental、reuse 分析）、ECO 流程、实现运行策略（Performance\u002FCongestion\u002FArea 策略）或选择实现指令或解决实现过程中时序\u002F拥塞问题的任何问题。此技能为实现阶段提供决策知识——如需执行 TCL 命令使用 vivado-tcl，如需综合使用 vivado-synth，如需约束使用 vivado-constraints，如需时序报告解释和分析使用 vivado-analysis。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-impl\u002FSKILL.md",[149],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[151,33,152,25,37,153,35,136,154,28,27,155,156,157,133],"vivado impl","checkpoint","performance","reuse","opt","auto","route",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":164,"publishedAt":44},"01M71Y3M2HSW8R1G9SGZECQNGX","vivado-git","当用户需要实现Vivado工程GIT化的时候使用该技能。","https:\u002F\u002Fgithub.com\u002Fra9fael\u002Fxilinx-skills\u002Fblob\u002Fmain\u002Fvivado-git\u002FSKILL.md",[],[165,166],"vivado git","git"]