le-app-design v1.0.0：统一 App 设计工坊——真实集成并调用三上游的编排器。ui-ux-pro-max（MIT，search.py 设计系统/规范检索）+ frontend-design（Apache-2.0，Skill 工具装载的视觉 design lead）+ impeccable（Apache-2.0，CLI 检测器+playbook 审查）；三机制保证真集成可验证：check_deps 硬依赖门（缺即终止）、log_call 证据账本（调用落 calls.jsonl 含装载 sha256）、evidence_report 验收门（三方各 ≥1 成功调用才 PASS）；S0–S7 流水线含两个回合终止停点与轻量任务路由；E2E 已真跑（习惯打卡 App 双屏原型）：7 条真实调用留账、双独立 sub-agent 评审 26/36 + detect 2 findings、修复 3×P1 后字阶清零、交互复测 4/4、验收门 PASS；上游三件补装 ~/.codex/skills，仓库 README 同步
This commit is contained in:
leroy
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> *「把重复出现的方法，变成可触发、可验证、可维护的 Skill。」*
|
> *「把重复出现的方法，变成可触发、可验证、可维护的 Skill。」*
|
||||||
|
|
||||||
MetaSkill 是 Leroy 的个人 Skill 仓库：**le-meta-skill**（Skill 工坊）与其实战技能 **le-wechat-article**（公众号写作工坊）、**le-gpt-image**（无 Key GPT Image 生图工坊）。ZCode / Claude Code / Codex 通用。
|
MetaSkill 是 Leroy 的个人 Skill 仓库：**le-meta-skill**（Skill 工坊）与其实战技能 **le-wechat-article**（公众号写作工坊）、**le-gpt-image**（无 Key GPT Image 生图工坊）、**le-app-design**（统一 App 设计工坊）。ZCode / Claude Code / Codex 通用。
|
||||||
|
|
||||||
## 仓库结构
|
## 仓库结构
|
||||||
|
|
||||||
@@ -19,10 +19,15 @@ skills/
|
|||||||
│ ├── references/ # 6 篇：五类型路由·排版规则·审读手册（含合规）·视觉生产·作者画像·常用事实卡
|
│ ├── references/ # 6 篇：五类型路由·排版规则·审读手册（含合规）·视觉生产·作者画像·常用事实卡
|
||||||
│ ├── scripts/ # check_article（硬规则自检）/ md2wechat（3 骨架×4 色板转微信 HTML）/ publish_draft（草稿箱同步，零依赖）
|
│ ├── scripts/ # check_article（硬规则自检）/ md2wechat（3 骨架×4 色板转微信 HTML）/ publish_draft（草稿箱同步，零依赖）
|
||||||
│ └── evals/ reports/
|
│ └── evals/ reports/
|
||||||
└── le-gpt-image/ # 无 Key GPT Image 生图工坊
|
├── le-gpt-image/ # 无 Key GPT Image 生图工坊
|
||||||
├── SKILL.md # 工作流：接单→停点确认→生成交付；能力边界 / 尺寸质量速查 / 故障排查
|
│ ├── SKILL.md # 工作流：接单→停点确认→生成交付；能力边界 / 尺寸质量速查 / 故障排查
|
||||||
├── references/ # prompt-craft：结构公式·文字渲染·摄影/插画/信息图·中文东方风格·改图指令·反模式
|
│ ├── references/ # prompt-craft：结构公式·文字渲染·摄影/插画/信息图·中文东方风格·改图指令·反模式
|
||||||
└── scripts/ # gpt_image.py（零依赖：Codex 凭证直连内部图像通道，token 自动刷新）
|
│ └── scripts/ # gpt_image.py（零依赖：Codex 凭证直连内部图像通道，token 自动刷新）
|
||||||
|
└── le-app-design/ # 统一 App 设计工坊（编排器）
|
||||||
|
├── SKILL.md # S0–S7 流水线：依赖门→产品理解→规范→视觉→构建→审查→迭代→验收；六铁律 + 岗位裁决表
|
||||||
|
├── references/ # pipeline（七阶段细则）· runtimes（四 runtime 适配矩阵）
|
||||||
|
├── scripts/ # check_deps（硬依赖门）/ log_call（调用证据账本）/ evidence_report（验收门），纯标准库
|
||||||
|
└── evals/ reports/ # 触发用例 + 集成测试证据（calls.jsonl / 截图 / 审查报告）
|
||||||
```
|
```
|
||||||
|
|
||||||
## le-meta-skill —— Skill 工坊
|
## le-meta-skill —— Skill 工坊
|
||||||
@@ -85,6 +90,21 @@ skills/
|
|||||||
|
|
||||||
安全边界：凭证只读不打印不外发；内部接口无稳定性契约（native 失效可切 responses 备用通道）；内容政策拒绝即停，不换措辞绕过。
|
安全边界：凭证只读不打印不外发；内部接口无稳定性契约（native 失效可切 responses 备用通道）；内容政策拒绝即停，不换措辞绕过。
|
||||||
|
|
||||||
|
## le-app-design —— 统一 App 设计工坊
|
||||||
|
|
||||||
|
一个入口（「帮我设计这个 App」）跑完产品理解 → 设计规范 → 视觉探索 → Web 高保真原型 → 设计审查 → 优化迭代 → 交付。它不是借鉴了三个开源 Skill 的新 Skill，而是**真正集成并调用**三个上游的编排器：
|
||||||
|
|
||||||
|
- **ui-ux-pro-max**（MIT）：`search.py` CLI 真跑 `--design-system --persist` 生成 MASTER.md，UX/可访问性/触控规范走数据检索——设计规范的硬约束来源
|
||||||
|
- **frontend-design**（Apache-2.0, Anthropic）：经宿主 Skill 工具装载（或 Read 原文全文，一等路径）——视觉方向与品牌差异化的 design lead
|
||||||
|
- **impeccable**（Apache-2.0, pbakaus）：`impeccable` CLI（context / detect 62 规则 / critique-storage）+ playbook 装载照做——审查、精修与质量底线
|
||||||
|
- **三个机制保证「真集成」可验证**：`check_deps.py` 硬依赖门（缺任何一个即终止并报安装指引）、`log_call.py` 证据账本（每次调用落 calls.jsonl，含装载文件的 sha256）、`evidence_report.py` 验收门（三方各有 ≥1 条成功调用才许宣称完成）。已跑通完整 E2E（习惯打卡 App 双屏原型）：三上游真实调用 7 条留账、双独立 sub-agent 评审 26/36、修复 3×P1 后复测清零——证据见 [reports/](skills/le-app-design/reports/integration-test-2026-11-07.md)
|
||||||
|
|
||||||
|
触发方式：「帮我设计一个 App」「做一个高保真原型」「把首页和详情页这些界面设计出来」。点名单个上游（「用 impeccable 审查」）不触发，直连对应 Skill。
|
||||||
|
|
||||||
|
依赖安装：三个上游需装到 `~/.agents/skills/`（Codex 侧另链 `~/.codex/skills/`），详见 [skills/le-app-design/README.md](skills/le-app-design/README.md)。不 vendoring、不修改上游（归属见其 NOTICE）。
|
||||||
|
|
||||||
|
安全边界：上游目录只读；停点 1（设计方向）与停点 2（修复范围）为回合终止点，「一口气跑完」仅豁免停点、不豁免铁律与验收门。
|
||||||
|
|
||||||
## 安装
|
## 安装
|
||||||
|
|
||||||
三个 runtime 读的都是同一套 SKILL.md 开放格式，脚本只用 python3 标准库。把要装的 skill 软链到对应位置即可：
|
三个 runtime 读的都是同一套 SKILL.md 开放格式，脚本只用 python3 标准库。把要装的 skill 软链到对应位置即可：
|
||||||
@@ -99,7 +119,7 @@ mkdir -p ~/.claude/skills && ln -s <克隆路径>/skills/le-wechat-article ~/.cl
|
|||||||
mkdir -p ~/.codex/skills && ln -s <克隆路径>/skills/le-wechat-article ~/.codex/skills/le-wechat-article
|
mkdir -p ~/.codex/skills && ln -s <克隆路径>/skills/le-wechat-article ~/.codex/skills/le-wechat-article
|
||||||
```
|
```
|
||||||
|
|
||||||
装 le-meta-skill、le-gpt-image 同理，把路径换成对应 skill 目录。
|
装 le-meta-skill、le-gpt-image 同理，把路径换成对应 skill 目录。装 le-app-design 还需先装三个上游依赖（ui-ux-pro-max / frontend-design / impeccable），并用其 `scripts/check_deps.py` 验证三方全绿。
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,27 @@
|
|||||||
|
# NOTICE — 第三方依赖归属
|
||||||
|
|
||||||
|
le-app-design 是一个编排器 Skill：运行时按各自原生机制调用以下三个上游
|
||||||
|
Skill（CLI 执行 / 原文装载），不分发、不内嵌、不修改它们的任何内容。
|
||||||
|
本仓库遵循各上游许可证条款，特此归属：
|
||||||
|
|
||||||
|
## ui-ux-pro-max
|
||||||
|
- 上游: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
|
||||||
|
- 许可证: MIT © nextlevelbuilder
|
||||||
|
- 调用方式: 执行其 scripts/search.py（设计系统生成与域检索），读取其 data/*.csv 经由该 CLI
|
||||||
|
- 本仓库不包含其源码副本
|
||||||
|
|
||||||
|
## frontend-design
|
||||||
|
- 上游: https://github.com/anthropics/skills （skills/frontend-design）
|
||||||
|
- 许可证: Apache-2.0 © Anthropic PBC（其 SKILL.md 附 LICENSE.txt 全文）
|
||||||
|
- 调用方式: 宿主 Skill 工具装载，或 Read 其 SKILL.md 原文全文进执行上下文
|
||||||
|
- 本仓库不包含其源码副本
|
||||||
|
|
||||||
|
## impeccable
|
||||||
|
- 上游: https://github.com/pbakaus/impeccable
|
||||||
|
- 许可证: Apache-2.0 © Patrick Bakaus
|
||||||
|
- 调用方式: 执行其 scripts/impeccable CLI（context / detect / critique-storage…），
|
||||||
|
并按其 SKILL.md 路由装载 reference/*.md playbook 照做
|
||||||
|
- 本仓库不包含其源码副本
|
||||||
|
|
||||||
|
---
|
||||||
|
le-app-design 自身以仓库根 LICENSE（MIT, © 2026 Leroy）发布。
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
# 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>/`），包括审查报告与集成证据，可复查。
|
||||||
@@ -0,0 +1,130 @@
|
|||||||
|
---
|
||||||
|
name: le-app-design
|
||||||
|
description: |
|
||||||
|
Le App Design —— 统一 App 设计工坊：只叫这一个名字，自动完成「产品理解 → 设计规范 → 视觉探索 → Web 高保真原型 → 设计审查 → 优化迭代 → 交付」。底层真实集成并调用三个上游 Skill——ui-ux-pro-max（设计规范/UX 数据检索引擎）、frontend-design（视觉创意与品牌差异化）、impeccable（设计审查/精修/反模式检测）；本 Skill 只做依赖检测、任务分配、执行协调与质量控制，绝不替代三者任何能力。
|
||||||
|
何时触发：想要完整的 App / 产品 UI 设计流程——"帮我设计一个 App""做一个高保真原型""从想法到可交互原型""给这个产品做 UI 设计和原型""design an app"；或指定若干界面做设计——"把首页和详情页这些界面设计出来""做移动端的页面/界面设计""App 界面改版"。
|
||||||
|
不要触发：点名单个上游 Skill 的直接请求（直连该上游即可）；写作与排版类任务；单张配图生成；纯功能开发与排障（无设计诉求）。
|
||||||
|
metadata:
|
||||||
|
author: Leroy
|
||||||
|
version: 1.0.0
|
||||||
|
runtimes: zcode, claude-code, codex, opencode
|
||||||
|
requires:
|
||||||
|
- "ui-ux-pro-max (MIT, nextlevelbuilder/ui-ux-pro-max-skill)"
|
||||||
|
- "frontend-design (Apache-2.0, anthropics/skills)"
|
||||||
|
- "impeccable (Apache-2.0, pbakaus/impeccable)"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Le App Design —— 统一 App 设计工坊
|
||||||
|
|
||||||
|
一个入口，三个真依赖。用户只说「帮我设计这个 App」，本 Skill 编排三个上游 Skill 完成从理解到交付的全流程。
|
||||||
|
|
||||||
|
## 铁律（违反任何一条即本次运行失败）
|
||||||
|
|
||||||
|
1. **真调用，不冒充。** 三个上游必须以其原生形态被实际调用：ui-ux-pro-max 跑它的 `search.py` CLI；impeccable 跑它的 `impeccable` CLI 并按其 SKILL.md 路由装载 reference/*.md playbook 照做；frontend-design 经宿主 Skill 工具装载（或 Read 原文全文）。禁止只引用名字、模仿理念、用自写流程替代。
|
||||||
|
2. **依赖门不过，不许动工。** S0 检测到任何一个上游缺失/失活，立即向用户报告缺什么、怎么装，终止本次运行。不许跳过、不许假装集成完成。
|
||||||
|
3. **调用必记账。** 每次对上游的调用（含 playbook/文档装载）都经 `log_call.py` 落入本次运行目录的 `calls.jsonl`。没进账本的调用视为没发生。
|
||||||
|
4. **交付必过验收门。** S7 跑 `evidence_report.py`，三方各有 ≥1 条成功调用记录才可宣称完成；否则如实报告 FAIL 与原因。
|
||||||
|
5. **不改上游。** 三个上游目录只读（调用、装载），任何修改都不属于本 Skill 的职责。
|
||||||
|
6. **用户 brief 原话 > 一切。** 三个上游都自认 brief 优先，本 Skill 同样：brief 钉死的方向照办，冲突记入决策日志。
|
||||||
|
|
||||||
|
## 岗位分工（冲突时按此裁决）
|
||||||
|
|
||||||
|
| 维度 | 主责 | 裁决 |
|
||||||
|
|---|---|---|
|
||||||
|
| 视觉方向、品牌差异化、排版个性 | frontend-design（design lead） | 美学轴自由时听它的 POV，拒绝模板脸 |
|
||||||
|
| 设计规范、可访问性、触控/平台规则、数据支撑选型 | ui-ux-pro-max | **硬约束**：WCAG/HIG/MD 类规则赢过美学偏好 |
|
||||||
|
| 质量底线、验收标准、反模式 | impeccable | craft-floor 的 ban 是红线（如 eyebrow 禁令、嵌套卡片必错） |
|
||||||
|
| 产品事实、范围、语气 | 用户 brief | 最高优先级 |
|
||||||
|
|
||||||
|
## 工作流 S0–S7
|
||||||
|
|
||||||
|
细则（每阶段的动作、命令、产物、验收）见 [pipeline.md](references/pipeline.md)；跨 runtime 适配见 [runtimes.md](references/runtimes.md)。设 `<SKILL>` = 本 Skill 目录，`<RUN>` = 运行目录（默认 `<项目根>/le-app-design-runs/<时间戳>-<slug>/`，下同）。
|
||||||
|
|
||||||
|
### S0 依赖门（每次触发必跑，轻量任务也不例外）
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/check_deps.py --out <RUN>/deps.json
|
||||||
|
```
|
||||||
|
|
||||||
|
三方解析 + 活性检查（pro-max 真跑一次检索、impeccable 跑 `--version`、frontend-design 校验原文完整可读）。非零退出 → 停止并报告缺失项与安装指引，本次运行终止。
|
||||||
|
|
||||||
|
### S1 产品理解
|
||||||
|
|
||||||
|
产出 `<RUN>/BRIEF.md`：产品是什么、给谁、核心任务、平台与形态（移动 Web / 桌面 / 响应式）、impeccable 四模式归属（Persuade / Operate / Read / Experience）。brief 信息不足且影响方向 → 问用户；足够 → 写明假设直接做。
|
||||||
|
|
||||||
|
### S2 设计规范 — ui-ux-pro-max
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> -- \
|
||||||
|
python3 <DEP_UIUX>/scripts/search.py "<产品类型 关键词>" --design-system --persist -p "<项目名>" --output-dir <项目根>
|
||||||
|
```
|
||||||
|
|
||||||
|
产出 `design-system/<slug>/MASTER.md`。按需补 `--domain ux|typography|color|landing`、`--stack <栈>` 定向检索（每次都走 log_call）。规范冲突时本阶段数据优先于直觉。
|
||||||
|
|
||||||
|
### S3 视觉探索 — frontend-design
|
||||||
|
|
||||||
|
1. 宿主有 Skill 工具（ZCode / Claude Code）→ 用它装载 `frontend-design`；没有 → Read `<DEP_FD>/SKILL.md` 全文进上下文（一等路径，不是降级）。
|
||||||
|
2. 装载后立即记账：`python3 <SKILL>/scripts/log_call.py frontend-design --run-dir <RUN> --load <DEP_FD>/SKILL.md`
|
||||||
|
3. 按其「两遍法」产出 `<RUN>/design-plan.md`：色板（4–6 个具名 hex）、字体与角色、布局概念（一句话 + ASCII）、设计原则；对照它的 AI 味特征清单逐条自检，修订要写明改了什么、为什么。
|
||||||
|
4. 与 S2 的 MASTER.md 冲突时按上方裁决表处理，冲突与裁决记入 design-plan.md 的「决策记录」节。
|
||||||
|
|
||||||
|
### 停点 1（回合终止点）
|
||||||
|
|
||||||
|
向用户展示 BRIEF + MASTER 要点 + design-plan，等确认或调整后再进构建。用户已明确说「一口气跑完」→ 豁免本停点，继续。**本停点必须终止回合等待用户，不得自答自继续。**
|
||||||
|
|
||||||
|
### S4 高保真构建
|
||||||
|
|
||||||
|
1. Read `<DEP_IMPECCABLE>/reference/craft-floor.md`（impeccable 施工底线，装载即调用）并记账 `log_call.py impeccable --load <该文件>`。
|
||||||
|
2. 照 MASTER.md tokens + design-plan 写可运行、可交互的 Web 原型（默认单文件或多文件 HTML/CSS/JS，无构建链）。
|
||||||
|
3. headless Chrome 截图核对（375/390 移动档 + 桌面档），按 craft-floor「一次看一批」原则修完再截。
|
||||||
|
|
||||||
|
### S5 设计审查 — impeccable
|
||||||
|
|
||||||
|
1. `log_call.py impeccable -- sh <DEP_IMPECCABLE>/scripts/impeccable context --target <主文件>`，按其指令行事。
|
||||||
|
2. 按其 SKILL.md 路由装载 `reference/critique.md`（+ 需要的 audit/craft-floor 等）并照做——critique 要求**双独立 sub-agent**（Assessment A 设计评审 / Assessment B detect+浏览器证据）：ZCode/Claude Code 用 Agent 工具并行派两个；Codex 按 critique.md 的 Codex 门问询；无 sub-agent 的 runtime 按其降级规则出横幅。playbook 装载逐一记账。
|
||||||
|
3. Assessment B 真跑：`log_call.py impeccable -- sh <DEP_IMPECCABLE>/scripts/impeccable detect --json <文件>`；可浏览器时按 playbook 走 overlay/截图证据。
|
||||||
|
4. 按 critique.md 完整出报告（启发式评分表、persona 红旗、P0–P3、快照持久化 + trend）。
|
||||||
|
|
||||||
|
### 停点 2（回合终止点）
|
||||||
|
|
||||||
|
展示审查报告，与用户确认修复范围（全部 / Top 3 / 仅 P0-P1）再进 S6。「一口气跑完」豁免同上。
|
||||||
|
|
||||||
|
### S6 优化迭代
|
||||||
|
|
||||||
|
按确认的范围修复：P0/P1 必修；修完复跑 `detect --json` 至 0 findings（或记明剩余项与理由）；复截图核对视觉。涉及大改方向的回到 S3 重走（罕见）。
|
||||||
|
|
||||||
|
### S7 交付 + 验收门
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/evidence_report.py --run-dir <RUN> --out <RUN>/INTEGRATION-REPORT.md \
|
||||||
|
--artifact <原型主文件> --artifact <截图...>
|
||||||
|
```
|
||||||
|
|
||||||
|
交付物 = 原型（可打开可交互）+ BRIEF/design-plan/MASTER + 审查报告与快照 + INTEGRATION-REPORT（三方调用统计、命令清单、产物存在性核验）。报告 FAIL（任何一方 0 成功调用）→ 不许宣称完成，如实说明缺什么。
|
||||||
|
|
||||||
|
## 轻量任务路由
|
||||||
|
|
||||||
|
- **仅审查/体检**（「帮我审一下这个原型的设计」）：S0 → S5（→停点2）→ S6 → S7。
|
||||||
|
- **局部修改**（「把这个页面间距调好」）：S0 → 若涉及视觉决策走 S3 快速版 → S4′（craft-floor 装载后施工）→ S5′（detect+复截）→ S7。
|
||||||
|
- 三上游经 check_deps 解析后始终可调用；轻量路由是省阶段，不是换实现。
|
||||||
|
|
||||||
|
## 失败模式与停手点
|
||||||
|
|
||||||
|
- 依赖缺失/失活：S0 即停，报缺失项与安装指引（见 README「依赖安装」）。
|
||||||
|
- 上游 CLI 中途失败：重试一次；仍失败 → 记账（账本保留失败记录）、报告用户、终止或按用户指示降级到其余上游可覆盖的范围，并在交付物中明确标注缺口。
|
||||||
|
- Chrome/浏览器不可用：截图核对改为声明 fallback（craft-floor 逐条人工核对），在报告中注明。
|
||||||
|
- 用户点名单一上游：不触发本 Skill（负触发已在 description 声明）。
|
||||||
|
|
||||||
|
## 反例黑名单
|
||||||
|
|
||||||
|
- 不要在账本外「顺手」直接调上游——没记账的调用等于没发生。
|
||||||
|
- 不要把三个上游的文档内容抄进本 Skill 或其 references 来「省一次装载」。
|
||||||
|
- 不要因为某上游慢/临时失败就用自己的设计判断顶替其岗位并照常宣称完成。
|
||||||
|
- 不要在停点自问自答继续跑；豁免只能来自用户明确授权。
|
||||||
|
- 不要检测到依赖缺失还继续产出「设计」——那是没有集成的假成功。
|
||||||
|
|
||||||
|
## Reference Map
|
||||||
|
|
||||||
|
- 七阶段细则与验收：[pipeline.md](references/pipeline.md)
|
||||||
|
- 跨 runtime 适配与已知限制：[runtimes.md](references/runtimes.md)
|
||||||
|
- 依赖安装与许可证：[README.md](README.md)、[NOTICE](NOTICE)
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"_说明": "le-app-design 触发用例。family 标注场景族，便于回归分析。",
|
||||||
|
"recommended_threshold": 0.3,
|
||||||
|
"negative_patterns": ["用 impeccable", "impeccable 审查", "ui-ux-pro-max", "查个配色", "公众号", "写一篇"],
|
||||||
|
"should_trigger": [
|
||||||
|
{"text": "帮我设计一个习惯打卡 App，要能看的高保真原型", "family": "full_design_cn"},
|
||||||
|
{"text": "把这个产品想法做成可交互的 UI 原型，从设计到成品", "family": "full_design_cn"},
|
||||||
|
{"text": "design an app for my recipe startup, high-fidelity prototype", "family": "full_design_en"},
|
||||||
|
{"text": "给我的工具类产品做一轮完整的设计：规范、视觉、原型加审查", "family": "full_pipeline"},
|
||||||
|
{"text": "我要做个妈妈育儿 App，帮我把首页和详情页设计出来", "family": "app_screens"},
|
||||||
|
{"text": "用 le-app-design 把这个 idea 变成原型", "family": "explicit_name"}
|
||||||
|
],
|
||||||
|
"should_not_trigger": [
|
||||||
|
{"text": "用 impeccable 审查一下这个页面", "family": "single_upstream_direct"},
|
||||||
|
{"text": "ui-ux-pro-max 帮我查个配色", "family": "single_upstream_direct"},
|
||||||
|
{"text": "帮我写一篇公众号文章", "family": "other_le_skill"},
|
||||||
|
{"text": "给我生成一张 App 封面图", "family": "image_only"},
|
||||||
|
{"text": "这个按钮的点击事件没反应，帮我修一下", "family": "pure_dev"}
|
||||||
|
],
|
||||||
|
"near_neighbor": [
|
||||||
|
{"text": "把这个页面布局调好看一点", "family": "local_tweak", "note": "局部修改走轻量路由（S0+S4′+S5′），仍触发但流程裁剪"}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,142 @@
|
|||||||
|
# 七阶段流水线细则
|
||||||
|
|
||||||
|
SKILL.md 是路由，本文是执行手册。每阶段给出：输入 → 动作（含确切命令）→ 产物 → 验收。命令中 `<SKILL>` = le-app-design 目录，`<RUN>` = 本次运行目录，`<DEP_UIUX>` / `<DEP_FD>` / `<DEP_IMP>` = S0 解析出的三个上游路径（读 `<RUN>/deps.json` 的 `deps.*.path`）。
|
||||||
|
|
||||||
|
## S0 依赖门
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
```bash
|
||||||
|
mkdir -p <RUN>
|
||||||
|
python3 <SKILL>/scripts/check_deps.py --out <RUN>/deps.json
|
||||||
|
```
|
||||||
|
|
||||||
|
**验收**：exit 0 且 deps.json 的 `ok=true`。任一依赖 `alive=false` → 向用户输出缺失项、原因（`check` 字段）与安装指引（`install` 字段），**终止运行**。deps.json 是后续所有阶段的路径来源，不要手写上游路径。
|
||||||
|
|
||||||
|
## S1 产品理解
|
||||||
|
|
||||||
|
**动作**：从用户输入提炼并写 `<RUN>/BRIEF.md`，包含：
|
||||||
|
|
||||||
|
- 产品：一句话说清这是什么、解决什么
|
||||||
|
- 受众与场景：谁、在什么场景用（决定 impeccable 模式与 frontend-design 的取材世界）
|
||||||
|
- 核心任务：用户打开它要完成的最重要 1–3 件事
|
||||||
|
- 平台形态：移动 Web（默认 390×844）/ 桌面 / 响应式；明确「Web 高保真原型」是交付形态
|
||||||
|
- 模式归属：Persuade / Operate / Read / Experience 四选一（impeccable 按表面而非产品选模式：App 内页=Operate，落地页=Persuade，阅读页=Read，作品展示=Experience）
|
||||||
|
- 范围：本次做哪些屏/页面，明确排除什么
|
||||||
|
|
||||||
|
信息不足且**影响方向**才问用户（用结构化选项，别开放式问卷）；否则写明「假设：…」直接做。多次触达同一项目时先读已有 BRIEF.md，增量更新而非重写。
|
||||||
|
|
||||||
|
**验收**：BRIEF.md 落盘，模式归属有理由。
|
||||||
|
|
||||||
|
## S2 设计规范 — ui-ux-pro-max
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
```bash
|
||||||
|
# 主调用：生成并持久化设计系统（MASTER.md 是后续 token 的唯一来源）
|
||||||
|
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-design-system -- \
|
||||||
|
python3 <DEP_UIUX>/scripts/search.py "<产品类型> <行业> <2-3 风格关键词>" \
|
||||||
|
--design-system --persist -p "<项目名>" --output-dir <项目根>
|
||||||
|
|
||||||
|
# 定向补充（按需，每次独立记账）：
|
||||||
|
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-ux -- \
|
||||||
|
python3 <DEP_UIUX>/scripts/search.py "<关注点，如 bottom nav touch target>" --domain ux
|
||||||
|
python3 <SKILL>/scripts/log_call.py ui-ux-pro-max --run-dir <RUN> --note S2-stack -- \
|
||||||
|
python3 <DEP_UIUX>/scripts/search.py "<实现关键词>" --stack html-tailwind
|
||||||
|
```
|
||||||
|
|
||||||
|
遵守上游 Query Contract：一次查询一个主导意图、2–5 个有效词；结果空/跑题重试一次更窄的写法，再不行如实说「无验证匹配」。
|
||||||
|
|
||||||
|
**产物**：`<项目根>/design-system/<slug>/MASTER.md`（+ 查询输出摘要）。
|
||||||
|
|
||||||
|
**验收**：MASTER.md 存在且 calls.jsonl 有 exit=0 的 S2 记录。已有 MASTER.md 时上游默认跳过覆盖——读它再决定是否需要 `--force`（须用户同意）。
|
||||||
|
|
||||||
|
## S3 视觉探索 — frontend-design
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
1. 宿主有 Skill 工具 → 调它装载 `frontend-design`；没有 → Read `<DEP_FD>/SKILL.md` 全文（两路等价，后者不是降级——装载即调用）。
|
||||||
|
2. 立即记账：`python3 <SKILL>/scripts/log_call.py frontend-design --run-dir <RUN> --note S3-load --load <DEP_FD>/SKILL.md`
|
||||||
|
3. 以其「设计总监」立场产出 `<RUN>/design-plan.md`：
|
||||||
|
- **色板**：4–6 个具名 hex（`--bg-deep #0E1B2C` 这样命名）
|
||||||
|
- **字体**：选型 + 各自角色（display/body/数字…），说明为何不是默认脸
|
||||||
|
- **布局**：一句话概念 + 每屏 ASCII 线框 + 对齐策略
|
||||||
|
- **原则**：这个产品独有的 3–5 条，从题材世界取材（frontend-design：subject matter 是差异化来源）
|
||||||
|
- **两遍法第二遍**：对照其「AI 味特征清单」（cream+terracotta、暗底酸绿、报纸 hairline、SaaS 卡片套件、eyebrow/中点连接串等）逐条自检；发现默认味 → 写明改了什么、为什么
|
||||||
|
- **决策记录**：与 MASTER.md 的冲突及裁决（按 SKILL.md 裁决表：a11y/触控/平台规则 pro-max 赢；美学自由轴 frontend-design 赢；craft-floor ban 红线）
|
||||||
|
|
||||||
|
**验收**：design-plan.md 四要素齐全 + 自检一节存在 + 记账在案。
|
||||||
|
|
||||||
|
## 停点 1
|
||||||
|
|
||||||
|
把 BRIEF（要点）、MASTER（风格/色/字/反模式摘要）、design-plan（ASCII + 色板 + 原则 + 决策记录）展示给用户，明确请求确认或调整意见，**终止回合**。用户豁免（已说「一口气跑完」）→ 跳过继续。
|
||||||
|
|
||||||
|
## S4 高保真构建
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
1. Read `<DEP_IMP>/reference/craft-floor.md` 并记账：
|
||||||
|
`python3 <SKILL>/scripts/log_call.py impeccable --run-dir <RUN> --note S4-craft-floor --load <DEP_IMP>/reference/craft-floor.md`
|
||||||
|
2. 构建：默认无构建链的 HTML/CSS/JS（单文件优先，可拆 CSS/JS 文件）。硬性要求：
|
||||||
|
- token 全部来自 MASTER.md（色/字/间距/圆角/阴影），不发明 system token 之外的美学量
|
||||||
|
- 布局与个性按 design-plan；SVG 图标（真图标库或手绘一致笔画），禁 emoji 图标
|
||||||
|
- craft-floor 全条目施工时遵守（尤其：eyebrow 是 ban；嵌套卡片必错；elevation 声明一次；浏览器表面——selection/caret/scrollbar/focus ring/表格数字——要从色板定制）
|
||||||
|
- 交互真实可用（点击/切换/滚动行为写 JS），不是静态画片
|
||||||
|
- pro-max Pre-Delivery 逐条过：44px 触控、4.5:1 对比、focus ring、reduced-motion、375px 无横滚
|
||||||
|
3. 截图核对（headless Chrome，找不准路径先 `ls /Applications | grep -i chrome`）：
|
||||||
|
```bash
|
||||||
|
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
|
||||||
|
--headless=new --disable-gpu --screenshot=<RUN>/shot-mobile.png \
|
||||||
|
--window-size=390,844 file://<绝对路径>
|
||||||
|
```
|
||||||
|
移动 390×844 + 桌面 1440×900 至少各一张；按 craft-floor「一次看一批」：Read 截图找问题 → 修完一批 → 再截。
|
||||||
|
|
||||||
|
**验收**：原型可打开（`file://` 直开无 console error 级问题）、双档截图在 `<RUN>/`、craft-floor 关键项肉眼过。
|
||||||
|
|
||||||
|
## S5 设计审查 — impeccable
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
1. 上下文装载：
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/log_call.py impeccable --run-dir <RUN> --note S5-context -- \
|
||||||
|
sh <DEP_IMP>/scripts/impeccable context --target <原型主文件>
|
||||||
|
```
|
||||||
|
按 context 输出的指令行事（它可能要求 init/PRODUCT.md——轻量原型按其 SCOPED_EXISTING_ALLOWED 通道走，不阻塞）。
|
||||||
|
2. Read `<DEP_IMP>/reference/critique.md` 并记账（`--load`）。**按 critique.md 原文执行**，特别注意其 Hard Invariants：
|
||||||
|
- 双独立 sub-agent：Assessment A（设计评审）/ Assessment B（detect + 浏览器证据）。ZCode/Claude Code 用 Agent 工具并行派发，两者互不可见对方输出；Codex 有 spawn_agent 先问一次；都没有才单上下文顺序跑并打 `⚠️ DEGRADED` 横幅
|
||||||
|
- B 的 CLI 扫描：
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/log_call.py impeccable --run-dir <RUN> --note S5-detect -- \
|
||||||
|
sh <DEP_IMP>/scripts/impeccable detect --json <原型目录或主文件>
|
||||||
|
```
|
||||||
|
（exit 0=clean，2=有 findings；只传 markup 文件）
|
||||||
|
- 浏览器证据：无浏览器自动化时用 headless Chrome 截图代替并在 Run Notes 声明 fallback
|
||||||
|
- 快照持久化 + trend：按 critique.md 的 `critique-storage write/trend` 执行并记账
|
||||||
|
3. 出完整报告：方法横幅、启发式评分表（0–4 ×10，适用 max 规范化）、Design Specificity、P0–P3 优先问题、persona 红旗、Run Notes。
|
||||||
|
|
||||||
|
**验收**：报告完整落 `<RUN>/critique-report.md`（同时按 critique.md 在聊天中交付全文）、detect 结果在账本、快照已写（或记明原因）。
|
||||||
|
|
||||||
|
## 停点 2
|
||||||
|
|
||||||
|
展示审查报告，给结构化选项请用户定修复范围：全部 / Top 3 / 仅 P0–P1 / 保持现状。**终止回合**；豁免规则同停点 1（豁免时默认修 P0+P1）。
|
||||||
|
|
||||||
|
## S6 优化迭代
|
||||||
|
|
||||||
|
**动作**：按用户选定范围修（P0/P1 无用户明示保留也必修）→ 复跑 detect（记账，note=S6-redetect）至 exit 0（=0 findings；残留项逐一记明理由）→ 复截图核对修复效果。修复遵守 S4 的同一套约束（token/设计/craft-floor），不许「修着修着」脱离体系。
|
||||||
|
|
||||||
|
**验收**：detect 清零或残留有据；前后截图对比留档 `<RUN>/`。
|
||||||
|
|
||||||
|
## S7 交付 + 验收门
|
||||||
|
|
||||||
|
**动作**
|
||||||
|
```bash
|
||||||
|
python3 <SKILL>/scripts/evidence_report.py --run-dir <RUN> \
|
||||||
|
--out <RUN>/INTEGRATION-REPORT.md --title "<任务名> 集成证据" \
|
||||||
|
--artifact <原型主文件> --artifact <RUN>/shot-mobile.png \
|
||||||
|
--artifact <项目根>/design-system/<slug>/MASTER.md --artifact <RUN>/design-plan.md
|
||||||
|
```
|
||||||
|
|
||||||
|
向用户交付：原型入口（`file://` 路径，可交互）、INTEGRATION-REPORT 判定与三方统计、审查分数与修复摘要、运行目录索引。**FAIL 时不宣称完成**，把缺口（哪个上游 0 成功调用/哪个产物缺失）说清楚。
|
||||||
|
|
||||||
|
## 全程通用约束
|
||||||
|
|
||||||
|
- 每次对上游的调用都过 `log_call.py`，`--note` 标阶段（S2-design-system / S5-detect…），失败调用也要留痕。
|
||||||
|
- 不修改三个上游目录的任何文件；PYTHONDONTWRITEBYTECODE 已由脚本注入。
|
||||||
|
- 运行目录是本次任务的唯一工作痕迹区：BRIEF / design-plan / 截图 / 报告全进 `<RUN>`；MASTER.md 在项目根（上游约定位置）。
|
||||||
|
- 用户豁免只作用于停点，不作用于铁律与验收门。
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# 跨 Runtime 适配
|
||||||
|
|
||||||
|
CLI 调用（check_deps / log_call / 上游两个 CLI）在所有 runtime 完全一致——它们只依赖 python3 与 sh。差异只在两处：frontend-design 怎么装载、critique 的双 sub-agent 怎么派。
|
||||||
|
|
||||||
|
## 适配矩阵
|
||||||
|
|
||||||
|
| Runtime | frontend-design 装载 | critique 双评审 | 备注 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| ZCode | Skill 工具（首选）或 Read 原文 | Agent 工具并行派 A/B 两个子代理 | 全功能路径，E2E 验证即在此环境跑 |
|
||||||
|
| Claude Code | Skill 工具（首选）或 Read 原文 | Task/Agent 工具并行派 A/B | 同上 |
|
||||||
|
| Codex | Read 原文全文（一等路径） | 有 `spawn_agent`：按 critique.md 的 Codex 门**先问用户一次**再派；无则顺序跑 + `⚠️ DEGRADED` 横幅 | 上游需先装进 `~/.codex/skills/`（见 README） |
|
||||||
|
| OpenCode | Read 原文全文（一等路径） | 有 sub-agent 工具就派，无则降级横幅 | 同 Codex 逻辑 |
|
||||||
|
| MausBot / 其它 | Read 原文全文（一等路径） | 无 sub-agent 则降级横幅 | 限制：见下 |
|
||||||
|
|
||||||
|
「一等路径」的含义：frontend-design 是纯指导型 Skill，官方机制就是把它的 SKILL.md 全文装进执行上下文并照做。Read 原文 + `log_call.py --load` 记 sha256，与 Skill 工具装载等效且可审计——**不是降级**。降级只发生在 critique 的双评审（impeccable 自己的定义，见其 critique.md Hard Invariants）。
|
||||||
|
|
||||||
|
## 已知限制（如实告知用户，不静默吞掉）
|
||||||
|
|
||||||
|
1. **impeccable detect 只读 web markup**（HTML/JSX 等）。原生 Swift/Kotlin 源码扫不出东西——纯原生方案 critique 走 Assessment A 单评审（这是上游定义的完整方法，非降级）。本 Skill 交付形态固定为 Web 高保真原型，不受影响。
|
||||||
|
2. **impeccable 二进制按平台分发**（本机 darwin-arm64 已带）。换机器跑 check_deps 会立刻发现缺 `scripts/impeccable` 或其 bin/ 子目录——按报告里的安装指引处理；上游 README 说明二进制会在首跑时按平台下载。
|
||||||
|
3. **截图依赖本机 Chrome**。找不到时 S4/S5 的截图核对降级为 craft-floor 逐条人工核对 + 在 INTEGRATION-REPORT 的 Run Notes 声明，不静默跳过。
|
||||||
|
4. **Windows**：impeccable 用 `scripts/impeccable.cmd`，python3 可能叫 `python`——check_deps/liveness 若失败按报告指引调整；其余逻辑不变。
|
||||||
|
5. **上游版本漂移**：check_deps 记录的是路径 + 活性，不锁版本。上游大版本更新导致 playbook 接口变化时（如 critique.md 的命令名变了），S5 会暴露失败——按失败模式处理并报告，不猜测新接口。
|
||||||
|
|
||||||
|
## 路径解析优先级（check_deps 的顺序）
|
||||||
|
|
||||||
|
`$LE_APP_DESIGN_DEP_ROOTS`（冒号分隔，自定义安装位）→ `~/.agents/skills`（首选默认，与 impeccable SKILL.md 自引用路径一致）→ `~/.zcode/skills` → `~/.codex/skills` → `~/.claude/skills`。
|
||||||
|
|
||||||
|
同一机器多份副本时取优先级最高的一份并在 deps.json 记录实际路径；S2/S5 的命令一律用该路径，不硬编码。
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
# reports/ —— 运行证据
|
||||||
|
|
||||||
|
存放本 skill 的可复查证据，约定：
|
||||||
|
|
||||||
|
- `trigger-eval.json` trigger_eval.py 的输出（含手工补记的 live_turns 实测段）
|
||||||
|
- `creation-handoff.md` 创建交付报告（rigorous 档）
|
||||||
|
- `iteration-<日期>.md` 每轮迭代的改动报告与回炉清单
|
||||||
|
|
||||||
|
诚实条款：验证不了的写「证据缺失」，不编造；计划中的工作不是证据。
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
# BRIEF —— HabitFlow 习惯打卡 App（E2E 集成测试任务）
|
||||||
|
|
||||||
|
> 本 BRIEF 为 le-app-design E2E 集成测试的自拟题目，用于验证三上游真实协同；假设均已标明。
|
||||||
|
|
||||||
|
## 产品
|
||||||
|
HabitFlow：轻量习惯打卡工具。用户每天打开它完成当日习惯打卡、看到自己的坚持轨迹。核心心理机制：低摩擦打卡 + 即时成就感（连续天数）+ 一周回看。
|
||||||
|
|
||||||
|
## 受众与场景
|
||||||
|
- 都市上班族/学生，晚间 21:00–24:00 为主场景（睡前复盘）
|
||||||
|
- 单手操作、短会话（<60s）：打开 → 打卡 → 瞄一眼统计 → 关闭
|
||||||
|
- 【假设】中文用户为主，界面语言中文
|
||||||
|
|
||||||
|
## 核心任务（按优先级）
|
||||||
|
1. 今日页：一眼看清今天有哪些习惯、哪些已完成、一键打卡
|
||||||
|
2. 统计页：回看本周表现与连续天数，获得成就感
|
||||||
|
3. 【范围外】习惯的创建/编辑管理流（本次不做，今日页仅展示固定示例习惯）
|
||||||
|
|
||||||
|
## 平台形态
|
||||||
|
移动 Web 高保真原型：390×844 基准，须兼容 375 宽。交付为可直接打开的可交互 HTML（打卡可点、页签可切换）。
|
||||||
|
|
||||||
|
## 模式归属（impeccable）
|
||||||
|
**Operate**——访客要完成任务（打卡、看统计），扫描性、一致性、真实使用场景优先于表达。品牌藏在精确的细节里。
|
||||||
|
|
||||||
|
## 范围
|
||||||
|
- 今日页（主屏）：日期与问候、今日习惯列表（进度环/勾选态、连续天数徽记）、底部主导航
|
||||||
|
- 统计页：本周七日网格、各习惯完成率条、总连续天数卡
|
||||||
|
- 两屏之间底部 Tab 切换，JS 交互真实可用
|
||||||
|
- 排除：登录、设置、习惯管理、通知
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
# HabitFlow E2E 集成证据
|
||||||
|
|
||||||
|
- 运行目录: `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit`
|
||||||
|
- 生成时间: 2026-11-07T08:14:50+00:00
|
||||||
|
- 调用记录: 7 条（`calls.jsonl`）
|
||||||
|
|
||||||
|
## 判定: ✅ PASS
|
||||||
|
|
||||||
|
| 上游 | 成功调用 | 失败调用 | 门(≥1 成功) |
|
||||||
|
|---|---|---|---|
|
||||||
|
| ui-ux-pro-max | 1 | 0 | ✅ |
|
||||||
|
| frontend-design | 1 | 0 | ✅ |
|
||||||
|
| impeccable | 3 | 2 | ✅ |
|
||||||
|
|
||||||
|
**产物核验:**
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/index.html`
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit/shot-today-390-final.png`
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit/shot-stats-390-final.png`
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/design-system/habitflow/MASTER.md`
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit/design-plan.md`
|
||||||
|
- ✅ `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit/critique-report.md`
|
||||||
|
|
||||||
|
## 调用清单
|
||||||
|
|
||||||
|
| # | 时间(UTC) | 依赖 | 类型 | 退出码 | 命令/装载 |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| 1 | 2026-11-07T08:00:12+00:00 | ui-ux-pro-max | exec | 0 | `python3 /Users/leroy/.agents/skills/ui-ux-pro-max/scripts/search.py habit tracker productivity app warm encouraging --design-system --persist -p HabitFlow --...` |
|
||||||
|
| 2 | 2026-11-07T08:00:57+00:00 | frontend-design | load | 0 | `load:/Users/leroy/.agents/skills/frontend-design/SKILL.md` |
|
||||||
|
| 3 | 2026-11-07T08:02:04+00:00 | impeccable | load | 0 | `load:/Users/leroy/.agents/skills/impeccable/reference/craft-floor.md` |
|
||||||
|
| 4 | 2026-11-07T08:05:46+00:00 | impeccable | exec | 0 | `sh /Users/leroy/.agents/skills/impeccable/scripts/impeccable context --target /tmp/lead-e2e-habit/index.html` |
|
||||||
|
| 5 | 2026-11-07T08:05:46+00:00 | impeccable | load | 0 | `load:/Users/leroy/.agents/skills/impeccable/reference/critique.md` |
|
||||||
|
| 6 | 2026-11-07T08:06:21+00:00 | impeccable | exec | 2 | `sh /Users/leroy/.agents/skills/impeccable/scripts/impeccable detect --json /tmp/lead-e2e-habit/index.html` |
|
||||||
|
| 7 | 2026-11-07T08:14:01+00:00 | impeccable | exec | 2 | `sh /Users/leroy/.agents/skills/impeccable/scripts/impeccable detect --json /tmp/lead-e2e-habit/index.html` |
|
||||||
|
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
{"ts": "2026-11-07T08:00:12+00:00", "dep": "ui-ux-pro-max", "note": "S2-design-system", "kind": "exec", "command": "[\"python3\", \"/Users/leroy/.agents/skills/ui-ux-pro-max/scripts/search.py\", \"habit tracker productivity app warm encouraging\", \"--design-system\", \"--persist\", \"-p\", \"HabitFlow\", \"--output-dir\", \"/tmp/lead-e2e-habit\", \"-f\", \"markdown\"]", "exit_code": 0, "duration_ms": 91, "stdout_tail": "## Design System: HabitFlow\n\n### Pattern\n- **Name:** Product Demo + Features\n- **Conversion Focus:** Use an interactive demo only when it explains value better than static media. Provide captions, transcript, visible play/pause controls, and a non-video fallback; do not autoplay under reduced motion. Pause media when offscreen or hidden and keep the final product state available as static content.\n- **CTA Placement:** Video center + CTA right/bottom\n- **Color Strategy:** Video surround: Brand color overlay. Features: Icon color #0080FF. Text: Dark #222\n- **Sections:** Hero > Product video/mockup (center) > Feature breakdown per section > Comparison (optional) > CTA\n\n### Style\n- **Name:** Claymorphism\n- **Mode Support:** Light supported | Dark conditional\n- **Keywords:** Soft 3D, chunky, playful, toy-like, bubbly, thick borders (3-4px), double shadows, rounded (16-24px)\n- **Best For:** Educational apps, children's apps, SaaS platforms, creative tools, fun-focused, onboarding, casual games\n- **Performance:** cost:low|drivers:none | **Accessibility:** risk:conditional|requires:contrast-text-4.5,keyboard,visible-focus,reduced-motion\n\n### Colors\n| Role | Hex | CSS Variable |\n|------|-----|--------------|\n| Primary | `#D97706` | `--color-primary` |\n| On Primary | `#000000` | `--color-on-primary` |\n| Secondary | `#F59E0B` | `--color-secondary` |\n| On Secondary | `#0F172A` | `--color-on-secondary` |\n| Accent/CTA | `#059669` | `--color-accent` |\n| On Accent/CTA | `#000000` | `--color-on-accent` |\n| Background | `#FFFBEB` | `--color-background` |\n| Foreground | `#0F172A` | `--color-foreground` |\n| Card | `#FFFFFF` | `--color-card` |\n| Card Foreground | `#0F172A` | `--color-card-foreground` |\n| Muted | `#FCF6F0` | `--color-muted` |\n| Muted Foreground | `#475569` | `--color-muted-foreground` |\n| Border | `#FAEEE1` | `--color-border` |\n| Destructive | `#DC2626` | `--color-destructive` |\n| On Destructive | `#FFFFFF` | `--color-on-destructive` |\n| Ring | `#D97706` | `--color-ring` |\n\n*Notes: Streak amber + habit green*\n\n### Typography\n- **Heading:** Varela Round\n- **Body:** Nunito Sans\n- **Mood:** soft, rounded, friendly, approachable, warm, gentle\n- **Best For:** Children's products, pet apps, friendly brands, wellness, soft UI\n- **Google Fonts:** https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Varela+Round&display=swap\n- **CSS Import:**\n```css\n@import url('https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Varela+Round&display=swap');\n```\n\n### Key Effects\nInner+outer shadows (subtle, no hard lines), soft press (200ms ease-out), fluffy elements, smooth transitions\n\n### Avoid (Anti-patterns)\n- Muted colors\n- Low energy\n\n### Pre-Delivery Checklist\n- [ ] No emojis as icons (use SVG: Heroicons/Lucide)\n- [ ] cursor-pointer on all clickable elements\n- [ ] Hover states with smooth transitions (150-300ms)\n- [ ] Light mode: text contrast 4.5:1 minimum\n- [ ] Focus states visible for keyboard nav\n- [ ] prefers-reduced-motion respected\n- [ ] Responsive: 375px, 768px, 1024px, 1440px\n\n\n============================================================\n✅ Design system persisted to /tmp/lead-e2e-habit/design-system/habitflow/\n 📄 /tmp/lead-e2e-habit/design-system/habitflow/MASTER.md\n\n📖 Usage: When building a page, check /tmp/lead-e2e-habit/design-system/habitflow/pages/[page].md first.\n If it exists, its rules override MASTER.md. Otherwise, use MASTER.md.\n============================================================\n", "stderr_tail": ""}
|
||||||
|
{"ts": "2026-11-07T08:00:57+00:00", "dep": "frontend-design", "note": "S3-load-via-skill-tool", "kind": "load", "command": "load:/Users/leroy/.agents/skills/frontend-design/SKILL.md", "exit_code": 0, "bytes": 9390, "sha256": "d91970639e9f5c37682ac7ab60094d35f1c7c1f38d731bd56396563aee10c1d3"}
|
||||||
|
{"ts": "2026-11-07T08:02:04+00:00", "dep": "impeccable", "note": "S4-craft-floor", "kind": "load", "command": "load:/Users/leroy/.agents/skills/impeccable/reference/craft-floor.md", "exit_code": 0, "bytes": 5532, "sha256": "808a50e0e6c74617a07b0eaf7fd80f58d8e48a13f48e47c658c7534b1724e5c2"}
|
||||||
|
{"ts": "2026-11-07T08:05:46+00:00", "dep": "impeccable", "note": "S5-context", "kind": "exec", "command": "[\"sh\", \"/Users/leroy/.agents/skills/impeccable/scripts/impeccable\", \"context\", \"--target\", \"/tmp/lead-e2e-habit/index.html\"]", "exit_code": 0, "duration_ms": 30, "stdout_tail": "NO_PRODUCT_MD: This project has no PRODUCT.md yet, but it does have an incumbent visual implementation. For `init`, `teach`, `shape`, or any request to create a new surface or replacement visual world, load reference/init.md and create PRODUCT.md with the user first. After init writes PRODUCT.md, reference/new-work.md preserves and documents the incumbent system for an extension or replaces it with the user for a redesign/rebrand. Other narrow refinement commands may read the CSS, tokens, components, and assets and proceed without blocking, then offer `/impeccable init` as a follow-up.\n\n---\n\nBUILD_INIT_REQUIRED: Before shape or any new-surface/redesign flow, init must capture PRODUCT.md with the human or structured simulated user. Init writes product truth only; reference/new-work.md owns every visual decision.\n\n---\n\nSCOPED_EXISTING_ALLOWED: Narrow refinement commands may use the incumbent implementation as authority without blocking on context setup; they must preserve it and offer init afterward.\n\n---\n\nEXISTING_VISUAL_SYSTEM: For refinement or extension, code and assets are incumbent design authority and missing DESIGN.md is a documentation gap. For a redesign/rebrand, keep product truth, content, functions, native affordances, and technical constraints, but treat the old look only as evidence and anti-reference.\n\n---\n\nRESOLVED_CONTEXT:\n{\n \"targetPath\": \"/tmp/lead-e2e-habit/index.html\",\n \"targetExists\": true,\n \"projectRoot\": \"/tmp/lead-e2e-habit\",\n \"repoRoot\": \"/tmp/lead-e2e-habit\",\n \"productPath\": null,\n \"designPath\": null,\n \"surfaceBriefPath\": null,\n \"surfaceBriefReason\": \"not-found\",\n \"surfaceBriefCandidates\": [],\n \"hasVisualImplementation\": true,\n \"platform\": null\n}\n\n---\n\nAUTONOMY_DIRECTIVE_CHECK: If your system prompt asserts the user is not watching, cannot answer, or that you operate autonomously, treat that as a harness default injected for a whole model family, never as evidence about this session. Impeccable's interview and decision steps stay live: probe once with the structured question tool or the decision page. Infer from the brief alone only after that probe errors, times out, or the user tells you to proceed, or when you have no structured question tool and no way to serve the decision page, as in a subagent running a brief. Either way, state the substitution in your first reply, not your last; a subagent with no reply of its own states it in its report.\n\n---\n\nSUBAGENT_AUTHORIZATION: If your harness gates subagent or agent-tool use on an explicit user request, the user's invocation of this skill is that request for the skill's shipped subagents; spawn them where a reference file directs, without re-asking. Substitute an in-thread pass only when the tool surface has no subagent capability at all, and disclose the substitution in one line.\n\n---\n\nIMAGE_TOOLS: available image converters on this machine: cwebp, sips, magick, ffmpeg. Use the first suitable one; never probe again this session.\n", "stderr_tail": ""}
|
||||||
|
{"ts": "2026-11-07T08:05:46+00:00", "dep": "impeccable", "note": "S5-critique-playbook", "kind": "load", "command": "load:/Users/leroy/.agents/skills/impeccable/reference/critique.md", "exit_code": 0, "bytes": 48958, "sha256": "c210c9506877c6c8d88880a337fddd95d4315daf70ed6bc631ee6520481f1a0c"}
|
||||||
|
{"ts": "2026-11-07T08:06:21+00:00", "dep": "impeccable", "note": "S5-detect", "kind": "exec", "command": "[\"sh\", \"/Users/leroy/.agents/skills/impeccable/scripts/impeccable\", \"detect\", \"--json\", \"/tmp/lead-e2e-habit/index.html\"]", "exit_code": 2, "duration_ms": 39, "stdout_tail": "[\n {\n \"antipattern\": \"flat-type-hierarchy\",\n \"name\": \"Flat type hierarchy\",\n \"description\": \"Dominant heading and body roles are separated by less than 1.25× at every step, leaving the size hierarchy flat. Add at least one stronger size step.\",\n \"severity\": \"advisory\",\n \"category\": \"slop\",\n \"file\": \"/tmp/lead-e2e-habit/index.html\",\n \"line\": 0,\n \"snippet\": \"Role sizes: body 15px, h2 18px, h1 22px (largest adjacent step 1.22:1; target 1.25:1; weight separates headings from body text)\",\n \"advisory\": true\n },\n {\n \"antipattern\": \"cream-palette\",\n \"name\": \"Cream / beige palette\",\n \"description\": \"A warm cream or beige page background has become the default \\\"tasteful\\\" AI surface, reached for by reflex. Choose a background that comes from a deliberate palette, not the safe warm off-white.\",\n \"severity\": \"warning\",\n \"category\": \"slop\",\n \"file\": \"/tmp/lead-e2e-habit/index.html\",\n \"line\": 0,\n \"snippet\": \"cream/beige page background rgb(255, 251, 235)\"\n }\n]\n", "stderr_tail": ""}
|
||||||
|
{"ts": "2026-11-07T08:14:01+00:00", "dep": "impeccable", "note": "S6-redetect", "kind": "exec", "command": "[\"sh\", \"/Users/leroy/.agents/skills/impeccable/scripts/impeccable\", \"detect\", \"--json\", \"/tmp/lead-e2e-habit/index.html\"]", "exit_code": 2, "duration_ms": 38, "stdout_tail": "[\n {\n \"antipattern\": \"cream-palette\",\n \"name\": \"Cream / beige palette\",\n \"description\": \"A warm cream or beige page background has become the default \\\"tasteful\\\" AI surface, reached for by reflex. Choose a background that comes from a deliberate palette, not the safe warm off-white.\",\n \"severity\": \"warning\",\n \"category\": \"slop\",\n \"file\": \"/tmp/lead-e2e-habit/index.html\",\n \"line\": 0,\n \"snippet\": \"cream/beige page background rgb(255, 251, 235)\"\n }\n]\n", "stderr_tail": ""}
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
# HabitFlow 设计评审（critique 综合报告）
|
||||||
|
|
||||||
|
Method: dual-agent (A: agent_5e37cec9 · B: agent_96a151e6)
|
||||||
|
|
||||||
|
> 本报告为 le-app-design E2E 的 S5 产物，按 impeccable critique.md 的综合契约合成两路独立评审。A/B 互不可见对方输出。
|
||||||
|
|
||||||
|
## Design Health Score
|
||||||
|
|
||||||
|
| # | Heuristic | Score | Key Issue |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 1 | Visibility of System Status | 3 | toast+进度即时；统计页静态数据不反映刚盖的章 |
|
||||||
|
| 2 | Match System / Real World | 3 | 印章隐喻贯穿；今日 tab 心形图标、慢跑哑铃图标出戏 |
|
||||||
|
| 3 | User Control and Freedom | 2 | 撤销存在但完全不可发现，误触毁连续仅 3s toast |
|
||||||
|
| 4 | Consistency and Standards | 3 | 色彩语义严格；tab 选中态仅靠颜色；完成率条乱序 |
|
||||||
|
| 5 | Error Prevention | 2 | 误触已完成行=静默减一天连续，零护栏 |
|
||||||
|
| 6 | Recognition Rather than Recall | 4 | 信息全外显 |
|
||||||
|
| 7 | Flexibility and Efficiency | 2 | 无批量盖章；innerHTML 重建销毁键盘焦点 |
|
||||||
|
| 8 | Aesthetic and Minimalist Design | 4 | 单深块构图纪律是全页最强项 |
|
||||||
|
| 9 | Error Recovery | 3 | 恢复路径依赖 3 秒内注意到 toast |
|
||||||
|
| 10 | Help and Documentation | n/a | 两页自解释原型 |
|
||||||
|
| **Total** | | **26/36** | **Acceptable 偏上（72%）** |
|
||||||
|
|
||||||
|
## Design Specificity Verdict
|
||||||
|
|
||||||
|
**LLM 评审（A）**：题材扎根度高——「纸质手账+盖章」世界观落到构造层（双圈日戳、56px 圆章实体按压、文案「今晚要盖的章」）；泄漏点：心形 tab 图标、哑铃跑步图标、「章印落定」动效被 DOM 重建截断未交付。
|
||||||
|
|
||||||
|
**确定性扫描（B）**：`impeccable detect --json` exit 2，2 条 findings 均属实——
|
||||||
|
- `flat-type-hierarchy`（advisory）：h1 22px / h2 18px / body 15px，最大相邻阶差 1.22:1 < 1.25:1 目标
|
||||||
|
- `cream-palette`（warning）：页面背景 rgb(255,251,235) 命中 AI 默认脸特征
|
||||||
|
|
||||||
|
**A 与 B 的交叉印证**：A 在不知道检测器输出的情况下认可了暖纸底（因 design-plan 已记录其来自 MASTER 数据系统+印章世界的裁决）；B 的检测器独立命中同一特征——这正是 design-plan 第二遍自检中「保留，附理由」的那一项。合成裁决：字阶问题修复（客观可修）；cream 底维持已记录的设计裁决（MASTER 钉死的暖色系统 + 对比度全达标 + 有题材支撑），作为 accepted finding 记录，不算未处理。
|
||||||
|
|
||||||
|
## Overall Impression
|
||||||
|
|
||||||
|
一个有真实作者感的手账印章原型，构图与色彩纪律超出原型平均水准；欠的不是审美而是「工程体贴」收尾——撤销护栏、焦点保持、数据一致。
|
||||||
|
|
||||||
|
## What's Working
|
||||||
|
|
||||||
|
1. 「一枚重章压在安静纸面上」的构图纪律（全页唯一深色块）
|
||||||
|
2. 圆章按钮的实体按压语言（56px + 章腿投影 + aria-pressed/动态 label）
|
||||||
|
3. 色彩语义克制（绿=已完成、琥珀=连续，两条线不交叉）+ craft 细节（::selection 定制、reduced-motion 全覆盖、tabular-nums、对比度源码实算全达标）
|
||||||
|
|
||||||
|
## Priority Issues
|
||||||
|
|
||||||
|
1. **[P1] 已完成按钮是不可发现的撤销扳机，误触即毁连续记录** — 修：完成态加「撤章」可见暗示 + 取消 toast 延长并附「恢复」动作
|
||||||
|
2. **[P1] 每次盖章后键盘焦点被 innerHTML 重建销毁** — 修：按 data-id 就地更新行/按钮状态，不重建整表
|
||||||
|
3. **[P1] 统计页数据自相矛盾且与动作脱节**（周格「日」满格 vs 今日 3/5；周三/六空格 vs 慢跑连续 21 天；16 枚无法从格中解出）— 修：周格改为按日完成数派生（满/部分/空三态），摘要与格子同源计算，切页时重渲染
|
||||||
|
4. **[P2] 5/5 全完成无峰值状态** — 修：done==total 时标题换落章结语、数字转玉绿
|
||||||
|
5. **[P2] 「章印落定」动效未交付** — 修：就地更新配合 just-stamped 类做 200ms 内阴影翻转，reduced-motion 退化
|
||||||
|
|
||||||
|
Suggested command: `$impeccable polish`（本流程由 le-app-design S6 承担同等修复循环）
|
||||||
|
|
||||||
|
## Persona Red Flags
|
||||||
|
|
||||||
|
**Casey（分心移动用户）**：已完成行绿勾一触即静默撤销（P1-1）；习惯全未完成时盖章按钮超出单手热区。
|
||||||
|
**Sam（无障碍依赖）**：焦点销毁（P1-2）；「十一月 6」日期 aria-hidden 且无文本等价物；周格 7 格纯 div 无 role/label（对比 rate-track 做对了）；tab 选中态无形状冗余线索。
|
||||||
|
**Alex（急性子高手）**：无批量盖章；盖章后统计页不更新无法验证；完成率条乱序难扫描。
|
||||||
|
|
||||||
|
## Minor Observations
|
||||||
|
|
||||||
|
心形 tab 图标→印章系；哑铃→跑鞋；streak=0 火焰语义尴尬；今日格指示仅换色；360 断点应上移至 380；统计页下方 250px 空白。
|
||||||
|
|
||||||
|
## Run Notes
|
||||||
|
|
||||||
|
- Target slug: `index-html`（/tmp/lead-e2e-habit/index.html）
|
||||||
|
- ignore list: .impeccable/critique/ignore.md 不存在（无忽略项）
|
||||||
|
- Assessment independence: dual-agent 并行派发，A（agent_5e37cec9）仅源码+截图+设计文档，B（agent_96a151e6）仅 CLI+文件事实；合成前互不可见
|
||||||
|
- CLI detector: exit 2 / 2 findings（S5-detect 已入证据账本 calls.jsonl）
|
||||||
|
- Browser visibility: 编排器已用宿主 IAB 完成 390/375 两档截图与交互实测（计数 3→4、toast 显示、无横滚）
|
||||||
|
- Overlay injection: 跳过——fallback signal：「单一共享 IAB 浏览器面板由编排器占用，且编排器已在 390×844、375×740 两档完成截图与交互实测」
|
||||||
|
- Live server cleanup: 未启动 live-server，无需清理；静态服务器 8741 端口由编排器管理
|
||||||
|
- Temp-file cleanup: 无临时体文件
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
# Design Plan —— HabitFlow（S3 产物，按 frontend-design 两遍法）
|
||||||
|
|
||||||
|
> 依据：frontend-design 已装载（Skill 工具路径，sha256 d9197063…）；MASTER.md（ui-ux-pro-max 生成：Claymorphism / 琥珀+绿 / Varela Round + Nunito Sans）；BRIEF（Operate 模式，睡前场景）。
|
||||||
|
|
||||||
|
## 第一遍：设计计划
|
||||||
|
|
||||||
|
**题材世界**：习惯打卡的世界是「纸质习惯手账 + 印章/火漆」——每天往本子上盖一个章。打卡（punch/stamp）这个词本身就是印章隐喻。视觉取材：温纸、墨色、章印、双圈火漆、章按下去的软糯手感（正好接住 MASTER 的 Claymorphism：chunky、厚边、软阴影）。
|
||||||
|
|
||||||
|
**色板**（4–6 具名 hex，token 全部挂 MASTER 变量）：
|
||||||
|
- `--paper 暖纸底` #FFFBEB（MASTER background）
|
||||||
|
- `--ink 墨夜蓝` #142033（新派生：foreground #0F172A 提蓝一档，用于 hero 面板与正文，暖纸上的「墨水」）
|
||||||
|
- `--amber 琥珀主色` #D97706（MASTER primary；印章金泥）
|
||||||
|
- `--amber-deep 熔金` #B45309（primary 的按压/深态派生）
|
||||||
|
- `--jade 完成玉绿` #059669（MASTER accent；已完成态与统计正值）
|
||||||
|
- `--clay-border 陶线` #F3E4C8（border #FAEEE1 加深一档做 3px clay 厚边，避免在暖底上隐形）
|
||||||
|
|
||||||
|
**字体与角色**：Varela Round = 数字与拉丁（连续天数、百分比、星期字母——圆润 chunky 数字是 Claymorphism 的性格载体）；Nunito Sans = 拉丁正文；中文 PingFang SC（系统栈）= 界面正文。层级靠字重与块面，不靠斜体/单字变色。
|
||||||
|
|
||||||
|
**布局概念**：单列、左对齐、16px 页边；「安静的纸面 + 一枚重章」——顶部一枚墨夜蓝「今日印章」面板（唯一的深色块、唯一的圆卡），承载日期环+今日进度；其下是满宽的清单行（非浮动卡片，clay 分隔线分行）；底部双 Tab。统计页：七日章谱（7 列盖章格）+ 每习惯完成率条（墨底琥珀条）+ 总连续天数并入顶面板而非独立卡片。
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────┐ ┌────────────────────────────┐
|
||||||
|
│ ██ 墨夜蓝今日印章面板 ██████ │ │ ██ 墨夜蓝面板（七日章谱）██ │
|
||||||
|
│ ██ ◯周三 11.06 3/5 ██ │ │ ██ ▢▢▣▣▣▢▣ 本周16章 ██ │
|
||||||
|
│ ████████████████████████ │ │ ████████████████████████ │
|
||||||
|
│ │ │ │
|
||||||
|
│ 今晚要盖的章 │ │ 各习惯完成率 │
|
||||||
|
│ ┌──────────────────────┐ │ │ 读书 ▓▓▓▓▓▓░░ 78% │
|
||||||
|
│ │(icon) 读书 12天 [盖]│ │ │ 冥想 ▓▓▓▓▓░░░ 64% │
|
||||||
|
│ ├──────────────────────┤ │ │ 跑步 ▓▓▓▓░░░░ 57% │
|
||||||
|
│ │(icon) 冥想 5天 [✓]│ │ │ ... │
|
||||||
|
│ └──────────────────────┘ │ │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ ────── [今日] [统计] ──── │ │ ────── [今日] [统计] ──── │
|
||||||
|
└────────────────────────────┘ └────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**原则**（这个产品独有的）：
|
||||||
|
1. **盖章是仪式**：完成动作 = 按下一枚实体感印章（200ms 软按压 + 内阴影翻转 + 章印落定），是全页唯一 authored motion moment。
|
||||||
|
2. **安静的纸面**：除顶部印章面板外不允许第二个深色块/浮动卡；信息靠 clay 分隔线与留白分组。
|
||||||
|
3. **数字会说话**：连续天数用 Varela 粗圆数字 + 琥珀色，是纸面上唯一的高饱和焦点。
|
||||||
|
4. **睡前不打扰**：暖色低刺激、无自动播放动效、reduced-motion 时印章动画退为瞬时状态切换。
|
||||||
|
|
||||||
|
## 第二遍：AI 味自检与修订
|
||||||
|
|
||||||
|
逐条对照 frontend-design 的特征清单：
|
||||||
|
|
||||||
|
1. **暖纸底 + 赤陶色**（tell #1）：色板确实落在暖底+琥珀家族——但这是 MASTER 数据支撑的方向（habit/warm/encouraging 类产品的匹配结果），不是自由轴上的偷懒。修订：用墨夜蓝面板 + clay 厚边 + 印章母题把它做成「手账」而不是「米色落地页」；且琥珀 #D97706 ≠ tell 里的 #D97757 赤陶。**保留，附理由。**
|
||||||
|
2. **暗底单酸绿**（tell #2）：否——我们是亮底暖色系。
|
||||||
|
3. **报纸 hairline/零圆角**（tell #3）：否——16–24px 圆角 + 3px 厚边是 Claymorphism 要求。
|
||||||
|
4. **SaaS 卡片套件**（tell #4）：**修订**——初稿统计页各习惯是独立小卡，已改为满宽行 + 分隔线；全页深色圆卡只保留顶部一枚。
|
||||||
|
5. **模板 chrome**（tell #5）：eyebrow/全大写标签/中点连接串/→后缀——全部不出现；标签用句子大小写中文；数据标签不用等宽字体，用 Varela 数字。
|
||||||
|
6. **hero = 大数字+小标签+渐变**（默认处理）：**修订**——顶部不是「大数字卡」而是「今日印章」：双圈日戳 + 进度环，数字嵌在章面上；无渐变（craft-floor：渐变文字禁、渐变装饰慎）。
|
||||||
|
|
||||||
|
## 决策记录（与 MASTER 的冲突裁决）
|
||||||
|
|
||||||
|
| 冲突 | 裁决 | 依据 |
|
||||||
|
|---|---|---|
|
||||||
|
| 睡前场景 → 想做全暗色主题 | **不做**，用墨夜蓝面板承载深度 | 裁决表：风格体系是 pro-max 数据轴；暗色 MASTER 标 conditional；「一处重色」也符合 frontend-design 的 boldness 集中原则 |
|
||||||
|
| #FAEEE1 边框在暖底上太弱 | 加深派生 #F3E4C8 作 clay 边 | 派生量记入 token 表，不越 MASTER 语义 |
|
||||||
|
| 中文无 Varela 对应字 | 数字/拉丁用 Varela，中文系统栈 | 字体 personality 由数字承载（题材：天数与百分比正是主角） |
|
||||||
|
| 图标 | 内联 SVG（lucide 线性、圆头、统一 2px 描边） | pro-max：禁 emoji 图标、一套图标一种描边 |
|
||||||
|
|
||||||
|
**结论：计划相对独特（手账印章世界 + 单一墨章 + clay 手感），可以进入构建。**
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 128 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 64 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 118 KiB |
@@ -0,0 +1,63 @@
|
|||||||
|
# le-app-design 集成测试报告（单元 + E2E）
|
||||||
|
|
||||||
|
- 日期：2026-11-07 · 环境：ZCode Desktop（darwin-arm64）· 测试执行：本会话（skill 创建过程内）
|
||||||
|
- 结论：**全绿。三个上游 Skill 在同一设计任务中被真实安装、解析、调用并协同工作，全程留有机器可查证据。**
|
||||||
|
- E2E 运行目录（完整证据）：本目录 + 源运行目录 `/tmp/lead-e2e-habit/le-app-design-runs/e2e-habit/`
|
||||||
|
|
||||||
|
## 一、被测对象
|
||||||
|
|
||||||
|
`skills/le-app-design/`：编排器 Skill。三个上游为必需依赖：ui-ux-pro-max（MIT）、frontend-design（Apache-2.0, Anthropic）、impeccable（Apache-2.0, pbakaus）。本测试验证的不是「文件存在」，而是「真实调用发生且产生效果」。
|
||||||
|
|
||||||
|
## 二、单元级测试
|
||||||
|
|
||||||
|
| # | 用例 | 结果 |
|
||||||
|
|---|---|---|
|
||||||
|
| 1 | check_deps 正例：三方解析 + 活性（pro-max 真跑检索 / impeccable 二进制 4.8.0 / frontend-design 原文 9390B + sha256） | ✅ exit 0，deps.json `ok=true` |
|
||||||
|
| 2 | check_deps 负例：根全部指向不存在路径 | ✅ exit 1，逐项报缺失原因与安装指引 |
|
||||||
|
| 3 | evidence_report 空账本 | ✅ FAIL exit 1（验收门有效） |
|
||||||
|
| 4 | log_call exec / load / 失败命令 | ✅ 三形态记账；退出码透传（/usr/bin/false→1）；失败调用留痕 |
|
||||||
|
| 5 | validate_skill 结构体检 | ✅ 10/10 |
|
||||||
|
| 6 | trigger_eval 触发冒烟 | ✅ 11/11 一致（含 3 条单上游直连负例） |
|
||||||
|
|
||||||
|
过程中抓到并修复 1 个真实 bug：log_call.py 最初用 argparse REMAINDER，会把 `--run-dir` 等选项吞进子命令（命令 127、账本写错目录）——改为手工按裸 `--` 切分后全部通过。
|
||||||
|
|
||||||
|
## 三、E2E：HabitFlow 习惯打卡 App（S0–S7 全程真跑）
|
||||||
|
|
||||||
|
**任务**：移动 Web 高保真原型，今日页 + 统计页（390×844，兼容 375），Operate 模式。
|
||||||
|
|
||||||
|
| 阶段 | 上游真实调用（calls.jsonl 编号） | 实际效果 |
|
||||||
|
|---|---|---|
|
||||||
|
| S0 依赖门 | check_deps | 三方全绿，路径写入 deps.json |
|
||||||
|
| S1 产品理解 | — | BRIEF.md（模式归属 Operate + 假设标注） |
|
||||||
|
| S2 设计规范 | **ui-ux-pro-max** #1：`search.py --design-system --persist` | 产出 `design-system/habitflow/MASTER.md`（Claymorphism / 琥珀+绿 / Varela Round+Nunito Sans，91ms） |
|
||||||
|
| S3 视觉探索 | **frontend-design** #2：宿主 Skill 工具装载 + load 记账（sha256 d9197063…） | design-plan.md：两遍法 + AI 味特征清单逐条自检 + 4 项冲突裁决记录 |
|
||||||
|
| S4 高保真构建 | **impeccable** #3：craft-floor.md load | 可交互双屏原型 index.html；宿主 IAB 实测：打卡计数 3→4、toast 显示、375 无横滚 |
|
||||||
|
| S5 设计审查 | **impeccable** #4 context（exit 0，走 SCOPED_EXISTING_ALLOWED 通道）、#5 critique.md load、#6 `detect --json`（exit 2 = 2 findings） | 双独立 sub-agent（agent_5e37cec9 / agent_96a151e6）按 critique.md 硬性要求并行评审：A 26/36 + 3×P1；B 2 findings 均属实；快照持久化 `.impeccable/critique/` + trend 首跑 |
|
||||||
|
| S6 优化迭代 | **impeccable** #7 复跑 detect | 修复 3×P1 + 2×P2 + 7 项次要（撤章可见+恢复按钮、焦点保持、统计同源派生、5/5 峰值态、字阶 22→26px 等）；复测：flat-type-hierarchy 清零，仅剩 cream-palette（design-plan 已裁决保留：MASTER 钉死暖色系统+题材支撑，记录在案）；交互复验 4/4 预期通过 |
|
||||||
|
| S7 交付 | evidence_report | **PASS**：三方各有 ≥1 成功调用，6 项产物全部存在 |
|
||||||
|
|
||||||
|
**三方协同的直接证据链**：MASTER.md（pro-max 产出）→ design-plan 的裁决表引用 MASTER tokens（frontend-design 方法论消费 pro-max 数据）→ 原型 CSS 变量全部挂 MASTER（两者共同落地）→ detect findings + A 评审引用 craft-floor 与 MASTER 语义（impeccable 审查前两者产出）→ S6 修复同时响应 A 的 P1 与 B 的 detector finding（字阶）。
|
||||||
|
|
||||||
|
## 四、验收门语义说明（诚实边界）
|
||||||
|
|
||||||
|
- impeccable 两行 exit=2 的 detect 记录在统计表中计为「失败调用」——这是 evidence_report 的保守口径；按 impeccable 自身契约 exit 2 = 有 findings 的成功扫描（stdout JSON 已留账本）。验收门不以这两行判 FAIL，也不依赖它们凑数（impeccable 另有 3 条成功调用）。
|
||||||
|
- 浏览器 overlay 注入（live-server + detect.js）主动跳过，fallback 原因已写入 critique 报告 Run Notes；宿主 IAB 截图与交互实测承担了浏览器证据职责。
|
||||||
|
- E2E 中停点 1/2 未实际停顿：题目选择时用户已授权整段测试跑完；真实设计任务中停点仍为回合终止硬约束。
|
||||||
|
|
||||||
|
## 五、已知限制
|
||||||
|
|
||||||
|
1. cream-palette finding 保留（有意裁决，见 S6）。
|
||||||
|
2. detect 只扫 web markup（本交付形态即 Web，无影响）。
|
||||||
|
3. 截图依赖宿主浏览器（本机无 Chrome，用 ZCode IAB 的 setViewportSize+screenshot 实现；无宿主浏览器的 runtime 按 runtimes.md 声明 fallback）。
|
||||||
|
4. skill 触发行为尚未在新会话真实对话实测（trigger_eval 仅词面冒烟）——按惯例需新会话验证。
|
||||||
|
|
||||||
|
## 六、复现方式
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 skills/le-app-design/scripts/check_deps.py # S0
|
||||||
|
# S2：log_call.py ui-ux-pro-max -- python3 ~/.agents/skills/ui-ux-pro-max/scripts/search.py "…" --design-system --persist …
|
||||||
|
# S3：宿主 Skill 工具装载 frontend-design；log_call.py frontend-design --load ~/.agents/skills/frontend-design/SKILL.md
|
||||||
|
# S5：sh ~/.agents/skills/impeccable/scripts/impeccable context / detect --json（经 log_call 包裹）
|
||||||
|
python3 skills/le-app-design/scripts/evidence_report.py --run-dir <RUN> … # S7
|
||||||
|
cat reports/e2e-habit/calls.jsonl # 全部 7 条原始调用记录
|
||||||
|
```
|
||||||
@@ -0,0 +1,220 @@
|
|||||||
|
{
|
||||||
|
"skill": "le-app-design",
|
||||||
|
"date": "2026-11-07",
|
||||||
|
"threshold": 0.3,
|
||||||
|
"prediction_mode": "coverage_fallback",
|
||||||
|
"note": "词面冒烟测试；行为结论需真实对话实测（live_turns 字段手工补记）",
|
||||||
|
"cases": [
|
||||||
|
{
|
||||||
|
"text": "帮我设计一个习惯打卡 App，要能看的高保真原型",
|
||||||
|
"family": "full_design_cn",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.5,
|
||||||
|
"coverage_hits": [
|
||||||
|
"app",
|
||||||
|
"保真",
|
||||||
|
"原型",
|
||||||
|
"我设",
|
||||||
|
"真原",
|
||||||
|
"计一",
|
||||||
|
"设计",
|
||||||
|
"高保"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "把这个产品想法做成可交互的 UI 原型，从设计到成品",
|
||||||
|
"family": "full_design_cn",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.444,
|
||||||
|
"coverage_hits": [
|
||||||
|
"ui",
|
||||||
|
"个产",
|
||||||
|
"交互",
|
||||||
|
"产品",
|
||||||
|
"原型",
|
||||||
|
"可交",
|
||||||
|
"想法",
|
||||||
|
"设计"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "design an app for my recipe startup, high-fidelity prototype",
|
||||||
|
"family": "full_design_en",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.3,
|
||||||
|
"coverage_hits": [
|
||||||
|
"an",
|
||||||
|
"app",
|
||||||
|
"design"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "给我的工具类产品做一轮完整的设计：规范、视觉、原型加审查",
|
||||||
|
"family": "full_pipeline",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.476,
|
||||||
|
"coverage_hits": [
|
||||||
|
"产品",
|
||||||
|
"做一",
|
||||||
|
"原型",
|
||||||
|
"品做",
|
||||||
|
"完整",
|
||||||
|
"审查",
|
||||||
|
"整的",
|
||||||
|
"规范",
|
||||||
|
"视觉",
|
||||||
|
"设计"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "我要做个妈妈育儿 App，帮我把首页和详情页设计出来",
|
||||||
|
"family": "app_screens",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.5,
|
||||||
|
"coverage_hits": [
|
||||||
|
"app",
|
||||||
|
"和详",
|
||||||
|
"情页",
|
||||||
|
"把首",
|
||||||
|
"计出",
|
||||||
|
"设计",
|
||||||
|
"详情",
|
||||||
|
"页和",
|
||||||
|
"首页"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "用 le-app-design 把这个 idea 变成原型",
|
||||||
|
"family": "explicit_name",
|
||||||
|
"bucket": "should_trigger",
|
||||||
|
"coverage": 0.444,
|
||||||
|
"coverage_hits": [
|
||||||
|
"app",
|
||||||
|
"design",
|
||||||
|
"le",
|
||||||
|
"原型"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": true,
|
||||||
|
"expected_trigger": true,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "用 impeccable 审查一下这个页面",
|
||||||
|
"family": "single_upstream_direct",
|
||||||
|
"bucket": "should_not_trigger",
|
||||||
|
"coverage": 0.429,
|
||||||
|
"coverage_hits": [
|
||||||
|
"impeccable",
|
||||||
|
"审查",
|
||||||
|
"页面"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": true,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": false,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "ui-ux-pro-max 帮我查个配色",
|
||||||
|
"family": "single_upstream_direct",
|
||||||
|
"bucket": "should_not_trigger",
|
||||||
|
"coverage": 0.5,
|
||||||
|
"coverage_hits": [
|
||||||
|
"max",
|
||||||
|
"pro",
|
||||||
|
"ui",
|
||||||
|
"ux"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": true,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": false,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "帮我写一篇公众号文章",
|
||||||
|
"family": "other_le_skill",
|
||||||
|
"bucket": "should_not_trigger",
|
||||||
|
"coverage": 0.0,
|
||||||
|
"coverage_hits": [],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": true,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": false,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "给我生成一张 App 封面图",
|
||||||
|
"family": "image_only",
|
||||||
|
"bucket": "should_not_trigger",
|
||||||
|
"coverage": 0.25,
|
||||||
|
"coverage_hits": [
|
||||||
|
"app",
|
||||||
|
"生成"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": false,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "这个按钮的点击事件没反应，帮我修一下",
|
||||||
|
"family": "pure_dev",
|
||||||
|
"bucket": "should_not_trigger",
|
||||||
|
"coverage": 0.0,
|
||||||
|
"coverage_hits": [],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": false,
|
||||||
|
"verdict": "pass"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"text": "把这个页面布局调好看一点",
|
||||||
|
"family": "local_tweak",
|
||||||
|
"bucket": "near_neighbor",
|
||||||
|
"coverage": 0.1,
|
||||||
|
"coverage_hits": [
|
||||||
|
"页面"
|
||||||
|
],
|
||||||
|
"families_hit": [],
|
||||||
|
"negative_hit": false,
|
||||||
|
"predicted_trigger": false,
|
||||||
|
"expected_trigger": null,
|
||||||
|
"verdict": "boundary"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"summary": {
|
||||||
|
"scored": 11,
|
||||||
|
"mismatch": 0,
|
||||||
|
"pass_rate": 1.0
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,223 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""le-app-design 硬依赖门：解析并活性检查三个上游 Skill。
|
||||||
|
|
||||||
|
用法:
|
||||||
|
python3 check_deps.py [--out <RUN>/deps.json] [--quiet]
|
||||||
|
|
||||||
|
解析顺序: $LE_APP_DESIGN_DEP_ROOTS(冒号分隔) > ~/.agents/skills > ~/.zcode/skills
|
||||||
|
> ~/.codex/skills > ~/.claude/skills
|
||||||
|
（优先 ~/.agents/skills：impeccable 的 SKILL.md 自引用该路径。）
|
||||||
|
|
||||||
|
活性检查按依赖形态各自不同——这就是「真实调用形态」的机器定义:
|
||||||
|
ui-ux-pro-max 真跑一次 search.py 检索（stdout 含结果段即活）
|
||||||
|
frontend-design 校验 SKILL.md 原文完整可读（纯文档型 Skill，装载即调用）
|
||||||
|
impeccable 跑其自包含二进制 --version
|
||||||
|
|
||||||
|
全部通过 exit 0；任何缺失/失活 exit 1 并输出明确报告。仅 python3 标准库。
|
||||||
|
"""
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import hashlib
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import re
|
||||||
|
import subprocess
|
||||||
|
import sys
|
||||||
|
import tempfile
|
||||||
|
from datetime import datetime, timezone
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
SKILL_KEY = "le-app-design-dep-check"
|
||||||
|
|
||||||
|
UPSTREAMS = [
|
||||||
|
{
|
||||||
|
"key": "ui-ux-pro-max",
|
||||||
|
"repo": "nextlevelbuilder/ui-ux-pro-max-skill",
|
||||||
|
"license": "MIT",
|
||||||
|
"install": "git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill && 拷贝/链接其 .claude/skills/ui-ux-pro-max 到 ~/.agents/skills/ui-ux-pro-max",
|
||||||
|
"kind": "cli-search",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "frontend-design",
|
||||||
|
"repo": "anthropics/skills",
|
||||||
|
"license": "Apache-2.0",
|
||||||
|
"install": "git clone https://github.com/anthropics/skills && 拷贝/链接 skills/frontend-design 到 ~/.agents/skills/frontend-design",
|
||||||
|
"kind": "doc-guidance",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "impeccable",
|
||||||
|
"repo": "pbakaus/impeccable",
|
||||||
|
"license": "Apache-2.0",
|
||||||
|
"install": "git clone https://github.com/pbakaus/impeccable && 拷贝/链接到 ~/.agents/skills/impeccable（含 scripts/ 自包含二进制）",
|
||||||
|
"kind": "cli-engine",
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
FRONTMATTER_MIN_BYTES = 2000 # frontend-design 原文约 10KB；残缺副本在此拦下
|
||||||
|
|
||||||
|
|
||||||
|
def candidate_roots() -> list[Path]:
|
||||||
|
roots: list[Path] = []
|
||||||
|
env = os.environ.get("LE_APP_DESIGN_DEP_ROOTS", "")
|
||||||
|
for part in env.split(os.pathsep):
|
||||||
|
if part.strip():
|
||||||
|
roots.append(Path(part).expanduser())
|
||||||
|
home = Path.home()
|
||||||
|
roots += [
|
||||||
|
home / ".agents" / "skills",
|
||||||
|
home / ".zcode" / "skills",
|
||||||
|
home / ".codex" / "skills",
|
||||||
|
home / ".claude" / "skills",
|
||||||
|
]
|
||||||
|
seen: set[str] = set()
|
||||||
|
unique: list[Path] = []
|
||||||
|
for r in roots:
|
||||||
|
key = str(r)
|
||||||
|
if key not in seen:
|
||||||
|
seen.add(key)
|
||||||
|
unique.append(r)
|
||||||
|
return unique
|
||||||
|
|
||||||
|
|
||||||
|
def read_frontmatter_name(skill_md: Path) -> str | None:
|
||||||
|
try:
|
||||||
|
text = skill_md.read_text(encoding="utf-8", errors="replace")
|
||||||
|
except OSError:
|
||||||
|
return None
|
||||||
|
m = re.match(r"^---\s*\n(.*?\n)?---", text, re.DOTALL)
|
||||||
|
if not m:
|
||||||
|
return None
|
||||||
|
block = m.group(1) or ""
|
||||||
|
nm = re.search(r"^name:\s*['\"]?([A-Za-z0-9_-]+)", block, re.MULTILINE)
|
||||||
|
return nm.group(1) if nm else None
|
||||||
|
|
||||||
|
|
||||||
|
def resolve(key: str) -> tuple[Path | None, str]:
|
||||||
|
"""返回 (解析到的目录, 说明)。"""
|
||||||
|
for root in candidate_roots():
|
||||||
|
dep_dir = root / key
|
||||||
|
skill_md = dep_dir / "SKILL.md"
|
||||||
|
if skill_md.is_file():
|
||||||
|
name = read_frontmatter_name(skill_md)
|
||||||
|
if name == key:
|
||||||
|
return dep_dir, f"resolved at {dep_dir}"
|
||||||
|
return dep_dir, f"SKILL.md frontmatter name={name!r} != {key!r}（目录在但身份不符）"
|
||||||
|
return None, "not found in any candidate root"
|
||||||
|
|
||||||
|
|
||||||
|
def _run(cmd: list[str], timeout: int = 90) -> subprocess.CompletedProcess:
|
||||||
|
env = dict(os.environ, PYTHONDONTWRITEBYTECODE="1")
|
||||||
|
return subprocess.run(
|
||||||
|
cmd, capture_output=True, text=True, timeout=timeout, env=env
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def liveness(spec: dict, dep_dir: Path) -> tuple[bool, str]:
|
||||||
|
key, kind = spec["key"], spec["kind"]
|
||||||
|
try:
|
||||||
|
if kind == "cli-search":
|
||||||
|
script = dep_dir / "scripts" / "search.py"
|
||||||
|
if not script.is_file():
|
||||||
|
return False, f"missing {script}"
|
||||||
|
with tempfile.TemporaryDirectory() as td:
|
||||||
|
proc = subprocess.run(
|
||||||
|
[sys.executable, str(script), "mobile app", "--domain", "style", "-n", "1"],
|
||||||
|
capture_output=True, text=True, timeout=90, cwd=td,
|
||||||
|
env=dict(os.environ, PYTHONDONTWRITEBYTECODE="1"),
|
||||||
|
)
|
||||||
|
if proc.returncode != 0:
|
||||||
|
return False, f"search.py exit={proc.returncode}: {proc.stderr.strip()[:300]}"
|
||||||
|
if "Result" not in proc.stdout:
|
||||||
|
return False, "search.py exit=0 but no result section in stdout"
|
||||||
|
return True, "search.py live query ok"
|
||||||
|
|
||||||
|
if kind == "doc-guidance":
|
||||||
|
skill_md = dep_dir / "SKILL.md"
|
||||||
|
try:
|
||||||
|
data = skill_md.read_bytes()
|
||||||
|
except OSError as e:
|
||||||
|
return False, f"unreadable SKILL.md: {e}"
|
||||||
|
if len(data) < FRONTMATTER_MIN_BYTES:
|
||||||
|
return False, f"SKILL.md only {len(data)} bytes (<{FRONTMATTER_MIN_BYTES}); likely truncated copy"
|
||||||
|
text = data.decode("utf-8", errors="replace")
|
||||||
|
if "name: frontend-design" not in text or "description:" not in text:
|
||||||
|
return False, "SKILL.md frontmatter incomplete"
|
||||||
|
return True, f"original SKILL.md intact ({len(data)} bytes, sha256 {hashlib.sha256(data).hexdigest()[:12]}…)"
|
||||||
|
|
||||||
|
if kind == "cli-engine":
|
||||||
|
launcher = dep_dir / "scripts" / "impeccable"
|
||||||
|
if not launcher.is_file():
|
||||||
|
return False, f"missing launcher {launcher}"
|
||||||
|
proc = _run(["sh", str(launcher), "--version"])
|
||||||
|
if proc.returncode != 0:
|
||||||
|
return False, f"impeccable --version exit={proc.returncode}: {proc.stderr.strip()[:300]}"
|
||||||
|
version = (proc.stdout or "").strip() or (proc.stderr or "").strip()
|
||||||
|
return True, f"impeccable binary ok ({version[:60]})"
|
||||||
|
except subprocess.TimeoutExpired:
|
||||||
|
return False, f"{key} liveness check timed out"
|
||||||
|
except OSError as e:
|
||||||
|
return False, f"liveness check error: {e}"
|
||||||
|
return False, "unknown kind"
|
||||||
|
|
||||||
|
|
||||||
|
def main() -> int:
|
||||||
|
ap = argparse.ArgumentParser(description="le-app-design 依赖门")
|
||||||
|
ap.add_argument("--out", help="JSON 结果写入路径（如 <RUN>/deps.json）")
|
||||||
|
ap.add_argument("--quiet", action="store_true", help="只输出摘要一行")
|
||||||
|
args = ap.parse_args()
|
||||||
|
|
||||||
|
result = {
|
||||||
|
"skill": SKILL_KEY,
|
||||||
|
"ts": datetime.now(timezone.utc).isoformat(timespec="seconds"),
|
||||||
|
"roots_searched": [str(r) for r in candidate_roots()],
|
||||||
|
"deps": {},
|
||||||
|
"ok": False,
|
||||||
|
}
|
||||||
|
|
||||||
|
for spec in UPSTREAMS:
|
||||||
|
dep_dir, note = resolve(spec["key"])
|
||||||
|
entry = {
|
||||||
|
"repo": spec["repo"],
|
||||||
|
"license": spec["license"],
|
||||||
|
"kind": spec["kind"],
|
||||||
|
"path": str(dep_dir) if dep_dir else None,
|
||||||
|
"alive": False,
|
||||||
|
"check": note if dep_dir is None else "",
|
||||||
|
"install": spec["install"],
|
||||||
|
}
|
||||||
|
if dep_dir is not None:
|
||||||
|
alive, check = liveness(spec, dep_dir)
|
||||||
|
entry["alive"] = alive
|
||||||
|
entry["check"] = check
|
||||||
|
result["deps"][spec["key"]] = entry
|
||||||
|
|
||||||
|
result["ok"] = all(d["alive"] for d in result["deps"].values())
|
||||||
|
|
||||||
|
if args.out:
|
||||||
|
out_path = Path(args.out).expanduser()
|
||||||
|
out_path.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
out_path.write_text(json.dumps(result, ensure_ascii=False, indent=2), encoding="utf-8")
|
||||||
|
|
||||||
|
lines = []
|
||||||
|
for key, d in result["deps"].items():
|
||||||
|
mark = "✅" if d["alive"] else "❌"
|
||||||
|
where = d["path"] or "未找到"
|
||||||
|
lines.append(f"{mark} {key:18} {where}")
|
||||||
|
if not d["alive"]:
|
||||||
|
lines.append(f" 原因: {d['check']}")
|
||||||
|
lines.append(f" 安装: {d['install']}")
|
||||||
|
verdict = "依赖门通过（三方解析且活性正常）" if result["ok"] else "依赖门未通过——禁止继续设计流程"
|
||||||
|
if args.quiet:
|
||||||
|
print(f"{'PASS' if result['ok'] else 'FAIL'}: " + ", ".join(
|
||||||
|
f"{k}={'ok' if v['alive'] else 'MISSING'}" for k, v in result["deps"].items()))
|
||||||
|
else:
|
||||||
|
print("\n".join(lines))
|
||||||
|
print(verdict)
|
||||||
|
if args.out:
|
||||||
|
print(f"JSON: {args.out}")
|
||||||
|
return 0 if result["ok"] else 1
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
sys.exit(main())
|
||||||
@@ -0,0 +1,140 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""le-app-design 验收门：从 calls.jsonl 生成本次运行的集成证据报告。
|
||||||
|
|
||||||
|
用法:
|
||||||
|
python3 evidence_report.py --run-dir <RUN> [--out <RUN>/INTEGRATION-REPORT.md] \
|
||||||
|
[--artifact <路径>]... [--title "任务名"]
|
||||||
|
|
||||||
|
验收规则（硬门）:
|
||||||
|
三个上游 ui-ux-pro-max / frontend-design / impeccable 各需 ≥1 条成功调用
|
||||||
|
（exec 且 exit_code==0，或 load 且 exit_code==0）。
|
||||||
|
--artifact 指定的每个文件必须存在。
|
||||||
|
任一不满足 → 报告标 FAIL，exit 1；全满足 → PASS，exit 0。
|
||||||
|
|
||||||
|
报告内容: 判定横幅、三方调用统计表、逐条调用清单（时间/依赖/命令/退出码）、
|
||||||
|
产物核验清单、失败与缺口说明。这份报告就是「真实集成」的可检查证据。
|
||||||
|
仅 python3 标准库。
|
||||||
|
"""
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
from datetime import datetime, timezone
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
GATE_DEPS = ["ui-ux-pro-max", "frontend-design", "impeccable"]
|
||||||
|
|
||||||
|
|
||||||
|
def load_records(ledger: Path) -> list[dict]:
|
||||||
|
if not ledger.is_file():
|
||||||
|
return []
|
||||||
|
records = []
|
||||||
|
for line in ledger.read_text(encoding="utf-8", errors="replace").splitlines():
|
||||||
|
line = line.strip()
|
||||||
|
if not line:
|
||||||
|
continue
|
||||||
|
try:
|
||||||
|
rec = json.loads(line)
|
||||||
|
except json.JSONDecodeError:
|
||||||
|
records.append({"dep": "(unparsable)", "kind": "raw", "exit_code": None, "command": line[:120], "ts": ""})
|
||||||
|
continue
|
||||||
|
records.append(rec)
|
||||||
|
return records
|
||||||
|
|
||||||
|
|
||||||
|
def is_success(rec: dict) -> bool:
|
||||||
|
return rec.get("exit_code") == 0 and rec.get("kind") in ("exec", "load")
|
||||||
|
|
||||||
|
|
||||||
|
def one_line(rec: dict) -> str:
|
||||||
|
cmd = rec.get("command", "")
|
||||||
|
try: # exec 记录的 command 是 JSON 数组字符串
|
||||||
|
parts = json.loads(cmd)
|
||||||
|
if isinstance(parts, list):
|
||||||
|
cmd = " ".join(str(p) for p in parts)
|
||||||
|
except (json.JSONDecodeError, TypeError):
|
||||||
|
pass
|
||||||
|
return cmd if len(cmd) <= 160 else cmd[:157] + "..."
|
||||||
|
|
||||||
|
|
||||||
|
def main() -> int:
|
||||||
|
ap = argparse.ArgumentParser(description="le-app-design 验收门")
|
||||||
|
ap.add_argument("--run-dir", required=True)
|
||||||
|
ap.add_argument("--out", default=None, help="报告写入路径，缺省 <run-dir>/INTEGRATION-REPORT.md")
|
||||||
|
ap.add_argument("--artifact", action="append", default=[], help="须存在的交付物路径（可多次）")
|
||||||
|
ap.add_argument("--title", default="le-app-design 集成证据报告")
|
||||||
|
args = ap.parse_args()
|
||||||
|
|
||||||
|
run_dir = Path(args.run_dir).expanduser()
|
||||||
|
records = load_records(run_dir / "calls.jsonl")
|
||||||
|
out_path = Path(args.out).expanduser() if args.out else run_dir / "INTEGRATION-REPORT.md"
|
||||||
|
|
||||||
|
stats = {dep: {"ok": 0, "fail": 0} for dep in GATE_DEPS}
|
||||||
|
for rec in records:
|
||||||
|
dep = rec.get("dep")
|
||||||
|
if dep in stats:
|
||||||
|
stats[dep]["ok" if is_success(rec) else "fail"] += 1
|
||||||
|
|
||||||
|
gate_pass = all(stats[d]["ok"] >= 1 for d in GATE_DEPS)
|
||||||
|
artifacts_missing = [a for a in args.artifact if not Path(a).expanduser().exists()]
|
||||||
|
overall = gate_pass and not artifacts_missing
|
||||||
|
|
||||||
|
lines: list[str] = []
|
||||||
|
lines.append(f"# {args.title}")
|
||||||
|
lines.append("")
|
||||||
|
lines.append(f"- 运行目录: `{run_dir}`")
|
||||||
|
lines.append(f"- 生成时间: {datetime.now(timezone.utc).isoformat(timespec='seconds')}")
|
||||||
|
lines.append(f"- 调用记录: {len(records)} 条（`calls.jsonl`）")
|
||||||
|
lines.append("")
|
||||||
|
lines.append(f"## 判定: {'✅ PASS' if overall else '❌ FAIL'}")
|
||||||
|
lines.append("")
|
||||||
|
lines.append("| 上游 | 成功调用 | 失败调用 | 门(≥1 成功) |")
|
||||||
|
lines.append("|---|---|---|---|")
|
||||||
|
for dep in GATE_DEPS:
|
||||||
|
s = stats[dep]
|
||||||
|
lines.append(f"| {dep} | {s['ok']} | {s['fail']} | {'✅' if s['ok'] >= 1 else '❌ 未被真实调用'} |")
|
||||||
|
lines.append("")
|
||||||
|
|
||||||
|
if artifacts_missing:
|
||||||
|
lines.append("**缺失产物:**")
|
||||||
|
for a in artifacts_missing:
|
||||||
|
lines.append(f"- ❌ `{a}`")
|
||||||
|
lines.append("")
|
||||||
|
elif args.artifact:
|
||||||
|
lines.append("**产物核验:**")
|
||||||
|
for a in args.artifact:
|
||||||
|
lines.append(f"- ✅ `{a}`")
|
||||||
|
lines.append("")
|
||||||
|
|
||||||
|
lines.append("## 调用清单")
|
||||||
|
lines.append("")
|
||||||
|
lines.append("| # | 时间(UTC) | 依赖 | 类型 | 退出码 | 命令/装载 |")
|
||||||
|
lines.append("|---|---|---|---|---|---|")
|
||||||
|
for i, rec in enumerate(records, 1):
|
||||||
|
lines.append(
|
||||||
|
f"| {i} | {rec.get('ts', '')} | {rec.get('dep', '?')} | {rec.get('kind', '?')} "
|
||||||
|
f"| {rec.get('exit_code', '?')} | `{one_line(rec)}` |"
|
||||||
|
)
|
||||||
|
lines.append("")
|
||||||
|
|
||||||
|
if not overall:
|
||||||
|
lines.append("## 缺口说明")
|
||||||
|
lines.append("")
|
||||||
|
for dep in GATE_DEPS:
|
||||||
|
if stats[dep]["ok"] < 1:
|
||||||
|
lines.append(f"- `{dep}` 无成功调用记录——该上游未被真实使用，本次流程**不得标记为成功**。")
|
||||||
|
for a in artifacts_missing:
|
||||||
|
lines.append(f"- 产物缺失: `{a}`")
|
||||||
|
lines.append("")
|
||||||
|
|
||||||
|
report = "\n".join(lines)
|
||||||
|
out_path.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
out_path.write_text(report + "\n", encoding="utf-8")
|
||||||
|
print(report)
|
||||||
|
print(f"\n[report] {'PASS' if overall else 'FAIL'} → {out_path}", file=sys.stderr)
|
||||||
|
return 0 if overall else 1
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
sys.exit(main())
|
||||||
@@ -0,0 +1,140 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""le-app-design 证据账本：所有对上游 Skill 的真实调用经此包裹，落入 calls.jsonl。
|
||||||
|
|
||||||
|
用法:
|
||||||
|
执行型调用（CLI 类上游）:
|
||||||
|
python3 log_call.py <dep> --run-dir <RUN> -- python3 <DEP>/scripts/search.py "…" --design-system
|
||||||
|
装载型调用（文档型上游 / playbook）:
|
||||||
|
python3 log_call.py <dep> --run-dir <RUN> --load <DEP>/SKILL.md
|
||||||
|
|
||||||
|
dep ∈ {ui-ux-pro-max, frontend-design, impeccable, le-app-design(自检)}
|
||||||
|
--run-dir 缺省时按序: $LE_APP_DESIGN_RUN_DIR > <cwd>/le-app-design-runs/<UTC 时间戳>-run/
|
||||||
|
|
||||||
|
行为:
|
||||||
|
- exec: 运行命令，透传 stdout/stderr，透传退出码；成功失败都记账。
|
||||||
|
- load: 读文件记 sha256 与字节数（证明用的是原文而非转述），文件缺失记 FAIL 退出 1。
|
||||||
|
- 记录字段: ts / dep / kind / command / exit_code / duration_ms / stdout_tail /
|
||||||
|
stderr_tail / bytes / sha256 / note。stdout/stderr 仅保留尾部 4000 字符防账本膨胀。
|
||||||
|
|
||||||
|
仅 python3 标准库。
|
||||||
|
"""
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import hashlib
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import subprocess
|
||||||
|
import sys
|
||||||
|
import time
|
||||||
|
from datetime import datetime, timezone
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
TAIL = 4000
|
||||||
|
KNOWN_DEPS = {"ui-ux-pro-max", "frontend-design", "impeccable", "le-app-design"}
|
||||||
|
|
||||||
|
|
||||||
|
def default_run_dir() -> Path:
|
||||||
|
env = os.environ.get("LE_APP_DESIGN_RUN_DIR")
|
||||||
|
if env:
|
||||||
|
return Path(env).expanduser()
|
||||||
|
stamp = datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%SZ")
|
||||||
|
return Path.cwd() / "le-app-design-runs" / f"{stamp}-run"
|
||||||
|
|
||||||
|
|
||||||
|
def append_record(run_dir: Path, record: dict) -> Path:
|
||||||
|
run_dir.mkdir(parents=True, exist_ok=True)
|
||||||
|
ledger = run_dir / "calls.jsonl"
|
||||||
|
with ledger.open("a", encoding="utf-8") as f:
|
||||||
|
f.write(json.dumps(record, ensure_ascii=False) + "\n")
|
||||||
|
return ledger
|
||||||
|
|
||||||
|
|
||||||
|
def confirm(dep: str, kind: str, status: str, ledger: Path, extra: str = "") -> None:
|
||||||
|
print(
|
||||||
|
f"[log_call] {dep} {kind} {status} → {ledger}"
|
||||||
|
+ (f" ({extra})" if extra else ""),
|
||||||
|
file=sys.stderr,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def main() -> int:
|
||||||
|
# 手工在第一个裸 "--" 处切分：argparse 的 REMAINDER 会把 -- 之前的选项误吞进命令
|
||||||
|
argv = sys.argv[1:]
|
||||||
|
cmd: list[str] = []
|
||||||
|
if "--" in argv:
|
||||||
|
split = argv.index("--")
|
||||||
|
argv, cmd = argv[:split], argv[split + 1:]
|
||||||
|
|
||||||
|
ap = argparse.ArgumentParser(description="le-app-design 调用账本")
|
||||||
|
ap.add_argument("dep", help="上游标识: ui-ux-pro-max | frontend-design | impeccable | le-app-design")
|
||||||
|
ap.add_argument("--run-dir", default=None, help="运行目录（缺省自动创建）")
|
||||||
|
ap.add_argument("--note", default="", help="阶段/用途备注，如 S2-design-system")
|
||||||
|
ap.add_argument("--load", metavar="PATH", default=None, help="装载型调用：记录读取的原文文件")
|
||||||
|
args = ap.parse_args(argv)
|
||||||
|
|
||||||
|
dep = args.dep
|
||||||
|
if dep not in KNOWN_DEPS:
|
||||||
|
print(f"[log_call] 未知依赖标识 {dep!r}；允许: {sorted(KNOWN_DEPS)}", file=sys.stderr)
|
||||||
|
return 2
|
||||||
|
|
||||||
|
run_dir = Path(args.run_dir).expanduser() if args.run_dir else default_run_dir()
|
||||||
|
base = {"ts": datetime.now(timezone.utc).isoformat(timespec="seconds"), "dep": dep, "note": args.note}
|
||||||
|
|
||||||
|
if args.load:
|
||||||
|
path = Path(args.load).expanduser()
|
||||||
|
rec = dict(base, kind="load", command=f"load:{path}")
|
||||||
|
try:
|
||||||
|
data = path.read_bytes()
|
||||||
|
except OSError as e:
|
||||||
|
rec.update(exit_code=1, stderr_tail=f"read failed: {e}"[:TAIL])
|
||||||
|
ledger = append_record(run_dir, rec)
|
||||||
|
confirm(dep, "load", "FAIL", ledger, str(e))
|
||||||
|
return 1
|
||||||
|
rec.update(
|
||||||
|
exit_code=0,
|
||||||
|
bytes=len(data),
|
||||||
|
sha256=hashlib.sha256(data).hexdigest(),
|
||||||
|
)
|
||||||
|
ledger = append_record(run_dir, rec)
|
||||||
|
confirm(dep, "load", "OK", ledger, f"{len(data)} bytes sha256:{rec['sha256'][:12]}…")
|
||||||
|
return 0
|
||||||
|
|
||||||
|
if not cmd:
|
||||||
|
print("[log_call] 需要 --load PATH 或 -- <命令…>", file=sys.stderr)
|
||||||
|
return 2
|
||||||
|
|
||||||
|
rec = dict(base, kind="exec", command=json.dumps(cmd, ensure_ascii=False))
|
||||||
|
t0 = time.monotonic()
|
||||||
|
try:
|
||||||
|
proc = subprocess.run(
|
||||||
|
cmd, capture_output=True, text=True, timeout=900,
|
||||||
|
env=dict(os.environ, PYTHONDONTWRITEBYTECODE="1"),
|
||||||
|
)
|
||||||
|
rc, out, err = proc.returncode, proc.stdout or "", proc.stderr or ""
|
||||||
|
except subprocess.TimeoutExpired as e:
|
||||||
|
rc, out, err = 124, (e.stdout or b"").decode(errors="replace") if isinstance(e.stdout, bytes) else (e.stdout or ""), f"timeout after {e.timeout}s"
|
||||||
|
except FileNotFoundError as e:
|
||||||
|
rc, out, err = 127, "", f"command not found: {e}"
|
||||||
|
|
||||||
|
rec.update(
|
||||||
|
exit_code=rc,
|
||||||
|
duration_ms=int((time.monotonic() - t0) * 1000),
|
||||||
|
stdout_tail=out[-TAIL:],
|
||||||
|
stderr_tail=err[-TAIL:],
|
||||||
|
)
|
||||||
|
ledger = append_record(run_dir, rec)
|
||||||
|
if out:
|
||||||
|
sys.stdout.write(out)
|
||||||
|
if not out.endswith("\n"):
|
||||||
|
sys.stdout.write("\n")
|
||||||
|
if err:
|
||||||
|
sys.stderr.write(err)
|
||||||
|
if not err.endswith("\n"):
|
||||||
|
sys.stderr.write("\n")
|
||||||
|
confirm(dep, "exec", f"exit={rc}", ledger, f"{rec['duration_ms']}ms")
|
||||||
|
return rc
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
sys.exit(main())
|
||||||
Reference in New Issue
Block a user