Agent设计

Name: Agent设计
Author: QingquanYao

其他社区

作者仓库星标 287
作者更新于实时读取
作者仓库 xilinx-skill

流狐档案事实层信息：领域、Agent、信任分、运行环境、权限与网络

领域: 通用
兼容 Agent: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
信任分: 88 / 100 · 社区维护
作者 / 版本 / 许可: @QingquanYao · 未声明 license
Token 消耗评级: 低消耗
接入复杂程度: 需简单配置
是否需要外部 API Key: 不需要
兼容的系统: Linux
底层运行要求: Python
文件与系统权限: 只读
允许写入 / 修改
Shell 执行
网络行为: 仅限本地
安装命令数: 26 条

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 xilinx-suite.preview

---
name: xilinx-suite
description: > 本 skill 帮助你完成 Xilinx（AMD）完整设计流程，生成可直接运行的脚本和文件。 [可选] Vitis HLS → Vivado → Vitis Unified / PetaL…
category: 通用
runtime: Python
---

# xilinx-suite 输出预览

## PART A: 任务判断
- 适用问题：通用任务拆解、检查和交付。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“第一步：判断工具和流程 / 完整设计流程总览 / 工具路由表”读取原文规则，不把推断写成作者承诺。

## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于通用任务拆解、检查和交付，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“第一步：判断工具和流程 / 完整设计流程总览 / 工具路由表”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、执行终端命令、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。

## Running Rules
- 读取文件、写入/修改文件、执行终端命令；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。

SKILL.md SKILL.md

---
name: xilinx-suite
description: > 本 skill 帮助你完成 Xilinx（AMD）完整设计流程，生成可直接运行的脚本和文件。 [可选] Vitis HLS → Vivado → Vitis Unified / PetaL…
category: 通用
source: QingquanYao/xilinx-skill
---

# xilinx-suite

## 什么时候使用
- Xilinx 全工具链 Skill 本 skill 帮助你完成 Xilinx（AMD）完整设计流程，生成可直接运行的脚本和文件 适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agen…
- 面向通用任务拆解、检查和交付，优先处理能明确输入、步骤和验收标准的工作。

## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。

## 执行规则
- 围绕「第一步：判断工具和流程 / 完整设计流程总览 / 工具路由表」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。

## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。

证据边界与执行链路

作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。

skill "xilinx-suite" {
  输入层     -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
  上下文层   -> 第一步：判断工具和流程 / 完整设计流程总览 / 工具路由表
  规则层     -> SKILL.md 触发条件 / 执行顺序 / 输出格式
  运行层     -> Python | 读取文件、写入/修改文件、执行终端命令 | 主要在本地完成
  安全层     -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
  输出层     -> 可复制结果 + 检查清单 + 下一步迭代
}

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

先判断是否适合

核心用途：Xilinx 全工具链 Skill 本 skill 帮助你完成 Xilinx（AMD）完整设计流程，生成可直接运行的脚本和文件适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。把任…
适用任务：更适合通用任务拆解、检查、交付和复盘，尤其是输入、步骤、验收口径可以反复复用的场景。
不宜硬套：如果任务只有一次性问答、来源材料很少，或需要作者没有说明的命令和外部服务，应先降级为普通对话。

作者设计意图

触发依据：使用时机、上下文收集、输出格式和失败处理共同决定它是否适合当前任务。
来源边界：作者原文负责事实，仓库文件负责命令和文件证据；Fluxly 只补充用途、限制和使用判断。

作者的方法与取舍

执行主线：任务围绕「第一步：判断工具和流程 / 完整设计流程总览 / 工具路由表」组织，把触发条件、必要上下文、执行规则和交付标准连成一条可复核的链路。
设计重点：重点不在重复教程，而在解释作者为什么规定这些步骤、哪些条件不可省略，以及结果偏离时应回到哪一层检查。
使用判断：先确认任务与原文边界一致，再决定是否启用；来源没有说明的命令、平台和依赖保持未知，不由 Fluxly 补写。

边界和复核

