用途
setup-rhdh-skills 是 RHDH 技能包（redhat-developer/rhdh-skills）的引导与配置入口，用于安装、升级或修复整套技能集合，并为其中的模型技能配置所需能力。技能说明明确指出，这是一个人工入口点，因为安装、凭据获取和外部变更都需要人工介入。
主要能力
该技能提供多个配置分支，用户按需选择：
- 安装、升级或修复完整技能集合（references/install.md）
- 配置 Jira 的 CLI、REST 或 GraphQL 访问（references/jira.md）
- 配置 Google Workspace 访问，用于日程和测试计划（references/google-workspace.md）
- 配置 RHDH 私有数据检出（references/private-data.md）
- 在 Cursor 中认证 Atlassian MCP（references/atlassian-mcp.md）
- 发现或配置 RHDH 仓库（references/repositories.md）
- 配置容器与本地 RHDH 运行时（references/local-runtime.md）
- 认证 OpenShift CI Gangway 适配器（references/openshift-ci.md）
当请求中未指定分支时，技能会展示上述选择表并等待用户选择。
使用方式
每个分支执行前先运行预检：
uv run scripts/setup.py doctor --json
该报告列出已安装的技能、仍缺失的技能、能力状态和配置位置（不读取凭据），并在本次会话中复用，除非配置发生变化。
安装技能与配置能力会写入用户机器和账号，因此需调用 mutation-gate 技能并遵循它。安装计划通过 scripts/setup.py install-plan 说明有序的安装操作，再用 scripts/setup.py apply --plan <file> --confirm 执行获批计划，并为每个操作报告一条结果。配置分支以同样方式说明自己的操作。
凭据始终保留在所属工具的凭据存储或操作系统钥匙串中，应直接传给工具，不得放入对话、配置 JSON、计划、结果报告或技能包内容。
完成条件
分支完成的判定为：doctor 报告显示 assets/catalog.json 中所有已提升技能以及grilling、code-review、handoff 均已安装；该分支自身能力在同一份 doctor 报告中显示为存在；且分支参考中的冒烟检查已运行并展示输出。安装分支还要求获批计划中的每个操作都有一条结果报告，并告知用户重启或重新扫描 agent。如果是因为某项能力缺失而被模型技能引导至此，则它提到的每项能力都必须报告为已安装，分支才能关闭；仍未安装的能力须标记为 unresolved，不能以此关闭。
适用场景与限制
适用于需要搭建或修复 RHDH 技能环境的用户，涉及 Red Hat Developer Hub 相关仓库、私有数据、本地运行时与 CI 适配器等场景。限制在于：过程中涉及安装与外部账号变更，需要人工确认与凭据输入；具体配置细节与命令内容见各分支参考文档。技能本身不描述收费、价格或平台信息。