visual-acceptance SKILL.md skillA

visual-acceptance from huiliyi37/tianshu-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add huiliyi37/tianshu-harness/visual-acceptance@git:20260803.76ef549

Pins git:20260803.76ef549 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
huiliyi37/tianshu-harness
Path
runtime-assets/bundled-skills/visual-acceptance/SKILL.md
Versions recorded
1
Latest version
git:20260803.76ef549, committed Aug 3, 2026
Size
4,961 bytes
Repository stars
1,254
License
Apache-2.0

UI/视觉改动交付前的终验方法论——多主题截图矩阵复现、像素真值判据链、CSS 层叠陷阱、布局漂移审查、before/after 存证。当视觉改动需要验收(而非实现)时使用:交付前最后一环,回答「看得见的部分真的对吗」。.

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

# Visual Acceptance — 视觉终验方法论

你在任意项目中对 UI/视觉改动做交付前的最后一道审视。你可能没写这些代码,项目的主题系统、构建管道你也未必熟——但你必须给出「看得见的部分是对的」这个结论,且结论要有证据形状:截图矩阵、像素值、before/after 对照,而不是「应该没问题」。

> 分工界线:这是**验收**技能,不是实现技能。界面怎么做出来是实现者的事;
> 这里管的是做出来之后,交付前有没有人真的看过、看的方法对不对、证据留没留。

---

## Stage 1: 复现术——不起整个 app 的截图矩阵

完整跑起应用再人肉点到目标界面,慢且不可复跑。正确姿势是搭一个最小 harness:

1. **用生产构建的编译 CSS,不用源码 CSS。** 找到构建产物里的样式文件(`dist/`、`build/`、`.next/` 等),复制进 harness。源码 CSS 验的是近似,编译产物才是产品——预处理器、压缩、autoprefixer 都可能改变最终层叠。
2. **harness HTML 用真实类名复刻目标场景。** 从产品 DOM 里抄结构和 class,不要手写近似样式。before/after 同页并排——一张截图直接回答「改动好在哪」。
3. **主题 token 注入。** 读项目的主题定义(CSS variables JSON / theme 文件),用 playwright 的 `page.evaluate`(或等价手段)把变量批量设到根元素上,与产品的 theme-loader 同语义。
4. **多主题矩阵一个不能少。** 至少 light/dark 各截一张;若产品有半透明/玻璃/壁纸类主题,它是**可读性的极限测试**(半透明底 + 任意背景),必须在列。每主题 fullPage 截图。
5. **动画冻结成静帧。** shimmer/pulse 类动画用 `animation-play-state: paused` 加负值 `animation-delay` 钉在特征帧上,静态截图才可检。
6. **截图归档为交付资产。** 命名带日期与场景,放进项目的文档资产目录——它们是验收证据,不是临时文件。

## Stage 2: 像素真值判据链

目视会骗人,且两个方向都骗:真浅色的图能被显示管道渲成深色(读图工具伪影),真白的底能让人以为「没截到」(实为 CSS 层叠 bug)。判据链逐级下钻,**任何一级与上一级矛盾时,信下一级**:

```
目视 → PNG 像素值 → computed style → CSS 层叠来源
```

读像素(三点采样:角落/中部/目标区域):

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add huiliyi37/tianshu-harness/visual-acceptance@sha256:2a554024263fc319

The line at the top of this page pins the label git:20260803.76ef549, 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 badge

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

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

Versions

The registry has recorded 1 version of this file, committed on Aug 3, 2026.

versioncommittedcommitsizeaudit
git:20260803.76ef549 latest2026-08-03 76ef549 4,961 BA 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 (4961 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

huiliyi37/tianshu-harness · 1,254 stars · license Apache-2.0 · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_y2n4mnb2sl6sf462
GET https://markdownregistry.com/api/v1/resolve?ref=huiliyi37/tianshu-harness/visual-acceptance
GET https://markdownregistry.com/api/v1/blob/2a554024263fc319cc2f68115f42854f8cbe878b72aded673a7a6ce4efd0f19e

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.

More from huiliyi37/tianshu-harness

AGENTS.md AGENTS.md file
huiliyi37/tianshu-harness · AGENTS.md
git:20261005.b60fe86 · audit A · 1,254 stars
CLAUDE.md CLAUDE.md file
huiliyi37/tianshu-harness · CLAUDE.md
git:20261026.f670653 · audit A · 1,254 stars
agent-harness-testing SKILL.md skill
huiliyi37/tianshu-harness · docs/skills/optional/agent-harness-testing/SKILL.md · 在任意项目中执行开发任务时的测试方法论——包括测试能力探测、RED→GREEN 纪律、探针管理、环境模拟、测试策略选择。当面对 bugfix、功能开发、重构等需要验证的代码改动时使用。
git:20260917.bf456db · audit A · 1,254 stars
design-prototype SKILL.md skill
huiliyi37/tianshu-harness · plugins/design/skills/design-prototype/SKILL.md · Frontend UI prototype workflow — clarify intent, explore directions, preview across viewports, diff against references…
git:20260720.5237f6c · audit A · 1,254 stars
office-docx SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-docx/skills/SKILL.md · 生成与读取 Word 文档(.docx)——报告、合同、交付文档、投标书;原生 docx 渲染,支持 heading/paragraph/table/code/list 内容块与居中标题
git:20260815.236a44b · audit A · 1,254 stars
office-excel SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-excel/skills/SKILL.md · Excel 电子表格读写与编辑最佳实践 — 用 xlsx_read/xlsx_write/xlsx_edit 处理 .xlsx 时遵守的公式、数字格式与可维护性纪律
git:20260720.5237f6c · audit A · 1,254 stars
office-pdf SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-pdf/skills/SKILL.md · 生成与读取 PDF 文档(报告、合同、交付文档)——原生 pdfkit 渲染,自动解析系统 CJK 字体支持中文,支持 heading/paragraph/table/code/list 内容块与页码页脚
git:20260720.5237f6c · audit A · 1,254 stars
office-ppt SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-ppt/skills/SKILL.md · PowerPoint 演示文稿生成纪律 — 用 pptx_create/pptx_read 产出有设计感、零 AI 味的 .pptx(PPT、幻灯片、deck、演讲稿、汇报)
git:20260720.5237f6c · audit A · 1,254 stars
brainstorming SKILL.md skill
huiliyi37/tianshu-harness · runtime-assets/bundled-skills/brainstorming/SKILL.md · You MUST use this before any creative work - creating features, building components, adding functionality, or modifying…
git:20260909.60a2332 · audit A · 1,254 stars
DESIGN.md@website DESIGN.md file
huiliyi37/tianshu-harness · website/DESIGN.md
git:20260731.0dde176 · audit A · 1,254 stars

Every file in huiliyi37/tianshu-harness

Browse by kind, by grade A, or by owner.