一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
· 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
· 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
横向流程图每步写清页面/功能/操作/完成判据。
· 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
· 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。
二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
3.6 KiB
3.6 KiB
Mobile app checklist
Run this before emitting <artifact>. P0 must pass.
P0 — must pass
- Frame looks like a phone, not a generic card. Dynamic Island visible, status bar SVG icons present (signal/wifi/battery), home indicator at bottom. The seed already does this — verify you didn't accidentally delete the island/rails/indicator markup.
- Status bar shows real glyphs, not text like
· · · 5G · 100%. Use the SVG icons from the seed. - Home indicator is the last visible thing. Anything below it (e.g. extra padding, accidental
<div>) breaks the illusion. - Content scrolls, frame doesn't.
<main class="content">hasoverflow-y: auto; the surrounding.devicedoes not. The page background never moves. - Tap targets ≥ 44px tall. The seed's
.btn-primary(48px),.tab(~50px),.icon-btn(36px ≥ touch with padding),.list-row(≥48px with padding) all pass. Don't ship a button under 44px. - Body text ≥ 14px.
--fs-body: 15pxalready enforces this on most copy. List-row sub text uses 13px max — that's the floor. - One accent, used at most twice on the screen. Typically: one active tab + one CTA, OR one accent card + one tab. Never three.
- No external image URLs. Use the
.ph-imgplaceholder class. External CDN images break the OD preview iframe and look fake when they 404. - Tab bar matches the screen kind. Onboarding / detail / checkout: drop the
<nav class="tabbar">entirely. Feed / focus / profile: keep it. - Display headlines use
var(--font-display)(serif). The seed binds this via.h1,.h2,.header h1. Don't override headings to system-sans — it instantly looks like a stock template. - No emoji icons in the UI. SVG monoline only. Emoji in copy is fine ("9:41 ☀️ Tuesday" is not, but "Sunny day in Berlin" is).
data-od-idon the device, content, header, and any major sections.
P1 — should pass
- One screen, one job. A profile screen does profile things. Don't graft a checkout form onto a feed.
- Caption above the device names the screen (e.g. "FILEBASE · INBOX"). The seed already has the slot — fill it.
- Status bar time is
9:41(Apple convention) unless the brief asks otherwise. - Mono font for numerics — counts, prices, durations, dates. The seed's
.numclass binds this. - Real, specific copy. "Mira Hassan · CTO" beats "User Name". "$1,920" beats "$X,XXX".
- First-screen content fits inside the 844px frame without requiring scroll for the primary action. If the CTA is below the fold, it's the wrong layout.
P2 — nice to have
- Subtle accent radial gradient on the page background (already in seed). Removing it makes the device feel pasted onto a flat sheet.
- Backdrop-blurred tab bar (already in seed via
backdrop-filter). - At most one image placeholder per screen. Two placeholders on a small canvas competes for attention.
- Subtle metallic side rails on the bezel (already in seed via
::before/::after).
Anti-fake-device checklist
If any of these are true, the screen looks like a card pretending to be a phone rather than a phone:
- The device's outer corners aren't visibly more rounded (~56px) than the inner screen (~44px).
- There's no Dynamic Island gap at the top centre.
- The status bar text is grey or low-opacity (it should be
var(--fg)at full strength). - The home indicator is missing.
- The bottom tab bar has no top border or no backdrop blur.
The seed prevents all of these — the most common regression is the agent rewriting the frame with border-radius: 24px and losing the depth.