页面状态审查skill

将真实业务规则转化为可实现、可审查的页面与模块状态规范。

它帮助产品、设计和研发在生成或审查状态目录时，区分真实空态、加载、失败、不可用、降级与高风险状态，避免为了“补齐状态”而创造不存在的业务情形。

适用场景

• 梳理页面或模块的正常态与异常态
• 审查现有状态设计的真实性、优先级和恢复路径
• 生成状态目录或状态样本规范
• 为加载、失败、超期、权限不足、局部不可用等情况补齐可落地的展示规则

不适用场景

• 单纯视觉改版或组件重绘
• 没有状态问题的普通 UI 微调
• 将特定项目的主题、尺寸、文案或领域规则当作通用规范

安装

将仓库克隆到 Codex 的个人 Skills 目录，并将目录命名为 page-state-review：

git clone https://github.com/<your-github-id>/page-state-review-skill.git ~/.codex/skills/page-state-review

也可以直接下载仓库，将其内容复制到 ~/.codex/skills/page-state-review。

使用

在 Codex 中输入：

$page-state-review

例如：

使用 $page-state-review 梳理订单详情页各模块的正常态和异常态，先输出状态矩阵，不修改页面。

核心原则

1. 只设计真实可能发生的状态。
2. 每个状态都应有明确的触发条件、影响、恢复方式和优先级。
3. 局部异常只替换局部模块，保留用户上下文。
4. 状态样本复用真实模块结构和自然尺寸；同一模块以完整正常态为高度基准。
5. 只有存在明确解决路径时才展示快捷操作；状态目录中的控件仅作视觉展示。
6. 时间边界依据当前时间和业务规则判断；每个状态都可追溯到对应页面、规则或数据来源。

完整工作方式见 SKILL.md，逐项检查见状态判定清单。

贡献

欢迎通过 Issue 或 Pull Request 提出改进。提交前请确保新增内容是跨项目可复用的规则，而不是单个项目的品牌、固定尺寸、具体业务文案或私有资料。详见 CONTRIBUTING.md。

许可

本项目采用 MIT License。