rdc-debugger

Name: rdc-debugger
Author: haolange

15stars5forks

How to install rdc-debugger?

haolange/rdc-agentcaps/rdc-debugger

$npx -y skills add haolange/RDC-AgentCaps --skill rdc-debugger

Installs into the current project.

Summary

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, debu

Files · 1

View on GitHub

SKILL.md

1	# RDC 调试器
2
3	`rdc-debugger` 是唯一 public main skill 与唯一 classifier，但内部固定分成两段：
4
5	1. `Plan / Intake Phase`
6	2. `Audited Execution Phase`
7
8	## Plan / Intake Phase
9
10	Plan 阶段负责：
11
12	- `intent_gate`
13	- 缺失输入补料
14	- 生成 `reference_contract`
15	- 判定 `strict_ready / fallback_only / missing`
16	- 汇总为 `debug_plan`
17
18	Plan 阶段对外口径固定为：
19
20	- 用户只需要提供自然语言事实、目标、现象、环境信息和宿主可访问材料
21	- agent 必须通过最少必要问题自行整理 `missing_inputs`、`reference_contract` 与 `debug_plan`
22	- 不得要求用户直接提交内部 YAML / schema / 字段名
23	- 即使 execution 被 `BLOCKED_MISSING_FIX_REFERENCE` 阻断，也只能说明“还缺什么事实或参考基线”，不能把 `strict_ready reference_contract` 原样当作用户待补字段
24
25	Plan 阶段默认通过轻量 sub-agent 收敛输入：
26
27	- `clarification_agent`
28	- `reference_contract_agent`
29	- `plan_compiler_agent`
30
31	Plan 阶段硬规则：
32
33	- 不创建 case/run
34	- 不写 `action_chain.jsonl`、`session_evidence.yaml`、`skeptic_signoff.yaml`
35	- 不接触 live runtime
36	- orchestrator 只保留核心简化摘要，不回灌冗长问答全文和大段中间推理
37
38	## Audited Execution Phase
39
40	只有当 `debug_plan.execution_readiness = ready` 时，才允许进入 execution。
41
42	你必须按固定阶段链推进：
43
44	1. `entry_gate`
45	2. `accept_intake / intake_gate`
46	3. `triage`
47	4. `dispatch_readiness`
48	5. `specialist handoff / redispatch / timeout`
49	6. `skeptic`
50	7. `curator`
51	8. `final_audit / render_user_verdict`
52
53	Execution 规则：
54
55	- `case_input.yaml`、`case_id`、`run_id`、`hypothesis_board.yaml` 只在 execution 内物化或更新
56	- `triage` 明确属于 execution，不前移到 plan 阶段
57	- `triage + specialist + skeptic + curator` 明确必须通过 sub-agent 执行
58	- `entry_gate`、`accept_intake`、`intake_gate`、`dispatch_readiness`、`final_audit` 属于控制面，不 agent 化
59
60	关键规则：
61
62	- `triage_agent` 只提供 routing hint，不直接 dispatch specialist
63	- triage 产生的 `candidate_bug_refs`、`recommended_sop`、`recommended_investigation_paths` 只是方向建议，最终是否进入哪个 specialist 仍由 `rdc-debugger` 决定
64	- live runtime 由 broker 直接持有；specialist 只通过 `ownership_lease` + broker action 消费 live runtime
65	- `session_id`、`context_id`、`active_event_id` 不得作为跨阶段稳定主键传播
66	- 临时 Python / PowerShell / shell wrapper 封装 live CLI 一律视为流程偏差
67	- `waiting_for_specialist_brief`、`redispatch_pending`、`specialist_reinvestigation`、`skeptic_challenged` 期间，orchestrator 只能汇总与裁决，不能替 specialist 补证据
68	- `primary_completion_question`、`requested_artifact` 等意图字段属于 plan 输入归一化，不属于 run 级 runtime 真相
69
70	## Sub-Agent 委派强制规则 (MANDATORY DELEGATION)
71
72	### 核心原则
73
74	强制委托（Mandatory Delegation）是本框架的核心安全机制：
75	- 主 Agent 禁止直接执行调查、分析、验证等核心任务
76	- 所有核心任务必须通过 Sub-Agent 执行
77	- 主 Agent 仅负责协调、决策和流程推进
78
79	### 必须委托的节点
80
81	以下节点必须通过 sub-agent 执行，禁止主 Agent 直接执行：
82
83	\| 节点 \| 委派目标 \| 产出物 \| 违规后果 \|
84	\|------\|----------\|--------\|----------\|
85	\| `triage` \| `triage_taxonomy_agent` \| `triage_result.yaml` \| 产出物无效，必须重新委派；记录 `PROCESS_DEVIATION_SKIPPED_TRIAGE` \|
86	\| `specialist_investigation` \| 各类 specialist agent (如 `shader_specialist`, `pipeline_specialist`, `resource_specialist`) \| `brief.yaml`, `session_evidence.yaml` \| 主 Agent 产出视为无效证据；记录 `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
87	\| `skeptic_review` \| `skeptic_agent` \| `challenge.yaml` 或 `signoff.yaml` \| 缺少 skeptic 审计的 brief 不得进入 curator；记录 `PROCESS_DEVIATION_MISSING_SKEPTIC` \|
88	\| `curator_finalize` \| `curator_agent` \| `curator_report.yaml`, `final_hypothesis.yaml` \| 未经验证的结论不得输出给用户；记录 `PROCESS_DEVIATION_PREMATURE_VERDICT` \|
89
90	### 主 Agent 禁止行为清单 (PROHIBITED ACTIONS)
91
92	主 Agent 在任何时候都禁止执行以下操作：
93
94	\| 禁止行为 \| 说明 \| 违规后果 \|
95	\|---------\|------\|---------\|
96	\| 直接分析 RDC capture 文件 \| 必须通过 `specialist` sub-agent \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
97	\| 直接编写 `session_evidence.yaml` \| 必须由 `specialist` 产出 \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
98	\| 直接编写 `brief.yaml` \| 必须由 `specialist` 产出 \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
99	\| 直接执行 shader 分析 \| 必须通过 `shader_specialist` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
100	\| 直接执行 pixel forensics \| 必须通过 `pixel_forensics_agent` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
101	\| 直接验证 fix \| 必须通过 `fix_verification_agent` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
102	\| 跳过 triage 直接 dispatch \| 必须先通过 `triage` \| `PROCESS_DEVIATION_SKIPPED_TRIAGE` \|
103	\| 跳过 skeptic 直接结案 \| 必须通过 `skeptic` 审计 \| `PROCESS_DEVIATION_MISSING_SKEPTIC` \|
104
105	### 主 Agent 允许行为清单 (ALLOWED ACTIONS)
106
107	主 Agent 仅允许执行以下操作：
108
109	\| 允许行为 \| 说明 \|
110	\|---------\|------\|
111	\| 读取和解析用户输入 \| 理解用户意图和需求 \|
112	\| 生成 `debug_plan` \| 在 Plan 阶段生成执行计划 \|
113	\| 调用 `entry_gate`, `intake_gate` \| 执行控制面 gate 检查 \|
114	\| 委派任务给 Sub-Agent \| 通过 `dispatch_specialist` 等机制 \|
115	\| 读取 Sub-Agent 产出物 \| 读取 `brief.yaml`, `challenge.yaml` 等 \|
116	\| 更新 `hypothesis_board.yaml` \| 更新 blocker 和决策状态 \|
117	\| 决定 redispatch 或 escalation \| 基于 Sub-Agent 反馈做决策 \|
118	\| 调用 `final_audit` \| 执行最终审计 \|
119	\| 输出最终 verdict 给用户 \| 基于 curator 报告输出结论 \|
120
121	### 委派验证机制 (Delegation Verification)
122
123	委派前检查：
124
125	1. Agent 可用性检查
126	- 确认目标 sub-agent 在 `agent_registry.yaml` 中状态为 `available`
127	- 检查目标 agent 的 `capability_match` 与当前任务

People who liked this also viewed

6 picks

Type

rdc-debugger

15stars5forks

View on GitHub

How to install rdc-debugger?

haolange/rdc-agentcaps/rdc-debugger

$npx -y skills add haolange/RDC-AgentCaps --skill rdc-debugger

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# RDC 调试器
2
3	`rdc-debugger` 是唯一 public main skill 与唯一 classifier，但内部固定分成两段：
4
5	1. `Plan / Intake Phase`
6	2. `Audited Execution Phase`
7
8	## Plan / Intake Phase
9
10	Plan 阶段负责：
11
12	- `intent_gate`
13	- 缺失输入补料
14	- 生成 `reference_contract`
15	- 判定 `strict_ready / fallback_only / missing`
16	- 汇总为 `debug_plan`
17
18	Plan 阶段对外口径固定为：
19
20	- 用户只需要提供自然语言事实、目标、现象、环境信息和宿主可访问材料
21	- agent 必须通过最少必要问题自行整理 `missing_inputs`、`reference_contract` 与 `debug_plan`
22	- 不得要求用户直接提交内部 YAML / schema / 字段名
23	- 即使 execution 被 `BLOCKED_MISSING_FIX_REFERENCE` 阻断，也只能说明“还缺什么事实或参考基线”，不能把 `strict_ready reference_contract` 原样当作用户待补字段
24
25	Plan 阶段默认通过轻量 sub-agent 收敛输入：
26
27	- `clarification_agent`
28	- `reference_contract_agent`
29	- `plan_compiler_agent`
30
31	Plan 阶段硬规则：
32
33	- 不创建 case/run
34	- 不写 `action_chain.jsonl`、`session_evidence.yaml`、`skeptic_signoff.yaml`
35	- 不接触 live runtime
36	- orchestrator 只保留核心简化摘要，不回灌冗长问答全文和大段中间推理
37
38	## Audited Execution Phase
39
40	只有当 `debug_plan.execution_readiness = ready` 时，才允许进入 execution。
41
42	你必须按固定阶段链推进：
43
44	1. `entry_gate`
45	2. `accept_intake / intake_gate`
46	3. `triage`
47	4. `dispatch_readiness`
48	5. `specialist handoff / redispatch / timeout`
49	6. `skeptic`
50	7. `curator`
51	8. `final_audit / render_user_verdict`
52
53	Execution 规则：
54
55	- `case_input.yaml`、`case_id`、`run_id`、`hypothesis_board.yaml` 只在 execution 内物化或更新
56	- `triage` 明确属于 execution，不前移到 plan 阶段
57	- `triage + specialist + skeptic + curator` 明确必须通过 sub-agent 执行
58	- `entry_gate`、`accept_intake`、`intake_gate`、`dispatch_readiness`、`final_audit` 属于控制面，不 agent 化
59
60	关键规则：
61
62	- `triage_agent` 只提供 routing hint，不直接 dispatch specialist
63	- triage 产生的 `candidate_bug_refs`、`recommended_sop`、`recommended_investigation_paths` 只是方向建议，最终是否进入哪个 specialist 仍由 `rdc-debugger` 决定
64	- live runtime 由 broker 直接持有；specialist 只通过 `ownership_lease` + broker action 消费 live runtime
65	- `session_id`、`context_id`、`active_event_id` 不得作为跨阶段稳定主键传播
66	- 临时 Python / PowerShell / shell wrapper 封装 live CLI 一律视为流程偏差
67	- `waiting_for_specialist_brief`、`redispatch_pending`、`specialist_reinvestigation`、`skeptic_challenged` 期间，orchestrator 只能汇总与裁决，不能替 specialist 补证据
68	- `primary_completion_question`、`requested_artifact` 等意图字段属于 plan 输入归一化，不属于 run 级 runtime 真相
69
70	## Sub-Agent 委派强制规则 (MANDATORY DELEGATION)
71
72	### 核心原则
73
74	强制委托（Mandatory Delegation）是本框架的核心安全机制：
75	- 主 Agent 禁止直接执行调查、分析、验证等核心任务
76	- 所有核心任务必须通过 Sub-Agent 执行
77	- 主 Agent 仅负责协调、决策和流程推进
78
79	### 必须委托的节点
80
81	以下节点必须通过 sub-agent 执行，禁止主 Agent 直接执行：
82
83	\| 节点 \| 委派目标 \| 产出物 \| 违规后果 \|
84	\|------\|----------\|--------\|----------\|
85	\| `triage` \| `triage_taxonomy_agent` \| `triage_result.yaml` \| 产出物无效，必须重新委派；记录 `PROCESS_DEVIATION_SKIPPED_TRIAGE` \|
86	\| `specialist_investigation` \| 各类 specialist agent (如 `shader_specialist`, `pipeline_specialist`, `resource_specialist`) \| `brief.yaml`, `session_evidence.yaml` \| 主 Agent 产出视为无效证据；记录 `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
87	\| `skeptic_review` \| `skeptic_agent` \| `challenge.yaml` 或 `signoff.yaml` \| 缺少 skeptic 审计的 brief 不得进入 curator；记录 `PROCESS_DEVIATION_MISSING_SKEPTIC` \|
88	\| `curator_finalize` \| `curator_agent` \| `curator_report.yaml`, `final_hypothesis.yaml` \| 未经验证的结论不得输出给用户；记录 `PROCESS_DEVIATION_PREMATURE_VERDICT` \|
89
90	### 主 Agent 禁止行为清单 (PROHIBITED ACTIONS)
91
92	主 Agent 在任何时候都禁止执行以下操作：
93
94	\| 禁止行为 \| 说明 \| 违规后果 \|
95	\|---------\|------\|---------\|
96	\| 直接分析 RDC capture 文件 \| 必须通过 `specialist` sub-agent \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
97	\| 直接编写 `session_evidence.yaml` \| 必须由 `specialist` 产出 \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
98	\| 直接编写 `brief.yaml` \| 必须由 `specialist` 产出 \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
99	\| 直接执行 shader 分析 \| 必须通过 `shader_specialist` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
100	\| 直接执行 pixel forensics \| 必须通过 `pixel_forensics_agent` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
101	\| 直接验证 fix \| 必须通过 `fix_verification_agent` \| `PROCESS_DEVIATION_MAIN_AGENT_OVERREACH` \|
102	\| 跳过 triage 直接 dispatch \| 必须先通过 `triage` \| `PROCESS_DEVIATION_SKIPPED_TRIAGE` \|
103	\| 跳过 skeptic 直接结案 \| 必须通过 `skeptic` 审计 \| `PROCESS_DEVIATION_MISSING_SKEPTIC` \|
104
105	### 主 Agent 允许行为清单 (ALLOWED ACTIONS)
106
107	主 Agent 仅允许执行以下操作：
108
109	\| 允许行为 \| 说明 \|
110	\|---------\|------\|
111	\| 读取和解析用户输入 \| 理解用户意图和需求 \|
112	\| 生成 `debug_plan` \| 在 Plan 阶段生成执行计划 \|
113	\| 调用 `entry_gate`, `intake_gate` \| 执行控制面 gate 检查 \|
114	\| 委派任务给 Sub-Agent \| 通过 `dispatch_specialist` 等机制 \|
115	\| 读取 Sub-Agent 产出物 \| 读取 `brief.yaml`, `challenge.yaml` 等 \|
116	\| 更新 `hypothesis_board.yaml` \| 更新 blocker 和决策状态 \|
117	\| 决定 redispatch 或 escalation \| 基于 Sub-Agent 反馈做决策 \|
118	\| 调用 `final_audit` \| 执行最终审计 \|
119	\| 输出最终 verdict 给用户 \| 基于 curator 报告输出结论 \|
120
121	### 委派验证机制 (Delegation Verification)
122
123	委派前检查：
124
125	1. Agent 可用性检查
126	- 确认目标 sub-agent 在 `agent_registry.yaml` 中状态为 `available`
127	- 检查目标 agent 的 `capability_match` 与当前任务

People who liked this also viewed

6 picks

Type