Back to Details

reality-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Reality Skill

Reality Skill

Reality Skill removes demoware.
A screen is not a product. A workflow is real only when a user can complete the primary job end-to-end with working actions, truthful data, state coverage, validation, persistence or an honest mock boundary, recovery paths, and no fake capability presented as real.
Reality Skill 旨在消除演示性伪功能（demoware）。
一个屏幕不等于一款产品。只有当用户能够通过可正常工作的操作、真实的数据、完整的状态覆盖、校验机制、数据持久化（或明确的模拟边界）、错误恢复路径完成核心任务的端到端流程，且不存在虚假功能伪装成真功能的情况时，这个工作流才是真实可用的。

Core Rule

核心原则

Do not make the UI bigger. Make the user job finishable.
Prefer the smallest implementation that turns the current surface from a static or deceptive demo into an honest, usable workflow.
不要扩大UI范围，要确保用户能够完成任务。 优先选择最小化的实现方案，将当前的静态或具有欺骗性的演示界面转化为诚实、可用的工作流。

Workflow

工作流程

  1. Identify the primary user job.
  2. Trace the workflow from entry to completion.
  3. List every fake, missing, decorative, dead, or dishonest element.
  4. Fix the smallest set of files needed to make the workflow real.
  5. Verify the workflow with tests, build checks, browser checks, or a clear manual path when tools are limited.
  1. 确定用户的核心任务。
  2. 追踪从入口到完成的完整工作流。
  3. 列出所有虚假、缺失、装饰性、无效或不诚实的元素。
  4. 修改最少的文件，使工作流变为真实可用。
  5. 通过测试、构建检查、浏览器检查验证工作流；若工具受限，则使用明确的手动验证路径。

The Seven Reality Gates

七大真实校验关卡

1. Action Gate

1. 操作关卡

Every primary action must work, open a real path, or be visibly disabled with a reason.
Block:
  • href="#"
  • console.log
    -only submit handlers
  • buttons with no handler
  • fake "Save", "Deploy", "Pay", "Connect", "Generate", or "Invite" actions
  • destructive actions without confirmation or undo where appropriate
每个核心操作必须可正常工作、指向真实路径，或明确禁用并说明原因。
禁止：
  • href="#"
  • 仅含
    console.log
    的提交处理程序
  • 无处理程序的按钮
  • 虚假的“保存”“部署”“支付”“连接”“生成”或“邀请”操作
  • 未提供确认或撤销机制的破坏性操作（如适用）

2. Data Gate

2. 数据关卡

Data must be truthful.
Real data is best. Local mock data is acceptable only when the boundary is honest and does not pretend to be production truth.
Block:
  • fake metrics presented as real
  • fake testimonials, logos, users, revenue, uptime, or AI results
  • decorative charts with no labels, units, source, or decision path
  • duplicated placeholder rows that imply real usage
数据必须真实可信。 真实数据为最优选择。仅当边界明确且不伪装成生产环境真实数据时，本地模拟数据才是可接受的。
禁止：
  • 伪装成真实数据的虚假指标
  • 虚假的推荐语、品牌标识、用户、收入、正常运行时间或AI结果
  • 无标签、单位、数据源或决策路径的装饰性图表
  • 重复的占位行（暗示真实使用场景）

3. State Gate

3. 状态关卡

The relevant states must exist.
Check for:
  • loading
  • empty
  • error
  • disabled
  • success
  • partial data
  • long content
  • small screen
Do not add every state everywhere. Add the states needed for the workflow the user is actually trying to complete.
必须包含相关状态。
需检查：
  • 加载中
  • 空状态
  • 错误状态
  • 禁用状态
  • 成功状态
  • 部分数据状态
  • 长内容状态
  • 小屏幕状态
无需在所有地方添加所有状态，只需添加用户实际完成工作流所需的状态。

4. Persistence Gate

4. 持久化关卡

User-created or edited data must survive the immediate workflow.
Acceptable persistence, depending on the project:
  • server/database/API
  • existing app state store
  • local storage
  • URL state
  • durable in-memory state for one-page prototypes, if clearly scoped
If persistence is intentionally mocked, make the boundary explicit in code and avoid UI language that implies production storage.
用户创建或编辑的数据必须在当前工作流结束后仍能保留。
根据项目情况，可接受的持久化方式包括：
  • 服务器/数据库/API
  • 现有应用状态存储
  • localStorage
  • URL状态
  • 单页原型的持久化内存状态（若范围明确）
如果故意模拟持久化，需在代码中明确标注边界，且避免使用暗示生产环境存储的UI语言。

5. Navigation Gate

5. 导航关卡

Users must not hit dead ends.
Check for:
  • back paths
  • cancel paths
  • retry paths
  • edit paths
  • delete/recover paths
  • return-to-list/detail paths
  • active navigation state
