Home / devcodex-labs / devcodex · GitHub

ux-interaction-architecture SKILL.md skillA

ux-interaction-architecture from devcodex-labs/devcodex is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add devcodex-labs/devcodex/ux-interaction-architecture@git:20260730.6ee304a

Pins git:20260730.6ee304a in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: devcodex-labs/devcodex
Path: content/skills/ux-interaction-architecture/SKILL.md
Versions recorded: 1
Latest version: git:20260730.6ee304a, committed Jul 30, 2026
Size: 4,072 bytes
Repository stars: 432
License: AGPL-3.0

UX 交互架构专家 Owner — 当任务涉及页面流程、信息架构、任务路径、交互状态、空/错/加载/恢复、可理解性、操作成本、键盘/无障碍触点或用户要求补充交互设计规范时使用；要求从用户任务和状态反馈闭环审查体验。.

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

# UX Interaction Architecture Skill

## 定位

本 Skill 负责交互架构 Owner 视角。它关注用户如何完成任务、如何理解页面、如何在空态/错误/等待/返回/恢复中不断线，而不是只评价视觉好不好看。

## 触发条件

| 场景 | 是否触发 |
|------|:--------:|
| 前端页面、后台工具、文档站、表单、列表、详情、编辑器、导航或多步骤流程 | 必须 |
| 用户提到交互设计、用户心智、是否能看懂、是否好用 | 必须 |
| 需要审查 loading、空态、错误、返回、缓存、保存、撤销、确认、批量操作 | 必须 |
| 纯后端内部接口，用户无直接交互路径 | N/A + skipReason |

## 核心门禁

| Gate | 要求 | 证据 |
|------|------|------|
| `UxInteractionArchitectureGate` | 每个关键页面或工具必须绑定任务流、状态反馈和恢复路径 | 需求、页面结构、用户文档、截图、运行验证 |
| `TaskFlowContinuityGate` | 用户从入口到完成任务不应出现断点、空白或不可恢复状态 | taskFlow、navigation、returnPath |
| `StateFeedbackGate` | 空态、加载、保存、错误、成功、禁用、离线、过期和冲突状态必须有清楚反馈 | stateFeedback |
| `RecoveryPathGate` | 错误、返回、失败保存、超时和数据刷新必须有恢复动作 | emptyErrorRecovery |
| `InteractionCostGate` | 高频任务要减少重复输入、无意义确认和跳转成本 | interactionCost |
| `AccessibilityTouchpointGate` | 关键控件、焦点、键盘、语义、对比度和可读性不得破坏主路径 | accessibilityTouchpoints |

## 执行步骤

1. 建立用户任务流：入口、关键动作、分支、完成状态和退出路径。
2. 建立信息架构：导航、层级、命名、分组、默认视图、详情与列表关系。
3. 枚举状态反馈：空、加载、旧缓存、成功、错误、禁用、保存中、冲突、过期。
4. 审查恢复路径：返回不丢数据、刷新不空白、失败能重试、取消能恢复。
5. 审查操作成本：高频动作是否需要更少点击、批量能力、默认值或快捷路径。
6. 若前端实现存在，按 `test-router` 选择静态、组件、E2E 或截图验证；没有明确要求时不强制打开浏览器。

## 输出字段

```markdown
## UxInteractionArchitectureGate

| 字段 | 内容 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add devcodex-labs/devcodex/ux-interaction-architecture@sha256:a42c1b8c4de81036

The line at the top of this page pins the label git:20260730.6ee304a, 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_rrexatn3y7glm7m5.svg)](https://markdownregistry.com/a/art_rrexatn3y7glm7m5)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 30, 2026.

version	committed	commit	size	audit
git:20260730.6ee304a latest	2026-07-30	6ee304a	4,072 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 (4072 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

devcodex-labs/devcodex · 432 stars · license AGPL-3.0 · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rrexatn3y7glm7m5
GET https://markdownregistry.com/api/v1/resolve?ref=devcodex-labs/devcodex/ux-interaction-architecture
GET https://markdownregistry.com/api/v1/blob/a42c1b8c4de8103677cd777a3866dbb064f059ad27a981b7412c534ee1fd134c

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 devcodex-labs/devcodex

accessibility-i18n SKILL.md skill

devcodex-labs/devcodex · content/skills/accessibility-i18n/SKILL.md · 无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用；要求把包容性体验和本地化验证绑定到真实用户路径。