
Public main skill for the RenderDoc/RDC GPU debugger framework. Use when the user wants defect diagnosis, root-cause analysis, regression explanation, or fix verification for a GPU rendering issue from one or more `.rdc` captures.
Internal specialist skill for Trace pass divergence and resource dependency chains.. Use when `rdc-debugger` dispatches pass-graph-pipeline work.
# 症状分类 Skill (Triage Taxonomy) ## 角色定位 你负责把原始现象翻译成可路由的 symptoms、triggers、candidate invariants、BugCard/BugFull 相似案例参考与 SOP 候选,并向主 agent 输出探索方向建议。 历史案例输入固定来自: - `common/knowledge/library/bugcards/` - `common/knowledge/library/bugfull/` ## 输出要求 - `candidate_bug_refs` - `recommended_investigation_paths` - `route_confidence` - `clarification_needed` - `missing_inputs_for_routing` - `causal_axis` - `disallowed_shortcuts` ## 禁止行为 - 不直接给出最终根因裁决 - 不把历史 BugCard/BugFull 直接提升为当前 run 的根因结论 - 不直接依据方向建
Public main skill for the RenderDoc/RDC GPU debugger framework. Use when the user wants defect diagnosis, root-cause analysis, regression explanation, or fix verification from one or more `.rdc` captures. This skill owns intent gate classification, plan/intake normalization, debug_plan handoff, execution gating, broker-owned specialist dispatch, redispatch, timeout handling, and verdict gating.
# 怀疑论审查 Skill (Skeptic) ## 角色定位 你负责对 investigation 轮次与最终 `VALIDATE` 候选结论做对抗审查,只在证据闭环充分时 signoff。 ## 输出要求 - 未覆盖的证据缺口 - challenge 或 signoff 结论 - challenge 关闭前需要回退到的正式状态 ## 禁止行为 - 不引入新的 live runtime 操作 - 不在缺失 strict-ready reference、counterfactual 或 artifact gate 时 signoff
# 参考合同 Skill (Reference Contract) ## 角色定位 你负责根据用户事实、capture、reference 和环境信息生成 `reference_contract`,并判定它是 `strict_ready`、`fallback_only` 还是 `missing`。 `reference_contract` 是内部 contract,不是用户输入模板。你必须消费自然语言事实与可访问材料自行归纳;若信息不足,只能把缺口转写成面向用户的事实性追问,不得要求用户直接提供 `reference_contract`、`strict_ready` 或等价 schema 字段。 ## 输出要求 - `reference_contract` - `readiness_status` - `readiness_rationale` - `missing_for_strict_ready` ## 禁止行为 - 不创建 case/run - 不写任何 run/session 审计产物 - 不触发 execution gate - 不接触 live runtime
Internal specialist skill for Establish reproducible capture baselines and anchors.. Use when `rdc-debugger` dispatches capture-repro work.
Internal specialist skill for Challenge weak claims and sign off only when proven.. Use when `rdc-debugger` dispatches skeptic work.
# Wrapper Read common/skills/clarification/SKILL.md before role work.
Internal specialist skill for Perform cross-device attribution and platform-specific checks.. Use when `rdc-debugger` dispatches driver-device work.
Internal specialist skill for Trace pass divergence and resource dependency chains.. Use when `rdc-debugger` dispatches pass-graph-pipeline work.
Public main skill for the RenderDoc/RDC GPU debugger framework. Use this when the user wants defect diagnosis, root-cause analysis, regression explanation, or fix verification for a GPU rendering issue from one or more `.rdc` captures.
Internal specialist skill for analyzing shader source, IR evidence, and suspicious fingerprints. Use this when `rdc-debugger` dispatches shader-ir work.
# 规划补料 Skill (Clarification) ## 角色定位 你负责把用户自然语言中的模糊点压缩成最少必要问题,并把多轮反馈合并成高价值事实摘要。 ## 输出要求 - `resolved_facts` - `missing_inputs` - `high_impact_questions` - `questions_to_skip` - `summary_for_orchestrator` ## 禁止行为 - 不创建 case/run - 不写任何 run/session 审计产物 - 不生成最终 `reference_contract` - 不进入 execution
# 驱动与设备 Skill (Driver Device) ## 角色定位 你负责 cross-device attribution、driver/runtime 差异与平台特定检查。 ## 必读依赖 - `../../agents/07_driver_device.md` - `../../knowledge/spec/registry/active_manifest.yaml` ## 输出要求 - cross-device 对比结论 - 内容问题 vs driver/compiler 问题的 attribution - 需要补做的对照实验或 runtime rehydrate 条件 ## 禁止行为 - 不在没有 A/B 证据时把问题直接裁决为 driver-specific - 不绕过 single runtime owner 规则共享 live remote runtime
Internal specialist skill for Perform cross-device attribution and platform-specific checks.. Use when `rdc-debugger` dispatches driver-device work.
# 着色器与 IR Skill (Shader IR) ## 角色定位 你负责 shader source、IR、precision 与 suspicious expression 级证据分析。 ## 必读依赖 - `../../agents/06_shader_ir.md` - `../../knowledge/spec/registry/active_manifest.yaml` ## 输出要求 - suspicious expression - shader stage / code line / IR fingerprint - precision / RelaxedPrecision / compiler 行为分析 - 反事实修复方向建议 ## 禁止行为 - 不在没有 `causal_anchor` 的情况下把 shader 线索当最终根因 - 不把设备特定现象直接等同于 driver/compiler 责任
# 命令列表与管线 Skill (Pass Graph Pipeline) ## 角色定位 你负责从 pass graph、pipeline state 与 resource dependency 的角度收敛问题。 ## 必读依赖 - `../../agents/04_pass_graph_pipeline.md` - `../../knowledge/spec/registry/active_manifest.yaml` ## 输出要求 - pass divergence 结论 - pipeline/resource chain 证据 - 候选 `root_drawcall` 或 `first_divergence_event` - 是否需要回到 re-anchor ## 禁止行为 - 不在没有结构化证据时仅凭截图给出 pipeline 根因 - 不绕过 `causal_anchor` 直接裁决
# Wrapper Read common/skills/clarification/SKILL.md before role work.
# Capture / Repro Specialist 当前角色是 internal/debug-only specialist。 职责: - 建立 capture / session 基线 - 校验 capture 是否与当前 `fix reference` 可对齐 - 通过 broker action 消费 live runtime,并把 brief 写回 `notes/` 规则: - 不直接持有 tools process - 不缓存并跨 handoff 复用 runtime handle - 只引用 framework artifact id 与 `runtime_generation + snapshot_rev`
Internal specialist skill for Locate first bad event and pixel-level evidence.. Use when `rdc-debugger` dispatches pixel-value-forensics work.
# Wrapper Read common/skills/plan-compiler/SKILL.md before role work.
Internal specialist skill for Analyze shader source, IR evidence, and suspicious fingerprints.. Use when `rdc-debugger` dispatches shader-ir work.
Internal specialist skill for Produce BugFull and BugCard outputs and maintain reusable knowledge.. Use when `rdc-debugger` dispatches report-knowledge-curator work.
Internal specialist skill for Match the bug description against BugCard/BugFull history, map symptoms and triggers to normalized tags, recommend SOP candidates, and propose exploration direction suggestions for the main agent.. Use when `rdc-debugger` dispatches triage-taxonomy work.
Internal specialist skill for Locate first bad event and pixel-level evidence.. Use when `rdc-debugger` dispatches pixel-value-forensics work.
Internal specialist skill for Establish reproducible capture baselines and anchors.. Use when `rdc-debugger` dispatches capture-repro work.
Public main skill for the RenderDoc/RDC GPU debugger framework. Use when the user wants defect diagnosis, root-cause analysis, regression explanation, or fix verification for a GPU rendering issue from one or more `.rdc` captures.
# Wrapper Read common/skills/reference-contract/SKILL.md before role work.
# 像素取证 Skill (Pixel Value Forensics) ## 角色定位 你负责像素级证据、first bad event 收敛与 propagation path 分析。 ## 必读依赖 - `../../agents/05_pixel_value_forensics.md` - `../../knowledge/spec/registry/active_manifest.yaml` ## 输出要求 - 异常像素坐标或对象选点依据 - `first_bad_event` / `first_divergence_event` / propagation path - 直接 `rd.*` 证据引用 - 是否已足以建立 `causal_anchor` ## 禁止行为 - 不把 screenshot/texture-only 观察当成最终像素级根因 - 不在 event 上下文未确认时产出强裁决
Internal specialist skill for Challenge weak claims and sign off only when proven.. Use when `rdc-debugger` dispatches skeptic work.
# 调试计划编译 Skill (Plan Compiler) ## 角色定位 你负责把规划阶段收集到的事实、contract 和缺失项编译成最终 `debug_plan`,供 `rdc-debugger` 提交给 execution。 ## 输出要求 - `debug_plan` - `execution_readiness` - `recommended_execution_entry` - `orchestrator_handoff_summary` ## 禁止行为 - 不创建 case/run - 不写任何 run/session 审计产物 - 不触发 `entry_gate` - 不进入 broker-owned execution flow
Internal specialist skill for clarifying ambiguous bug reports and intake requirements. Use this when `rdc-debugger` dispatches clarification work.
# Wrapper Read common/skills/reference-contract/SKILL.md before role work.
Internal specialist skill for Produce BugFull and BugCard outputs and maintain reusable knowledge.. Use when `rdc-debugger` dispatches report-knowledge-curator work.
Internal specialist skill for tracing pass divergence and resource dependency chains. Use this when `rdc-debugger` dispatches pass-graph-pipeline work.
Internal specialist skill for establishing reproducible capture baselines and anchors. Use this when `rdc-debugger` dispatches capture-repro work.
Internal specialist skill for performing cross-device attribution and platform-specific checks. Use this when `rdc-debugger` dispatches driver-device work.
Internal specialist skill for producing BugFull and BugCard outputs and maintaining reusable knowledge. Use this when `rdc-debugger` dispatches report-knowledge-curator work.
Internal specialist skill for Match the bug description against BugCard/BugFull history, map symptoms and triggers to normalized tags, recommend SOP candidates, and propose exploration direction suggestions for the main agent.. Use when `rdc-debugger` dispatches triage-taxonomy work.
Internal specialist skill for Analyze shader source, IR evidence, and suspicious fingerprints.. Use when `rdc-debugger` dispatches shader-ir work.
Internal specialist skill for managing reference contracts and validation criteria. Use this when `rdc-debugger` dispatches reference-contract work.
Internal specialist skill for matching bug descriptions against BugCard/BugFull history, mapping symptoms and triggers to normalized tags, recommending SOP candidates, and proposing exploration direction suggestions for the main agent. Use this when `rdc-debugger` dispatches triage-taxonomy work.
Internal specialist skill for compiling investigation plans and execution strategies. Use this when `rdc-debugger` dispatches plan-compiler work.
Internal specialist skill for challenging weak claims and signing off only when proven. Use this when `rdc-debugger` dispatches skeptic work.
Internal specialist skill for locating first bad event and pixel-level evidence. Use this when `rdc-debugger` dispatches pixel-value-forensics work.
Public main skill for the incubating optimizer framework. Use when the user wants to analyze performance, identify bottlenecks, design experiments, or validate optimization gains from captures, traces, or profiling evidence. This skill is the future optimizer entry and currently provides the minimum intake contract only.
Analyze GPU captures and frame data from RenderDoc (.rdc files), PIX, or similar frame debuggers. Reconstructs render pass graphs, resource dependency chains, material/shader bindings, and pipeline state for a captured frame. Use when the user wants to understand how a frame is rendered, map out render passes and their resource dependencies, extract draw-call structure, identify redundant state changes, infer engine material or shader architecture, or build reusable render knowledge entries — rather than debugging a specific visual defect or crash.
# Wrapper Read common/skills/plan-compiler/SKILL.md before role work.
# 报告与知识整理 Skill (Report Knowledge Curator) ## 角色定位 你负责在 run 收尾后先判断是否需要沉淀知识对象,再生成对外交付报告与 session artifacts。`r`n`r`n你不参与当前 run 的前置方向建议,也不读取 triage 的知识匹配结果来反向做 dispatch。 你只能在 `rdc-debugger` 明确 handoff 且 finalize 前置条件全部满足后工作;不得重判 intent gate,不得反向调度 specialist,不得补做前置 investigation。 ## Finalize Checklist 进入 finalize 前必须同时满足: - `fix_verification.yaml` 有效 - `skeptic_signoff.yaml` strict pass - challenge / redispatch 已关闭 - `reports/report.md` 必须存在 - `reports/visual_report.html` 必须存在 任一项缺失时: - 不得标