RDC-Agent-Frameworks

Category: Tools & Productivity | Uploader: haolange | Downloads: 0 | Version: v1.0（Latest）

这个 skill 的目标是让 Agent 明确：当前任务是使用 RenderDoc/RDC platform tools 调试 GPU 渲染问题，而不是讨论一个抽象 framework。

Changelog: Source: GitHub https://github.com/haolange/RDC-Agent-Frameworks

Directory Structure

Current level: debugger/common/skills/renderdoc-rdc-gpu-debug/

📄 SKILL.md 2.8 KB

SKILL.md

# RenderDoc/RDC GPU Debug Skill

## 任务目标

这个 skill 的目标是让 Agent 明确：当前任务是使用 RenderDoc/RDC platform tools 调试 GPU 渲染问题，而不是讨论一个抽象 framework。

## 必读顺序

1. `../../AGENT_CORE.md`
2. `../../docs/platform-capability-model.md`（当前文件位于 `common/skills/...`，该相对路径指向共享入口 `common/docs/...`）
3. `../../docs/platform-capability-matrix.md`
4. `../../docs/model-routing.md`
5. 若用户要求 `CLI` 模式：`../../docs/cli-mode-reference.md`

## 平台模式

### `MCP` 模式

- 允许 tool discovery。
- 允许先发现工具能力，再进行多步编排。

### `CLI` 模式

- 禁止 discovery-by-trial-and-error。
- 禁止靠 `--help`、命令枚举、随机试跑、观察式试错来摸索能力面。
- 用户明确要求 `CLI` 模式时，必须先阅读 `cli-mode-reference.md`，再执行任务。

## 工具边界

- 目标是驱动 `rd.*` / platform tools 处理 capture、session、event、resource、shader、driver 证据。
- 禁止自造工具名。
- 调用时优先检查共享响应契约中的 `ok` 与 `error_message`。

## 协作拓扑

- 当前平台的 `coordination_mode` 以 `common/config/platform_capabilities.json` 与平台生成物为准。
- `concurrent_team`
  - 允许并行分派，但每条 live 调试链路都必须独占一个 `context/daemon`
- `staged_handoff`
  - 子 Agent 先提交 brief 与 evidence request，再由 runtime owner 执行工具链
- `workflow_stage`
  - 只允许阶段化串行推进，不模拟实时 team handoff

## Baton / Rehydrate

- 跨轮次移交时必须附带 `runtime_baton`。
- baton 必须优先恢复 `causal_anchor`、`action_chain.jsonl`、`session_evidence.yaml` 与 `rd.session.get_context` 可观察快照。
- remote case 一律采用 `single_runtime_owner`；其他角色通过 brief / evidence request / artifact 协作。
- `rd.session.update_context` 只允许恢复 focus 与 notes，不得伪造 runtime-owned handle。
- `capture_file_id`、`session_id`、`remote_id` 都只能作为短生命周期提示，不得成为唯一真相源。
- baton 恢复顺序以共享运行时文档 `common/docs/runtime-coordination-model.md` 为准；从当前文件的相对路径是 `../../docs/runtime-coordination-model.md`。

## 方向约束

- 出现 `hair_shading`、`precision`、`washout`、`blackout`、`Adreno_GPU` 这类组合时，禁止直接依据 screen-like 观测做根因裁决。
- 必须先建立 `causal_anchor`，再把 `RelaxedPrecision`、后处理阶段或 screen-space shader 线索提升为根因分析对象。

## 结案约束

- 结案前必须满足 `session_evidence.yaml`、`skeptic_signoff.yaml`、`action_chain.jsonl` 与 `.current_session` 的 artifact 合同。
- `skeptic_agent` 未完成 signoff 时，不得把结论当成最终结论。

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

RDC-Agent-Frameworks

Directory Structure

SKILL.md

Report

Notice