依赖条件：通常不需要额外 API Key，适合先用小任务验证触发是否稳定。
权限提醒：会涉及 read / write / shell-exec 权限，执行前要说明可读写范围、命令边界和回退方式。
质量标准：结果应包含明确产物、必要证据和下一步动作；如果只是泛泛解释，需要补充输入和验收条件后重跑。

Xilinx 全工具链 Skill

本 skill 帮助你完成 Xilinx（AMD）完整设计流程，生成可直接运行的脚本和文件。

第一步：判断工具和流程

收到任何 Xilinx 相关请求时，首先确定用户处于哪个阶段，然后加载对应参考文件。

完整设计流程总览

[可选] Vitis HLS        →    Vivado          →    Vitis Unified / PetaLinux
C/C++ 算法 → IP 核        硬件平台设计           软件开发 / Linux 系统
  hls_guide.md              vivado_guide.md      vitis_unified_guide.md
                          + mpsoc_ps_config.md    petalinux_guide.md
                          + xdc_constraints.md

工具路由表

用户描述的任务	需要的工具	加载的参考文件
C/C++ 算法加速、pragma 优化、生成 IP	Vitis HLS	`../../references/hls_guide.md`
创建工程、Block Design、配置 PS/IP、XDC、比特流	Vivado	`../../references/vivado_guide.md` + 按需加载
PS 详细配置（DDR、MIO、时钟）	Vivado	`../../references/mpsoc_ps_config.md`
IO 引脚约束、时序约束	Vivado	`../../references/xdc_constraints.md`
JESD204B→C 迁移、高速串行 ADC/DAC 接口	Vivado	`../../references/jesd204b_to_c_migration.md`
嵌入式软件、裸机程序、RTOS、platform/domain	Vitis Unified	`../../references/vitis_unified_guide.md`
嵌入式 Linux、kernel 配置、rootfs、启动镜像	PetaLinux	`../../references/petalinux_guide.md`
PetaLinux 上跑 gRPC C++ 服务端 / Python 客户端、ZMQ→gRPC 迁移、udmabuf+AXI DMA 暴露 RPC	PetaLinux	`../../references/grpc_on_petalinux.md`
查找官方文档编号、UG/PG/DS 编号查询、文档用途说明	通用	`../../references/official-docs/index.md`

第二步：需求确认（必须先做）

在生成任何脚本之前，确认以下信息（没有明确答案的项主动提问）：

所有工程必须确认

目标器件/开发板：完整 part number 或板型（由用户提供）
Vivado/Vitis 版本（如 2023.2、2024.1）
设计目标：这个工程要实现什么功能？

HLS 工程额外确认

算法描述：C/C++ 函数的输入输出和功能
性能目标：目标时钟频率、延迟、吞吐量要求
接口类型：AXI4-Lite（控制）、AXI4-Stream（数据）、AXI4-Master（存储器访问）

Vivado 工程额外确认（MPSoC 类）

PS 配置：DDR 类型和容量、MIO 外设（UART、Ethernet、USB、SD 等）
PL IP 需求：需要哪些 AXI IP，是否有自定义 HDL 模块
时钟要求：PL 时钟频率（pl0_ref_clk）

Vitis 工程额外确认

运行环境：裸机（standalone）、FreeRTOS、还是 Linux 用户态
处理器核：A53、R5、MicroBlaze
XSA 文件路径：从 Vivado 导出的硬件描述文件

PetaLinux 工程额外确认

BSP 或 XSA：是否有厂商 BSP？或者直接使用 Vivado 导出的 XSA？
自定义需求：是否需要添加驱动/应用程序/设备树覆盖

第三步：按工具流程执行

确认需求后，加载对应参考文件并按步骤生成脚本。

加载参考文件的时机

始终在生成脚本之前先读取参考文件，不要凭记忆生成 Tcl/XSCT/命令，因为不同 Vivado/Vitis 版本的 API 有差异。

Vivado 工程  → 先读 ../../references/vivado_guide.md
              → 如有 PS  → 再读 ../../references/mpsoc_ps_config.md
              → 如有 IO  → 再读 ../../references/xdc_constraints.md
              → 如有 JESD204 → 再读 ../../references/jesd204b_to_c_migration.md

HLS 工程     → 先读 ../../references/hls_guide.md

Vitis 工程   → 先读 ../../references/vitis_unified_guide.md

