61 lines
3.8 KiB
Markdown
61 lines
3.8 KiB
Markdown
# le-app-design
|
||
|
||
> 统一 App 设计工坊：一个入口完成产品理解 → 视觉探索 → 设计规范 → Web 高保真原型 → 设计审查 → 优化迭代 → 交付。底层**真实集成并调用**三个上游 Skill，本 Skill 只做编排、协调与质量控制。
|
||
|
||
**状态**：rigorous 档（一处有意偏离：不设 reports/ 静态证据目录——本 skill 的验证形态是**每次运行现场再生**（依赖门 + 调用账本 + 验收门），静态示例会腐烂且冗余，历史记录由 git 提交承担。2026-11-07 与 Leroy 确认）。ZCode / Claude Code / Codex / OpenCode 通用。
|
||
|
||
## 它解决什么问题
|
||
|
||
你想要一个 App 从想法变成可交互的高保真原型，只需要说「帮我设计这个 App」。le-app-design 负责检测依赖、给三个上游分派岗位、串起全流程、留下可检查的调用证据：frontend-design 先定有品牌差异性的视觉方向，ui-ux-pro-max 把方向编撰成设计系统并对可访问性/触控等硬约束校验，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>/`），包括审查报告与集成证据，可复查。
|