文章来源：FPGA入门到精通
本文收获
✅ 分清要装的是三条独立的线，不是一件事
✅ 一段提示词交给它，你只守四道验收
✅ 知道哪几步实测过、哪几步只是照文档抄
✅ 避开更新不生效、双装、技能名对不上这三个坑
上 1 篇说清了 ROSS 是什么。这一篇开始动手。
写法跟传统安装教程不一样。要装的东西其实是三个互相独立的组件，但你不用背安装命令。
Agent AI「装一个 CLI 工具、把它注册进某个客户端」恰好是它最擅长的一类活：环境可探测、结果可验证、写错可回滚。你要做的只有两件，把该准备的准备好，把需求说清楚。
一、安装准备
1.1 先分清要装的是什么
最容易搞混的一件事：「装 ROSS」不是一个动作，是三条独立的线。
官方原文把第一句讲得很直白：The plugin contains skills only. 插件里只有技能，另外两条线永远要单独装。这也是第 1 篇里「技能和 MCP 是两件独立的事」那句话的实际后果。
skills/ 目录下确实有 50 个条目，但只有 49 个含 SKILL.md。判定标准是「目录里有 SKILL.md」，第 50 个是 hls-scripts/，被技能调用的脚本目录，不是技能本身。官方文档写的「50 skills」数的是目录数，两个数都对，口径不同。
二个 server 功能不一样。官方写得很明确：Documentation search is not a tool of the Vivado MCP server. It is served by its own remote MCP server. 一个跑 Tcl，一个查文档，装两个才齐。它是远程 HTTP 服务，不用下载程序，也不要 API key，所以它跟第二行有个关键区别：这一条完全不需要你做人工准备，一条命令就能加。
1.2 插件版本和工具版本是两回事
动手前先把最容易混的一组数字分开，插件的版本号和你机器上 AMD 工具的版本号之间没有任何关系。
三条线各自要什么版本：
两条必须记住。
还有一条软要求。官方对模型档位有要求，原话是 Current GPT-5 Sol–class and Claude Opus 5–class coding models。用明显小一号的模型，技能可能读不全、拆不动大文件。
二、安装提示词
把下面这段整段复制，粘给 Claude Code，或者 Codex、WorkBuddy 等任何 CLI agent。<…> 处换成你自己的路径，别留占位符。
我准备搭建一套 AMD ROSS 开发环境，分四步做（第 4 步默认不装，装之前必须先问我），每一步装完先验证是否成功。
1、安装 Vivado
先搜索当前电脑已安装的 Vivado，把找到的版本号和安装路径全部列出来。
有多个版本时不要替我选，等我指定。
2、安装 ROSS 插件
用 marketplace 方式装：
claude plugin marketplace add Xilinx/ross-ai-assistant
claude plugin install amd-ross-agentic-ai-assistant@amd-ross-agentic-ai-assistant
注册 scope 用 user（默认是 local，必须显式指定）。
3、安装 Vivado MCP Server
程序我已经下载好，在：<你自己填：MCP 二进制的路径>
请把它放到固定目录（别留在下载目录），Linux 上先 chmod +x。
要驱动的 Vivado 入口：<你自己填：Windows 用 vivado.bat，Linux 用 vivado>
注册命令：
claude mcp add vivado-mcp --scope user --transport stdio \
--env VIVADO_PATH=<Vivado 入口路径> -- <二进制路径> --stdio-bridge
4、安装文档检索 MCP（默认不装，装之前先问我）
这是第二个独立的 MCP server，管查 AMD 官方文档（UG／PG／AM／AR 等），
跟第 3 步那个执行 Tcl 的不是一回事，两个各装各的。
它是远程 HTTP 服务：不用下载任何程序，也不需要 API key，一条命令：
claude mcp add --transport http --scope user amd-doc-search \
https://ross.amd.com/mcp/doc-search
但先问我一句：要不要让文档查询走 AMD 云端？
- 要（省事，默认）：执行上面那条命令
- 不要（内网 / 文档敏感）：跳过这条，改用官方本地知识库方案（docs/local-kb/）
注意这一步不只是「方便一点」：skills/ 里有 7 个技能引用了它的工具（vivado_doc_search），
其中 3 个是在 frontmatter 里硬声明依赖（含 vivado-ip-configurator 的 compatibility 字段）。
不装不会报错，这几个技能会静默降级成「靠通用知识」。
所以问我之前，请把「装 / 不装各自的后果」一并讲清楚。
【约束】
- 只装 MCP 二进制，不要装 VSIX 扩展（官方规定二选一）
- 我机器上可能装了多个 Vivado，VIVADO_PATH 必须显式指定到我要的那个，不要靠 PATH 猜
- 第 4 步默认不装，装之前必须先问我，并把「不装会让哪几个技能降级」一并说清
- 不要改动我其它任何 MCP / 插件配置
【每一步装完，请贴原始输出自证】
- 第 1 步：vivado -version（Windows 用 vivado.bat -version）
- 第 2 步：claude plugin details amd-ross-agentic-ai-assistant（应能看到 49 个技能）
- 第 3 步：claude mcp list（应能看到 √ Connected）
- 第 4 步：claude mcp list（应能看到 amd-doc-search 也 Connected）
它会请求执行权限，正常批准即可。
2.1 为什么要件要写得这么详细
因为要件不写清，agent 不会报错，它会给默认值。
2.2 等待安装完成
装完落在 ~/.claude/plugins/：
~/.claude/plugins/
├── cache/<marketplace>/<插件>/<版本>/ ← 插件本体（含 skills/ examples/ docs/）
├── marketplaces/<marketplace>/ ← 仓库克隆
├── known_marketplaces.json ← 已注册的 marketplace
└── installed_plugins.json ← 已装插件 + gitCommitSha
installed_plugins.json 锁了一个 gitCommitSha，安装等于「把某个 commit 的快照拷过去」。
装完打开 ~/.claude.json，mcpServers 里会是两个形态不同的键：
{
"mcpServers": {
"vivado-mcp": { "type": "stdio", "command": "...", "args": ["--stdio-bridge"], "env": { "VIVADO_PATH": "..." } },
"amd-doc-search": { "type": "http", "url": "https://ross.amd.com/mcp/doc-search" }
}
}
一个跑本地进程，一个连远程端点，这就是「两个独立 server」在配置文件里的样子。
三、简单测试验证
AI 会自证一轮，但验收不能只听它说。它说装好了，可能只是文件在位、服务根本没连上。下面四条各做一次，总共几分钟。
3.1 技能装上了吗
claude plugin details amd-ross-agentic-ai-assistant
过线标准是列出 49 个技能名，外加 3 个 agent。顺便注意输出里的 MCP servers (0)，这印证了 1.1 那句「插件里只有技能」。
技能分五个族：
3.2 MCP 连上了吗
claude mcp list
实测输出是这样：
Checking MCP server health…
vivado-mcp: <二进制路径> --stdio-bridge - √ Connected
关键在 √ Connected。它表示 Claude Code 真把 server 子进程拉起来、握手也过了。只写进配置但连不上，这里会显示失败。
3.3 真能驱动 Vivado 吗
新开一个会话，问一句「What version of Vivado do I have?」
判据是它报出来的版本号必须和你在提示词里指定的那个一致。
vivado多版本共存的机器上这条尤其关键，报的不是你指定的版本，说明 VIVADO_PATH 没生效。
AI回复：
FULL_VERSION = Vivado v2021.2 (64-bit)
SW Build 3367213 on Tue Oct 19 02:48:09 MDT 2021
SHORT_VERSION = 2021.2
EXEC_PATH = <Vivado 安装路径>/bin/unwrapped/win64.o/vivado.exe
3.4 文档检索连上了吗
装了第 4 步才验这一条。claude mcp list 里 amd-doc-search 应该也是 √ Connected。
配置对不代表答得准，更硬的一条是直接问一个只有官方文档才答得准的问题：「Search the AMD docs for the Zynq UltraScale+ boot flow, and give me the document numbers and source URLs.」
判据是它必须报出真实的文档编号和 docs.amd.com 链接，UG、PG、AR 编号，不是泛泛而谈。
实测参数比官方文档还全一点，官方只写了 query、limit、alpha。
3.5 技能会不会干活
前三条验的是装没装上，这一条验的是会不会干活。
直接给AI发消息就行：运行一个官方测试用例。
等待AI的执行结果即可。
完整安装依赖文件：https://pan.quark.cn/s/48dd67085b40