PetaLinux    → 先读 ../../references/petalinux_guide.md
              → 如需 gRPC（C++ server / Python client、ZMQ 迁移）→ 再读 ../../references/grpc_on_petalinux.md

输出规范

每次生成脚本时，必须提供：

完整可运行的脚本文件（.tcl、.xdc、.py、shell 脚本等）
运行命令：如何在命令行或 GUI 中执行
预期输出：脚本运行成功后会产生哪些文件
下一步提示：完成本阶段后应该做什么

文件组织规范

project_root/
├── 01_hls/                  ← Vitis HLS 工程（可选）
│   ├── hls_create.tcl
│   └── src/*.cpp / *.h
│
├── 02_vivado/               ← Vivado 硬件工程
│   ├── create_project.tcl
│   ├── create_bd.tcl
│   ├── add_sources.tcl
│   ├── constraints/design.xdc
│   ├── build.tcl
│   └── output/
│       ├── design.bit
│       └── design_fixed.xsa
│
├── 03_vitis/                ← Vitis 软件工程
│   ├── create_platform.tcl  (XSCT 脚本)
│   ├── create_app.tcl
│   └── src/*.c / *.h
│
└── 04_petalinux/            ← PetaLinux（可选）
    ├── build.sh
    └── config/

跨工具数据流

Vitis HLS                    Vivado                    Vitis / PetaLinux
─────────────────────────────────────────────────────────────────────────
hls_ip/                  →   IP Catalog
  solution/impl/ip       →   (add_files / ip_repo)
                             ↓
                         project.xsa         →        平台/BSP/Linux BSP
                         design.bit          →        boot/BOOT.BIN

常见错误和注意事项

版本兼容性：Vivado 2022.x+ 的 write_hw_platform 替代了旧版 write_sysdef；Vitis Unified 2022.x+ 的 Tcl API 与 Classic 版本有重大差异
XSA 类型：write_hw_platform（综合前，可编辑）vs write_hw_platform -fixed -include_bit（实现后，固定含比特流）
HLS IP 导入 Vivado：需要在 Vivado 工程中添加 HLS IP 仓库路径，并刷新 IP 目录
PetaLinux 版本匹配：PetaLinux 版本必须与 Vivado 版本一致（例如都用 2023.2）
器件系列判断：zu 开头 → MPSoC；vu/ku/xc7 → 纯 FPGA；xcvc → Versal

参考文件

../../references/vivado_guide.md：Vivado 工程创建、Block Design、综合实现、报告分析
../../references/mpsoc_ps_config.md：Zynq UltraScale+ PS 详细配置（DDR、MIO、时钟参数）
../../references/xdc_constraints.md：XDC 约束完整指南（时序、IO、例外约束）
../../references/hls_guide.md：Vitis HLS 工程流程（C/C++ → IP）
../../references/vitis_unified_guide.md：Vitis Unified IDE 2022.x+ 工程流程
../../references/petalinux_guide.md：PetaLinux 系统构建流程
../../references/jesd204b_to_c_migration.md：JESD204B→C IP 迁移指南（端口映射、数据位宽、AXI 寄存器、常见陷阱）
../../references/grpc_on_petalinux.md：PetaLinux + gRPC 端到端部署指南（rootfs 配置、libutf8_range 软链、VM 预生成 .pb.cc + 板上 g++、udmabuf/AXI DMA RPC 暴露、ZMQ→gRPC 迁移、常见 RCU stall 等陷阱）
../../references/official-docs/index.md：Xilinx/AMD 官方文档索引（UG/PG/DS/XAPP 编号、标题、用途、与本仓库参考指南的对应关系）

安装命令

一键复制安装选择包管理器,点击右侧复制,粘贴到终端回车即可

npx skills add QingquanYao/xilinx-skill/plugins/xilinx-suite/skills/xilinx-suite -y

查看通用安装教程

查看 Skill 原文

兼容工具

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

安全审计

88 / 100

社区

未声明 license/许可。
未声明 version。
未限定 allowed-tools，默认拥有全部工具权限。

元信息

来源: github
QingquanYao/xilinx-skill
English

分类与标签

分类其他