用户不得陷入死胡同。
需检查：
  • 返回路径
  • 取消路径
  • 重试路径
  • 编辑路径
  • 删除/恢复路径
  • 返回列表/详情页路径
  • 活跃导航状态

6. Validation Gate

6. 校验关卡

Forms and inputs must reject bad input with clear inline feedback.
Check for:
  • required fields
  • malformed email/URL/number/date values
  • min/max length or quantity
  • disabled submit while invalid or submitting
  • useful error text near the field
  • preservation of user input after an error
表单和输入框必须拒绝无效输入，并提供清晰的内联反馈。
需检查：
  • 必填字段
  • 格式错误的邮箱/URL/数字/日期值
  • 最小/最大长度或数量限制
  • 无效或提交中禁用提交按钮
  • 输入框附近的有用错误提示文本
  • 错误发生后保留用户输入内容

7. Truth Gate

7. 真实性关卡

The UI must not pretend a fake capability is real.
Block fake:
  • authentication
  • payments
  • AI generation
  • integrations
  • analytics
  • security claims
  • compliance claims
  • notifications
  • exports
  • team invites
If the real backend or service is unavailable, create an honest local/mock boundary and name it plainly. Do not invent production behavior.
UI不得将虚假功能伪装成真功能。
禁止伪装以下功能：
  • 身份验证
  • 支付
  • AI生成
  • 集成功能
  • 分析功能
  • 安全声明
  • 合规声明
  • 通知
  • 导出
  • 团队邀请
若真实后端或服务不可用，需创建明确的本地/模拟边界，并清晰命名。不得虚构生产环境行为。

Common Fix Patterns

常见修复模式

  • Replace a dead button with a working local state transition.
  • Replace decorative mock rows with add/edit/delete flows.
  • Add localStorage when a prototype needs refresh-safe data.
  • Add inline validation before submit.
  • Add empty/error/loading states around existing data calls.
  • Replace fake dashboard claims with clearly labeled sample data.
  • Add cancel, back, retry, and success paths.
  • Disable unavailable integrations instead of pretending they work.
  • Preserve the existing visual design unless it blocks the workflow.
  • 用可正常工作的本地状态转换替换无效按钮。
  • 用添加/编辑/删除流程替换装饰性模拟行。
  • 当原型需要刷新后仍保留数据时，添加localStorage。
  • 在提交前添加内联校验。
  • 在现有数据调用周围添加空/错误/加载状态。
  • 用明确标注的示例数据替换虚假的仪表板声明。
  • 添加取消、返回、重试和成功路径。
  • 禁用不可用的集成功能，而非伪装其可用。
  • 保留现有视觉设计，除非它阻碍工作流。

Non-Negotiables

不可协商规则

  • Do not stop at static UI when the task asks for an app, tool, dashboard, form, or workflow.
  • Do not leave TODOs, placeholder handlers, dead links, fake submit buttons, or fake success states.
  • Do not invent production services, credentials, customers, payments, metrics, or claims.
  • Do not rewrite the product broadly when a smaller reality fix will complete the job.
  • Do not remove useful design polish unless it hides fake functionality or blocks usability.
  • Preserve accessibility, semantics, keyboard paths, and responsive behavior.
  • 当任务要求开发应用、工具、仪表板、表单或工作流时，不得停留在静态UI阶段。
  • 不得留下TODO、占位处理程序、无效链接、虚假提交按钮或虚假成功状态。
  • 不得虚构生产服务、凭证、客户、支付、指标或声明。
  • 当较小的真实化修复即可完成任务时，不得大规模重写产品。
  • 不得移除有用的设计细节，除非它隐藏虚假功能或阻碍可用性。
  • 保留可访问性、语义化、键盘导航路径和响应式行为。

Output Contract

输出约定

When using this skill, report:
text
Primary job:
Reality gate:
Blockers found:
Files changed:
Verification:
Remaining fake boundaries:
Use 
Remaining fake boundaries: None
only when every relevant fake boundary has been removed, implemented, disabled, or honestly labeled.
使用此Skill时，需报告：
text
Primary job:
Reality gate:
Blockers found:
Files changed:
Verification:
Remaining fake boundaries:
仅当所有相关虚假边界已被移除、实现、禁用或明确标注时，才可使用
Remaining fake boundaries: None
。

Done Means

完成标准

  • The primary user job can be completed end-to-end.
  • Primary actions are real or honestly unavailable.
  • Data is real, user-created, or clearly marked as sample/mock.
  • Relevant states and validation exist.
  • Persistence is implemented or the mock boundary is explicit.
  • The user has recovery/navigation paths.
  • Verification was run or the exact limitation is stated.
  • 用户可端到端完成核心任务。
  • 核心操作真实可用或明确标注为不可用。
  • 数据为真实数据、用户创建数据，或明确标记为示例/模拟数据。
  • 包含相关状态和校验机制。
  • 已实现持久化，或模拟边界明确。
  • 用户拥有恢复/导航路径。
  • 已完成验证，或明确说明限制。