---
name: haolange/rdc-debugger
source: https://app.decimal.ai/s/haolange-rdc-debugger@6/SKILL.md
source_sha256: dd8c9e78d097
---

# `RDC Debugger` 主技能包装说明

当前文件是 Codex 的 public main skill 入口。

平台启动后默认保持普通对话态。只有用户手动召唤 `rdc-debugger`，才进入 RenderDoc/RDC GPU Debug 调试框架。

`rdc-debugger` 是单一公开入口，但内部固定拆成两段：

1. `Plan / Intake Phase`
2. `Audited Execution Phase`

## Plan / Intake Phase

当前阶段兼容宿主 Plan Mode，负责：

- `intent_gate`
- 缺失输入补料
- `reference_contract` 生成与 readiness 判定
- `debug_plan` 编译

当前阶段对外只允许要求用户补充自然语言事实、目标、现象、环境和可访问材料。

不得把以下内部对象直接当成用户输入要求：

- `reference_contract`
- `strict_ready`
- `missing_inputs`
- `debug_plan`

如果 execution 仍被 `BLOCKED_MISSING_FIX_REFERENCE` 阻断，必须明确说明缺的是哪类参考事实或基线材料，而不是让用户按内部字段名补 YAML。

当前阶段默认通过轻量 sub-agent 收敛输入：

- `clarification_agent`
- `reference_contract_agent`
- `plan_compiler_agent`

当前阶段不允许：

- 创建 case/run
- 写入 run/session 审计产物
- 进入 specialist dispatch 或 live `rd.*` 分析

## Audited Execution Phase

只有当 `debug_plan.execution_readiness = ready` 时，当前 skill 才允许进入 execution。

固定顺序：

1. `entry_gate`
2. `accept_intake`，内部完成 capture import、case/run bootstrap、`intake_gate` 与 broker startup
3. `triage`
4. `dispatch/specialist loop`
5. `skeptic`
6. `curator`
7. `final_audit`

在 `artifacts/intake_gate.yaml` 通过，且 `artifacts/runtime_session.yaml`、`artifacts/runtime_snapshot.yaml`、`artifacts/ownership_lease.yaml`、`artifacts/runtime_failure.yaml` 产出前，不得进入 specialist dispatch 或 live `rd.*` 分析。

本 skill 只引用当前平台根目录的 `common/`：

- `common/skills/rdc-debugger/SKILL.md`
- 进入任何平台真相相关工作前，必须先校验 `common/config/platform_adapter.json`
- local_support / remote_support / enforcement_layer / coordination_mode 统一以 `common/config/platform_capabilities.json` 的当前平台定义为准

当前平台固定 contract：

- `coordination_mode = staged_handoff`
- `orchestration_mode = multi_agent`
- `live_runtime_policy = single_runtime_single_context`
- `hook_ssot = shared_harness`

执行约束：

- live tools process 始终由 broker / coordinator 直接持有。
- specialist 只能在有效 `ownership_lease` 下通过 broker action 请求访问 live runtime。
- 不得直接持有 live CLI / process，不得缓存并跨 handoff 复用 runtime handle。
- 不得临时写 Python、PowerShell 或 shell wrapper 批处理 live CLI。
- `triage + specialist + skeptic + curator` 明确必须通过 sub-agent 执行。
- `entry_gate`、`accept_intake`、`intake_gate`、`dispatch_readiness`、`final_audit` 属于控制面，不 agent 化。
- specialist dispatch 后，主 agent 必须进入 `waiting_for_specialist_brief` 并持续汇总阶段回报；短时 silence 不得触发 orchestrator 抢活。
- 超过框架预算仍未收到阶段回报时，必须进入 `BLOCKED_SPECIALIST_FEEDBACK_TIMEOUT` 或等价阻断状态，而不是让 orchestrator 抢做 specialist live investigation。

未先将顶层 `debugger/common/` 拷入当前平台根目录的 `common/` 之前，不允许在宿主中使用当前平台模板。

运行时 case/run 现场与第二层报告统一写入平台根目录下的 `workspace/`。