gfx-triage SKILL.md skillA

gfx-triage from jhaizhou-ops/s2arm is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add jhaizhou-ops/s2arm/gfx-triage@git:20261108.3925321

Pins git:20261108.3925321 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: jhaizhou-ops/s2arm
Path: skills/gfx-triage/SKILL.md
Versions recorded: 1
Latest version: git:20261108.3925321, committed Nov 8, 2026
Size: 4,968 bytes
Repository stars: 676
License: Apache-2.0

S2Arm 画面问题分诊与根修：拿到「花屏 / 贴图错 / 闪烁」「不满屏 / 宽屏两侧异常 / 拉伸」「没走直连 / 直连异常」任一类问题时先读本 skill。按症状分到三份排查手册，读 host.log 指定行定位，再按先红后绿写单测、根修。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 画面问题分诊（gfx-triage）

你在帮 S2Arm 定位并根修一个画面问题。原则：**先看读数再猜原因，先写会红的单测再改代码，修机制不修症状**。三份手册是知识库，本文件只管分诊顺序。

## 0. 先确认三件事（每一件都看 host.log，不靠印象）
1. **图形模式**：grep `图形模式：`。是「没有直连库」→ 直接去 [直连异常与退回通用](../../docs/排查/直连异常与退回通用.md)。
2. **屏幕比例与宽屏开关**：grep `宽屏：` 和 `出图层已挂到根视图`。问题只在两侧条带，或者整幅比例不对 → 去 [不满屏与宽屏异常](../../docs/排查/不满屏与宽屏异常.md)。
3. **新红行**：grep `【红】`。任何新出现的红行先读完再往下走。

都不是 → 去 [花屏与贴图错](../../docs/排查/花屏与贴图错.md)。

## 1. 症状 → 手册 → 先看哪几行

| 症状 | 手册 | 先看 |
|---|---|---|
| 切场景后整屏发白 / 背景成片噪点 | 花屏 | 开 `DM_NVN_NONFINITE_FILL=1` 做反证，能复现就是旧字节 Inf/NaN |
| 高光 / 反射逐帧闪 | 花屏 | `same-pass feedback sampling up to frame …`；用 `DM_NVN_SHOT` 连拍，按块量或直接看连续帧 |
| 远景糊 / 锐不对，日志里大量重新登记 | 花屏 | `sampler pool up to frame … registered again` |
| isnan 挡不住的黑块 / 白块 | 花屏 | `graphics/metal/tests/t_mathmode.m`，编译数学模式 |
| 整局 16:9 加黑边 | 宽屏 | 总开关：环境变量 > 用户设置 > 包内能力清单 > widen_verified.tsv |
| 某页两侧残留旧帧 | 宽屏 | 截图帧号在不在「出图原比例居中 / 离开原比例页」区间里；「其中纯色 / 小图层按原样铺满」计数 |
| 暗化 / 模糊底只盖中间 | 宽屏 | 被采样的贴图有没有登记成整屏副本（定因中，见手册） |
| 整幅横拉 | 宽屏 | 是不是 Vulkan / GL 直连（第三层做不到） |
| 图形模式：没有直连库 / 起局报「游戏文件缺失」 | 直连 | `图形模式：没有直连库（依据 …）` 行与上面的【红】（链号不符、缺 shader_map.tsv / lib.idx）；`entry*.direct_missing`。11-07 起没有通用模式可退，导出诊断包反馈 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add jhaizhou-ops/s2arm/gfx-triage@sha256:2d348948ac79e63a

The line at the top of this page pins the label git:20261108.3925321, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_xqs6yfujp2sx6ms2.svg)](https://markdownregistry.com/a/art_xqs6yfujp2sx6ms2)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Nov 8, 2026.

version	committed	commit	size	audit
git:20261108.3925321 latest	2026-11-08	3925321	4,968 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (4968 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

jhaizhou-ops/s2arm · 676 stars · license Apache-2.0 · pushed 2026-11-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xqs6yfujp2sx6ms2
GET https://markdownregistry.com/api/v1/resolve?ref=jhaizhou-ops/s2arm/gfx-triage
GET https://markdownregistry.com/api/v1/blob/2d348948ac79e63a724207b153efb253b15f7d7ae52a1426e0ed37ad63e9c4c1

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.