一、④段整套同步(用户选候选 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。
14 KiB
name, description, triggers, od
| name | description | triggers | od | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| waitlist-page | Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects. |
|
|
Waitlist Page Skill
Pre-launch pages are your first handshake with future users. This skill builds a focused, honest entrance: your brand identity, what you're making, one clear path to join the early list. No artificial scarcity, no fake countdown, no inflation tactics—just a clean, mobile-first vessel for genuine interest.
Workflow
Preflight: Load hardened template and brand foundation
- Load the brand identity — Read
DESIGN.mdfor the color system, font pairing, and spatial rules. This is your foundation. A waitlist page lives or dies by consistency with the brand it represents. IfDESIGN.mdis missing, ask the user to provide one before you proceed. - Read and copy the reusable template — Read
assets/template.html. This template is the hardened seed for all outputs. Copy it toindex.htmlas your base. Do not write HTML from scratch or deviate from this structure. The template has all required layout, form structure, decorations, focus styles, and accessibility scaffolding baked in.
Steps: Token replacement with validation and escaping
- Map tokens from inputs — For each placeholder in the template (e.g.,
{{PRODUCT_NAME}},{{BG_EXPRESSION}},{{BORDER_EXPRESSION}},{{LOGO_MARK}}), follow the replacement rules below:- Text tokens (
{{PRODUCT_NAME}},{{TAGLINE}}): HTML-escape<,>,&,",'before insertion into HTML text nodes or attribute values. - HTML tokens (
{{LOGO_MARK}}): If using text initials, HTML-escape them by default. If using inline SVG, you must strictly sanitize it using an allowlist: strip<script>tags, event handlers (on*),<foreignObject>, external refs (href,xlink:href,url()), and any disallowed attributes/elements before insertion. If the SVG cannot be safely sanitized, fallback to escaped text initials. Never emit raw, unsanitized arbitrary HTML. Ensure any SVG scales cleanly within its container. - Color expression tokens (
{{BG_EXPRESSION}},{{FG_EXPRESSION}},{{ACCENT_EXPRESSION}},{{DECO_EXPRESSION}},{{STRIPE_EXPRESSION}},{{SUCCESS_EXPRESSION}},{{BORDER_EXPRESSION}},{{BTN_LABEL_EXPRESSION}},{{TICKER_BG_EXPRESSION}},{{TICKER_FG_EXPRESSION}},{{DECO_STROKE_EXPRESSION}},{{LOGO_SHADOW_EXPRESSION}},{{LOGO_FG_EXPRESSION}}): Must strictly adhere to an explicit color grammar (#hex,rgb/rgba,hsl/hsla,oklch, orcolor-mix()using only local variables). Hard reject any input containing;,{},<,>, comments (/*),@,url(, or external refs to prevent CSS injection. Do not wrap in#or add extra quotes. Examples:rgba(196, 169, 154, 0.38),color-mix(in srgb, var(--fg) 38%, transparent),#FDE8DF. Insert as-is into:rootCSS variables. Derive--successfrom DESIGN.md if present; otherwise use the allowed fallback#2D6A4Fonly. - Font name tokens (
{{DISPLAY_FONT_CSS}},{{BODY_FONT_CSS}}): These are CSS font-family values, already quoted if they contain spaces (e.g.,'DM Sans',Syne). Insert as-is into--font-displayand--font-bodydeclarations; do NOT add extra quotes. - Font URL tokens (
{{DISPLAY_FONT_URL}},{{BODY_FONT_URL}}): Spaces must be encoded as+for the Google Fonts URL (e.g.,DM+Sans,IBM+Plex+Serif). Validate the URL is well-formed before insertion.
- Text tokens (
- Verify token mapping rules — All color tokens are now in CSS variables:
--bg={{BG_EXPRESSION}}(e.g.,#FDE8DF)--fg={{FG_EXPRESSION}}(e.g.,#1A1410)--accent={{ACCENT_EXPRESSION}}(brand badge)--deco={{DECO_EXPRESSION}}(decoration primary)--deco-stripe={{STRIPE_EXPRESSION}}(accent stripe)--input-border={{BORDER_EXPRESSION}}(full CSS expression with opacity)--success={{SUCCESS_EXPRESSION}}or#2D6A4Ffallback--btn-label={{BTN_LABEL_EXPRESSION}}(button text color for contrast)--ticker-bg={{TICKER_BG_EXPRESSION}}(animated ticker background)--ticker-fg={{TICKER_FG_EXPRESSION}}(animated ticker text)--deco-stroke={{DECO_STROKE_EXPRESSION}}(SVG strokes, typically muted with 12–15% opacity)--logo-shadow={{LOGO_SHADOW_EXPRESSION}}(logo container shadow, subtle foreground shade)--logo-fg={{LOGO_FG_EXPRESSION}}(contrasting text color for logo initials)
- Responsive layout — The template includes mobile-first scaling:
- 375px: form stacks to single column, logo shrinks to 40px, decoration compresses, no horizontal scroll.
- 768px: comfortable two-column breathing room.
- 1440px+: centered layout with generous whitespace.
- Verify all text remains readable and the email input + button are fully visible (no clipping) at 375×667 and 390×844.
Validation: Run hardened quality gates before emitting
- Run the quality checklist — Read
references/checklist.md. Validate every P0 gate before emitting:- Exactly one CTA (email form)
- No countdown timer, no fake social proof, no emoji
- No horizontal scroll at 375px
- Email input has
type="email"andrequired; first name has norequired - Form does NOT use
novalidate; JS usescheckValidity()guard - Success message has
role="status"oraria-live="polite" - All colors from DESIGN.md or allowed fallback; no invented hex values
- All user text is HTML-escaped; color tokens adhere to strict grammar; fonts are URL-encoded
- Pass P0 or do not emit. If any P0 gate fails, ask the user or fix the token mappings and try again.
- Verify P1 gates for quality submission (recommended):
- Hover and active states on submit button
- Form validation with clear feedback
- Ticker animation respects
prefers-reduced-motion: reduce - All interactive elements have visible focus styles (input:focus includes
outline) - Tab/Enter keyboard support
- WCAG AA contrast for body text (≥4.5:1) and button label (≥4.5:1)
- Logo alt/aria-label present; ticker has
aria-hidden="true" <html lang="">is set
Output
- Emit clean HTML — Single file, CSS inlined, SVG for graphics. Mark interactive elements with
data-od-id(headline, form, logo, ticker, grid, etc.) so agents can customize without parsing.
Quality gates
This skill enforces a hardened, template-based workflow to ensure compliance. You must follow this execution path; deviating from the template disqualifies the output.
Mandatory template-based execution:
- Read
assets/template.htmlas your base; do not write HTML from scratch. - Copy it to
index.htmland replace only the{{PLACEHOLDER}}tokens with validated/escaped values. - Run every P0 gate in
references/checklist.mdbefore emitting; if any fail, fix and re-validate.
P0 gates (must pass):
- Single CTA: Email form is the only interactive element. No nav, no secondary buttons, no social links.
- Logo placement: Fixed top-left, matches DESIGN.md accent color, scales down on mobile (50px → 40px).
- Color consistency: Every color from DESIGN.md palette. Only allowed hardcoded exception:
#2D6A4Ffor--success. - No anti-patterns: No countdown timer, no fake social proof, no emoji icons, no lorem ipsum.
- Content integrity: Headline and copy tie directly to
product_nameandtaglineinputs—no filler copy. - Mobile fit: No horizontal scroll at 375px. Email input and submit button are fully visible (no clipping) at 375×667 and 390×844. Vertical overflow is scrollable, not hidden.
- Typographic discipline: Display + body fonts only (2-font rule). Consistent sizing across sections.
- Form structure: Two fields (first name optional, email required),
checkValidity()guard, success message withrole="status". - Token escaping: All user-supplied text HTML-escaped; color tokens adhere to strict grammar and contain no unsafe characters (
;,{},<,>,/*,@,url(); font names are URL-encoded;{{LOGO_MARK}}is escaped text initials or strictly sanitized inline SVG (no scripts, no event handlers, no foreignObject, no external hrefs).
P1 gates (should pass for quality submission):
- Hero section visually distinct and above-the-fold.
- Email submit button has hover and active states.
- Form validation provides clear feedback.
- Page scrollable (not clipped) at all mobile viewports; CTA visible without scroll.
- Ticker animation paused/removed under
prefers-reduced-motion: reduce. - All interactive elements have visible focus styles (outline, not just outline:none).
- Keyboard: Tab reaches each form field; Enter submits.
- WCAG AA contrast: Body text ≥4.5:1, button label ≥4.5:1.
- Logo alt/aria-label present; ticker has
aria-hidden="true". <html lang="">set to correct language code.
Decoration restraint:
- Lower zone enhances without distraction. Opacity, subtle strokes, muted animation.
- No gradient that spans more than 20% of viewport height.
- Coil, stripe, grid, or ticker all use colors from DESIGN.md only.
Output
Only emit after all P0 gates in references/checklist.md pass.
Emit the artifact between tags:
<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>
One line of description above the artifact; nothing below.
Post-emission: If the user asks for changes, update the index.html in-place and re-run the P0 checklist gates before emitting the next version. Do not skip validation on iterations.