关于 setup-rhdh-skills
Set Up RHDH Skills 是一项由人类主导的技能,用于安装 RHDH 技能集合并配置所需能力。它通过 setup doctor、分支参考文档和变更审批门控,管理对用户设备及账户的操作。
主要功能
- 01安装、升级或修复技能集合
- 02通过 doctor 检查设置状态
- 03按分支配置指定能力
- 04规划并审批设备变更
- 05凭据保存在所属工具中
适用场景
- 01安装或修复技能集合
- 02配置 Jira 或 Google Workspace 访问
- 03配置仓库或本地运行环境
- 04在 Cursor 中认证 Atlassian MCP
MCP 相关
其中一个设置分支指导在 Cursor 中认证 Atlassian MCP。其他分支用于安装技能和配置能力。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill setup-rhdh-skills安装后在 Claude Code 中输入/setup-rhdh-skills确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/catalog.jsonreferences/atlassian-mcp.mdgoogle-workspace.mdinstall.mdjira.mdlocal-runtime.mdopenshift-ci.mdprivate-data.mdrepositories.mdscripts/setup.py详细介绍
设置 RHDH 技能
引导安装完整技能包,然后配置其模型技能所需的功能。此入口面向人工用户,因为安装、凭据和外部变更都需要人工操作。
选择设置分支
| 请求 | 加载 |
|---|---|
| 安装、升级或修复完整的技能集合 | 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、计划、结果报告或技能包内容中。
完成条件
当诊断程序报告 assets/catalog.json 中的所有推广技能以及 grilling、code-review 和 handoff 均已安装,且同一份诊断报告中显示该分支自身的功能已就绪,并且已运行分支参考文档中的冒烟测试并展示其输出时,该分支才算完成。安装分支还要求为已批准计划中的每项操作报告一个结果,并告知用户重启或重新扫描 Agent。如果模型技能因缺少某项功能而将用户引导至此,则该分支结束前,该技能提到的每项功能都必须报告为已安装。任何仍缺失的功能都应标记为未解决,不要就此结束分支。