0 Fork 0

Files

T

admin 5afeb6b78a ④段整套同步（六节＋ P/S/F/J ＋模板）＋ open-design 移到技能根

一、④段整套同步（用户选候选 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。

2026-10-15 21:17:28 +08:00

12 KiB

Raw Blame History

name, description, triggers, od, inputs, parameters, outputs, capabilities_required, example_prompt

name

description

triggers

inputs

parameters

outputs

capabilities_required

example_prompt

open-design-landing

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic OpenDesign uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

landing page

落地页

editorial site

magazine layout

hero collage

atelier zero

open design landing

open-design-landing

Build a single-page editorial landing site (or a slide deck — see the sibling open-design-landing-deck skill) in the Atelier Zero design system: warm-paper background, Inter Tight + Playfair Display, italic serif emphasis spans, dotted hairline rules, coral terminating dots, scroll-reveal motion, and 16 surreal collage plates.

This is the canonical OpenDesign marketing-page recipe — the example output is the very page you see at open-design.

The skill is fully parameterized. The agent fills one typed inputs.json from the user's brief; the composer turns that JSON + the canonical styles.css into a deployable artifact.

inputs.json + styles.css                       16 image slots
        │                                            │
        └──────────► scripts/compose.ts ◄────────────┘
                            │
                            ▼
              <out>/index.html  (self-contained)
              <out>/assets/      (PNG or SVG)

What you get

A single HTML file with all of:

Editorial topbar (volume / issue / language strip), Headroom-style sticky nav with live GitHub star count.
8 numbered Roman-numeral sections with paper-textured background: hero (with 3 stat rings + 4-step index), about, capabilities (4 cards), labs (5 cards + filter pills + progress bar), method (4 steps with thumbnails), selected work (dark slab + 2 tilted cards), testimonial (pull quote + 5 partner glyphs), CTA (ribbon + email pill).
Footer with 4 link columns + huge italic-serif kicker word.
Scroll-reveal motion on every section (IntersectionObserver, respects prefers-reduced-motion).
Fully responsive at 1280 / 1080 / 880 / 560 breakpoints.

Workflow contract

Run these four steps in order. The agent should complete each step before moving on, and prefer asking the user a focused question over inventing copy.

1. Gather brand inputs

Use AskQuestion (or the equivalent in your UI) to collect the brand brief in chunks; do not dump the entire schema.ts on the user. Map their answers into inputs.json matching the typed shape.

The eight question groups, in order:

Group	Schema fields	Min answers	Notes
1	`brand.{name,mark,tagline,description,location}`	5	Mark = single glyph (Ø, ▲, ★…)
2	`brand.{license,version,year,primary_url,contact_email}`	4	URL is required; license defaults Apache-2.0
3	`nav[]` (up to 5)	3	Optional count badges
4	`hero.{label,headline,lead,primary,secondary,stats}`	All	Headline as `MixedText` (sans+em+dot)
5	`about` + `capabilities.cards[4]`	All	4 cards × {num,tag,title,body}
6	`labs.cards[5]` + `method.steps[4]`	All	Both grids fixed-arity
7	`work.cards[2]` + `testimonial`	All	5 partner glyphs as inline SVG path data
8	`cta` + `footer.{columns[4],mega}`	All	Mega kicker is a `MixedText` like the headlines

Open inputs.example.json for a complete worked example (OpenDesign itself).

2. Decide the image strategy

Strategy	When to choose	Cost / latency
`placeholder`	First pass. Demo. Slide internal. No image budget yet.	$0, <1s
`generate`	Final delivery. Brand wants original collages.	~$0.40, ~6 min
`bring-your-own`	User has art direction PNGs. Drop them at `assets_path`.	$0, 0s

Set inputs.imagery.strategy accordingly.

`placeholder` — frame mode

npx tsx scripts/placeholder.ts <out>/assets/

Writes 16 .svg files (with .png aliases for compatibility) into <out>/assets/. Each placeholder shows the slot id, ratio, pixel dimensions, and the prompt hint from image-manifest.json. The composer's <img src='./assets/hero.png'> etc. just work.

`generate` — gpt-image-2 mode

FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/

Calls fal.ai's openai/gpt-image-2 synchronous endpoint per slot. Composes prompts as: style anchor (paper-collage editorial system)

brand variables (name / nav / headline / italic emphasis pulled from inputs.json) + per-slot composition (e.g. cropped plaster head + tree growing through arch). Skips slots whose target file already exists; pass --force to re-render.

Without FAL_KEY, the script prints the prompts so the operator can route them through the /gpt-image-fal slash-command skill manually.

`bring-your-own`

Drop 16 PNGs matching assets/image-manifest.json filenames at inputs.imagery.assets_path. Done.

3. Compose the artifact

npx tsx scripts/compose.ts <inputs.json> <out>/index.html

The composer reads inputs.json and ../styles.css, then writes one self-contained HTML file. The page includes:

The full Atelier Zero stylesheet, inlined.
All section markup with data-reveal attributes for staggered scroll motion.
Inline IntersectionObserver script for [data-reveal].
Inline Headroom nav script (mirrors header.tsx).
Inline GitHub star-count fetcher (auto-detects from brand.primary_url).

Self-check before delivering

Before marking done, the agent must verify:

<out>/index.html opens in a browser without console errors.
All 16 image slots load (no 404s in DevTools network tab).
Headline italic emphasis spans render in Playfair (not sans).
Coral terminating dots appear at every display h1/h2 end.
Scroll from top to bottom; every section animates in once.
Resize to 880px and 560px; no horizontal scroll, no overlap.
prefers-reduced-motion: reduce (DevTools → Rendering) disables transitions cleanly.
Lighthouse: contrast AA, font-display swap, no layout shift on the hero (CLS < 0.05).

Files in this skill

design-templates/open-design-landing/
├── SKILL.md                 # this contract
├── README.md                # quick-start
├── schema.ts                # typed inputs (single source of truth)
├── styles.css               # Atelier Zero stylesheet (single source of truth)
├── inputs.example.json      # OpenDesign as the worked example
├── example.html             # canonical rendering (regenerated from inputs.example.json)
├── scripts/
│   ├── compose.ts           # inputs.json + styles.css → index.html
│   ├── imagegen.ts          # gpt-image-2 wrapper (fal.ai)
│   └── placeholder.ts       # SVG paper-textured frames
└── assets/
    ├── *.png                # 16 collage plates (OpenDesign instance)
    ├── image-manifest.json  # slot → file/dimensions/prompt mapping
    └── imagegen-prompts.md  # human-readable prompt pack

Boundaries

Do not invent new colors or typefaces. Tokens live in design-systems/atelier-zero/DESIGN.md; extend the design system before adding a new ramp here.
Do not drop data-reveal attributes from generated markup. Without them the page goes static and feels dead.
Do not wrap the composed HTML in a framework that injects its own stylesheet ordering — Atelier Zero relies on stylesheet-order cascade for paper texture and z-index of side rails.
Do not add a separate stylesheet file that reorders Atelier Zero cascade; keep styles.css as the single visual source.

12 KiB Raw Blame History Unescape Escape

open-design-landing

What you get

Workflow contract

1. Gather brand inputs

2. Decide the image strategy

placeholder — frame mode

generate — gpt-image-2 mode

bring-your-own

3. Compose the artifact

Self-check before delivering

Files in this skill

Boundaries

See also

12 KiB

Raw Blame History

`placeholder` — frame mode

`generate` — gpt-image-2 mode

`bring-your-own`