mcpField
R
rhdh-plugin-bug-fix

rhdh-plugin-bug-fix

github.com/redhat-developer开发1949 次安装1 天前更新
代码仓库

关于 rhdh-plugin-bug-fix

rhdh-plugin-bug-fix 是用于处理 RHDH 插件缺陷的开发技能,面向负责修复和验证问题的开发者。它要求先复现、依据证据诊断,再实施最小修复,并删除临时复现测试后交接。

主要功能

  1. 01按流程分诊并定位工作区
  2. 02通过 Playwright 复现缺陷
  3. 03记录修复前后视频证据
  4. 04依据根因实施最小修复
  5. 05验证结果并清理临时测试

适用场景

  1. 01调查 RHDH 插件缺陷报告
  2. 02验证修复是否解决复现问题
  3. 03为后续测试或发布准备交接

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/redhat-developer/rhdh-skills --skill rhdh-plugin-bug-fix

安装后在 Claude Code 中输入/rhdh-plugin-bug-fix确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
e2e-patterns.md
video-recording.md
workspace-map.md
workflows/
fix-bug.md

详细介绍

RHDH 插件错误修复

负责从错误报告到验证修复的完整流程。先复现,再诊断;先诊断,再编辑;先验证,再报告。复现测试是诊断证据,绝不会随产品一同交付。

从这里开始

从头开始遵循 workflows/fix-bug.md。它会解析问题引用,评估报告是否已具备 Agent 处理条件,发现工作区,选择完整端到端或无端到端分支,进行复现、修复、验证并清理。

根据结果选择路径

结果加载并遵循
复现、诊断并修复插件错误workflows/fix-bug.md
将报告解析到插件工作区references/workspace-map.md
编写临时 Playwright 复现测试references/e2e-patterns.md
采集并转换修复前后的证据references/video-recording.md

边界

  • /rhdh-forge 负责读取 GitHub。使用原始问题或拉取请求引用,按名称调用它,并使用它返回的结构化问题上下文——键、摘要、URL、仓库、编号、状态、标签、描述,以及通过相应策略解析出的候选工作区。在该工作区中操作前,先根据检出内容确认工作区;如果策略报告无法解析,请询问用户。不要在此处解析 URL 或运行 gh issue view。
  • /rhdh-jira-api 负责读取 Jira 键,并返回相同的问题详情。
  • /grilling 是在仍有多个可能的根本原因,或不同修复方案会带来不同兼容性成本时的设计关卡。实施前使用它给出的约束。如果未安装,请说明这一点,告知用户下一步应执行 /setup-rhdh-skills install,并暂停该分支。
  • /rhdh-test-placement 会就永久性回归测试应放置的位置提供建议。此处编写的复现测试是临时的,交接更改前必须删除。
  • /rhdh-plugin-authoring 负责功能开发和公共 API 设计。
  • /rhdh-pr-create 负责暂存、变更集、提交、推送、拉取请求、录制文件上传和问题更新。

调用具名技能,并在对话中说明交接内容。不要打开其他技能的文件。

不变量

  • 编辑产品代码前先复现故障。修复后无法重新构造“修复前”录制。
  • 临时文件 _repro-<issue>.test.ts 是证据,而非交付物。交接更改前,必须删除该确切文件。
  • 查明工作区实际的 Playwright 配置、辅助工具和相邻测试。references/workspace-map.md 会定位可能的工作区,但不会描述当前的测试基础设施。
  • 关闭 Playwright 上下文,确保每段视频都完成写入;在发布流程使用前,保留修复前后的录制。
  • 实施前,先根据观察到的证据说明根本原因,然后按照仓库惯例实施最小修复。
  • 如果测试仍然失败,请返回诊断。绝不要为了让测试通过而弱化断言。
  • 为问题添加标签或分类评论属于外部写入。调用具名技能 mutation-gate 并遵循其要求;操作目标必须是确切的仓库和问题编号。修复错误的请求不代表获准写入问题。
  • 此处不要暂存、提交、推送或创建拉取请求。

完成

报告已解决的问题和工作区、复现过程及其证明内容、有证据支持的根本原因、已更改且仍未暂存的文件、修复前后的录制路径、验证命令及其结果、审阅者应运行的测试计划,以及发布时下一步应调用的具名技能。

评论

支持 Markdown