④段整套同步(六节 + 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。
This commit is contained in:
admin committed 2026-10-15 21:17:28 +08:00
1 parent fa0a9026c8
commit 5afeb6b78a
4184 files changed
+326 -70

No files matched your search

@@ -0,0 +1,83 @@
# Pre-emit checklist (P0 must pass; do not write index.html until green)
Quote each P0 row in your reply with `[x]` or `[ ]`. Do not emit while
any P0 is unchecked.
## Visual integrity
- [ ] **P0 — Display face**. Page title uses a system / Notion-leaning
sans (SF Pro / system-ui) or an editorial serif from the active
DESIGN.md. **Never Inter Display, never SF Pro Display at body
size, never Helvetica condensed.**
- [ ] **P0 — Accent restraint**. The `--accent` token appears at most
twice in the body markup (one Refresh button + one sparkline
stroke is canonical). No accent on KPI numbers.
- [ ] **P0 — No purple/pink gradient header**. The Notion idiom is
flat. Backgrounds are `#fff` or `var(--bg-soft)`.
- [ ] **P0 — Body contrast**. Body text vs. background ≥ 4.5:1.
Secondary text ≥ 4.0:1.
- [ ] **P0 — No emoji icon strip across the top**. Page-emoji is one,
semantically meaningful (`📊` for ops, `📓` for docs, `🚀` for
launch — never an emoji decoration row).
## Honesty (the most-violated rule)
- [ ] **P0 — No invented metric**. Every number is either provided by
the user, by the connector, or labeled as `—` / `Sample`.
Forbidden: "10× faster", "join 50,000 founders", "99.99% uptime"
unless the user supplied the literal number.
- [ ] **P0 — Sample-data badge**. When `inputs.connector === mock`,
the page must display "Sample data" in the live-pill or callout
so a screenshot of this artifact is never mistaken for real ops.
- [ ] **P0 — Plausible KPI ranges**. `Total tasks` < 500 for a small
team. `Active members` ≤ team size. `Done this week` ≤ Total.
## Connector wiring (only when connector !== mock)
- [ ] **P0 — `connectors.json` exists** at the project root. See
`connectors.md` for the schema.
- [ ] **P0 — Endpoints documented**. Every `fetch()` call inside
`index.html` corresponds to one entry in `connectors.json`.
- [ ] **P0 — No hardcoded secrets**. No API tokens, integration secrets,
OAuth client IDs, or workspace IDs in the markup. The OD daemon
resolves these via `media-config.json`.
- [ ] **P0 — Stale fallback**. On `fetch` error or > 90s without a
successful poll, the pill swaps to amber and the previous values
remain on screen. The artifact never goes blank.
## Structural
- [ ] **P0 — Single file**. `index.html` self-contained. No external
CSS/JS imports beyond the system font stack and one OD custom
element. No CDN URLs.
- [ ] **P0 — Sidebar collapses on `< 980px`**. The dashboard is
mobile-readable; sidebar hides, KPI grid stacks 2-up, table
drops `due` and `priority` columns.
- [ ] **P0 — `prefers-reduced-motion`**. All tweens and pulses are
disabled when `(prefers-reduced-motion: reduce)`.
- [ ] **P0 — `tabular-nums` on KPI values**. Numeric values shouldn't
jitter horizontally during tween or auto-refresh.
## Polish (P1)
- [ ] P1 — Refresh button shows a spinning ↻ for the duration of the
poll, then settles back. No layout shift.
- [ ] P1 — Activity feed: newly-inserted row gets a left-edge accent
bullet (•) and a soft accent background for 2s, then fades.
- [ ] P1 — Database row that just changed flashes the row background
with a 1.4s ease-out.
- [ ] P1 — Live-pill states: green pulse (idle), blue solid
(syncing), amber solid (stale).
- [ ] P1 — Sparkline grid lines are dashed, line-color from `--line`,
stroke-dasharray `2 3`. Dots are filled `--accent` r=3.
- [ ] P1 — Toast bottom-center, dark `#1f1f1f`, 1800ms auto-dismiss.
## Content
- [ ] P1 — Person chips: 18px round avatar, two-letter initials,
stable per-name color. No initials > 2 chars.
- [ ] P1 — Status pill copy uses Notion canonical labels:
"Done", "In progress", "Blocked", "In review", "To do".
Case matters: "In progress" not "In-Progress".
- [ ] P1 — Footer attribution names the source platform and the
connector slug exactly: `composio.notion`, `composio.linear`, etc.