NVIDIA AI-Q 部署助手
部署、验证和运维 NVIDIA AI-Q Blueprint 基础设施。
文档明确要求凭据置于 deploy/.env、仅检查存在性、不打印秘密，要求确认危险清理，并说明 REQUIRE_AUTH=false 仅适用于受信任的本地单用户环境；但默认技能后端路径仍可能加入 REQUIRE_AUTH=false，克隆远程仓库缺少事前确认，网络、Git、Docker、Kubernetes 和外部模型/搜索服务权限范围较宽，且回滚主要依赖引用文档。因此扣除 7 分。
步骤、前置条件、预期输出、健康检查、端口冲突、凭据缺失、配置不兼容和清理风险均有说明；但本次仅静态阅读，关键引用文件未全部提供，缺少可直接复现的提交测试套件和对异常环境的实际验证。按静态上限保守给 8 分，扣除 12 分。
触发描述、部署模式、输入条件、交接给 aiq-research 的边界和兼容性规则较清楚；但没有中文交互或中国大陆网络可达性说明，核心流程依赖 GitHub、NVIDIA 模型端点和搜索提供商，可能受网络可达性和凭据限制。因此扣除 4 分。
文档分层、引用表、示例、限制、版本 2.1.0、作者和 GitHub 来源均明确，仓库还提供许可证、同步维护和安全报告路径；但 skill 的许可证元数据为 Apache-2.0，而整体仓库许可证说明为 Apache-2.0 与 CC-BY-4.0，且未提供明确 changelog、维护承诺或完整 FAQ。扣除 5 分。
目标明确，是部署并基础验证 AI-Q 服务后交接服务器 URL；示例命令、健康检查、模式路由和评估任务覆盖核心流程。静态审查无法确认命令与目标 Blueprint 版本实际兼容，且深层引用和运行结果不可独立验证，所以未超过静态上限并扣除 9 分。
存在 BENCHMARK.md、evals.json、预期输出和评估指标，提供了一定可审计线索；但结果主要是仓库内自述，缺少可核验的 CI、提交测试套件或独立复现材料，且本审查未执行任何命令。扣除 6 分。
- 默认 Skill backend 可能设置 REQUIRE_AUTH=false；仅应在受信任的单用户本机使用，暴露到共享网络前必须显式启用认证并验证认证层。
- 克隆远程 AI-Q 仓库会产生外部网络和本地文件系统影响；应在执行前确认目标目录、来源和用户意图。
- 核心依赖 GitHub、NVIDIA 模型端点及搜索服务；中国大陆网络可达性、代理、凭据和服务区域限制未在 skill 中验证。
- 本评估未执行命令；BENCHMARK.md 的通过结论不能替代针对目标环境的部署测试。
这个 Skill 能做什么，适合哪些场景？
aiq-deploy 是 NVIDIA Agent Skills 仓库中的 AI-Q Blueprint 基础设施运维技能，专注于安装、部署、运行、验证、故障排查和停止服务。它支持 Docker Compose、本地 Python/CLI、本地 Web UI，以及 Kubernetes 与 Helm 部署路径。技能会在启动后执行基础健康检查，并将可访问的 AI-Q 服务地址交给 aiq-research。它不负责深度研究本身，也不评估研究报告质量。
定位或克隆 NVIDIA AI-Q 仓库，检查必要文件，选择部署模式，创建或保留 deploy/.env，验证忽略规则和运行时前置条件，启动选定的服务，并通过 /health 端点执行基础验证。它检查所需凭据是否存在但不会打印秘密值；服务健康后报告 AIQ_SERVER_URL，并可在用户确认后进行可选的端到端验证。遇到端口、凭据、配置或服务健康问题时，按对应参考文档进行排查；停止服务或删除 Docker 卷前遵循安全确认流程。
- 需要在本地或自托管环境运行 AI-Q Blueprint 后端，并让 aiq-research 使用它的用户。
- 希望用 Docker Compose 快速启动 AI-Q 后端及默认 PostgreSQL 依赖的用户。
- 需要以 CLI、本地 Web UI 或 Kubernetes/Helm 模式部署 AI-Q 的开发者或运维人员。
- 部署后需要确认服务健康、端口可达，并向下游技能传递服务 URL 的用户。
- 遇到凭据缺失、端口冲突、错误配置或 AI-Q 与 aiq-research 不兼容问题的用户。
这个 Skill 有哪些优点和局限？
- 覆盖安装、部署、健康检查、故障排查、停止和重启等完整运维流程。
- 支持 Docker Compose、本地进程/CLI、本地 Web UI、Kubernetes 和 Helm。
- 明确处理凭据保护、.env 忽略规则、端口冲突和 Docker 卷删除风险。
- 部署验证后可向 aiq-research 交付明确的 AIQ_SERVER_URL。
- 需要 Git、网络访问及至少一种运行时路径，部分路径还需要 Kubernetes 集群或 GPU 资源。
- 需要 NVIDIA_API_KEY，以及网页研究所需的搜索服务密钥；技能不会代用户提供或检查秘密值。
- 不执行深度研究，也不判断深度研究报告质量。
- Helm、FRAG、自托管模型和自定义配置依赖用户控制的外部基础设施，源材料未证明各平台均已测试。
如何安装这个 Skill？
通过 NVIDIA/skills 集合安装：npx skills add nvidia/skills --skill aiq-deploy --yes。也可以运行 npx skills add nvidia/skills --list 后选择 aiq-deploy。README 未说明具体安装目录；CLI 会提示选择技能和安装目标。
如何使用这个 Skill？
向兼容的 Agent Skills 客户端提出“安装并部署 NVIDIA AI-Q Blueprint”之类的请求。若未指定模式，技能会要求选择 Skill backend、CLI、UI 或 Custom；选择后，它会按对应参考文档操作。部署完成后，默认后端应使用 AIQ_SERVER_URL=http://localhost:8000；非默认端口则设置 export AIQ_SERVER_URL="http://localhost:<PORT>"。不要要求或粘贴秘密到聊天中；凭据应在 deploy/.env 或环境变量中配置。
这个 Skill 与同类方案有什么区别？
部署路径之间的选择由环境决定：Docker Compose 是默认的持久化本地部署；Python 与 uv 适合本地进程或 CLI 模式；Node.js 与 npm 适合本地 Web UI 开发；kubectl 与 Helm 适合 Kubernetes 集群部署。