# le-app-design

> 统一 App 设计工坊：一个入口完成产品理解 → 设计规范 → 视觉探索 → Web 高保真原型 → 设计审查 → 优化迭代 → 交付。底层**真实集成并调用**三个上游 Skill，本 Skill 只做编排、协调与质量控制。

**状态**：rigorous 档。ZCode / Claude Code / Codex / OpenCode 通用。

## 它解决什么问题

你想要一个 App 从想法变成可交互的高保真原型，只需要说「帮我设计这个 App」。le-app-design 负责检测依赖、给三个上游分派岗位、串起全流程、留下可检查的调用证据：ui-ux-pro-max 出设计规范与 UX 硬约束，frontend-design 出有品牌差异性的视觉方向，impeccable 做设计审查与反模式检测并盯着修复。你不需要知道三个上游各自怎么调。

## 三个上游依赖（必需，非可选）

| 上游 | 岗位 | 许可证 | 仓库 |
|---|---|---|---|
| ui-ux-pro-max | 设计规范生成 / UX 与可访问性数据检索 | MIT | github.com/nextlevelbuilder/ui-ux-pro-max-skill |
| frontend-design | 视觉创意 / 品牌差异化（Anthropic） | Apache-2.0 | github.com/anthropics/skills |
| impeccable | 设计审查 / 62 规则反模式检测 / 精修 | Apache-2.0 | github.com/pbakaus/impeccable |

本 Skill 不 vendoring、不修改、不复制三个上游的任何内容，只按其原生机制调用（CLI 执行 / 原文装载）。归属详见 [NOTICE](NOTICE)。

## 依赖安装

三份都装到 `~/.agents/skills/`（首选，impeccable 自引用该路径）：

```bash
# 示例：ui-ux-pro-max
git clone --depth 1 https://github.com/nextlevelbuilder/ui-ux-pro-max-skill /tmp/uiux
ln -s /tmp/uiux/.claude/skills/ui-ux-pro-max ~/.agents/skills/ui-ux-pro-max
# frontend-design: git clone anthropics/skills → skills/frontend-design
# impeccable:      git clone pbakaus/impeccable → 整目录链接
```

Codex 侧还需链接到 `~/.codex/skills/`。装完验证：

```bash
python3 <本目录>/scripts/check_deps.py
```

三方全绿才可使用；缺任何一个，触发本 Skill 时会明确报缺并终止，不会假装集成成功。

## 触发方式

- 帮我设计一个习惯打卡 App，要高保真原型
- 把这个产品想法做成可交互的 UI 原型
- 给我的工具类产品做一轮完整的设计 + 审查 + 改进
- design an app prototype for …

不触发：点名单个上游（「用 impeccable 审查」）、公众号文章/海报排版、只要一张配图、纯功能开发。

## 核心机制（为什么这是真集成）

- **硬依赖门** `scripts/check_deps.py`：按依赖各自形态做活性检查——pro-max 真跑一次检索、impeccable 跑二进制 `--version`、frontend-design 校验原文完整可读（含 sha256）。缺则终止。
- **证据账本** `scripts/log_call.py`：每次对上游的调用（CLI 执行与原文装载）都落 `calls.jsonl`——时间、命令、退出码、stdout 摘要、装载文件的 sha256。没进账本的调用视为没发生。
- **验收门** `scripts/evidence_report.py`：三方各有 ≥1 条成功调用才判 PASS；否则 FAIL 并列出缺口，禁止把未完成的流程标记为成功。

## 安全边界

- 三个上游目录只读；本 Skill 的任何流程都不修改它们。
- 停点 1（设计方向确认）与停点 2（修复范围确认）会停下来等你；说「一口气跑完」可豁免停点，但豁免不了铁律与验收门。
- 交付产物全部落盘（运行目录 `le-app-design-runs/<id>/`），包括审查报告与集成证据，可复查。