admin
5afeb6b78a
一、④段整套同步（用户选候选 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。
101 lines
4.7 KiB
CSS
101 lines
4.7 KiB
CSS
/* ─────────────────────────────────────────────────────────────────────────
|
||
* design-systems/_schema/defaults.css
|
||
*
|
||
* Fallback values for every Layer A2 token in the shared schema.
|
||
*
|
||
* What this file is FOR:
|
||
* - A human-readable mirror of the `fallback` field on every A2
|
||
* entry in `tokens.schema.ts`. Reviewers can scan real CSS and
|
||
* spot weird defaults faster than they can read a TS array.
|
||
* - The future input to the derive script (PR-B): when a brand's
|
||
* DESIGN.md does not specify an A2 token, the script copies the
|
||
* declaration from this file into the brand's tokens.css.
|
||
*
|
||
* What this file is NOT FOR:
|
||
* - Runtime cascade. Artifacts are generated by agents pasting one
|
||
* brand's :root block into a single <style>. There is no global
|
||
* stylesheet that loads alongside the brand. A brand's tokens.css
|
||
* must therefore declare every A2 token directly — this file
|
||
* never reaches the browser.
|
||
*
|
||
* Drift contract:
|
||
* The `design-system: A2 defaults parity` guard check asserts that
|
||
* each declaration here matches the `fallback` field on the
|
||
* corresponding entry in `tokens.schema.ts`. Update both together.
|
||
*
|
||
* Tokens absent from this file:
|
||
* - A1-identity tokens (--bg, --fg, --accent, font stacks) have no
|
||
* defensible cross-brand default; brands must author them.
|
||
* - A1-structure tokens (type scale, container, section-y) are
|
||
* structural decisions that vary per brand by design.
|
||
* - B-slot tokens (--fg-2, --meta, --surface-warm, --border-soft)
|
||
* resolve via `var()` aliasing inside each brand's tokens.css,
|
||
* not via this file.
|
||
* - C-extension tokens are brand-specific and have no shared
|
||
* default by definition.
|
||
* ─────────────────────────────────────────────────────────────────── */
|
||
|
||
:root {
|
||
/* Accent states (over --accent bg). The black-mix formulas work for
|
||
mid-luminance accents; brands with very dark or very light accents
|
||
should override the value with a hand-picked one (e.g. kami binds
|
||
--accent-hover to var(--accent) because ink-blue cannot darken
|
||
further visibly). */
|
||
--accent-on: #ffffff;
|
||
--accent-hover: color-mix(in oklab, var(--accent), black 8%);
|
||
--accent-active: color-mix(in oklab, var(--accent), black 14%);
|
||
|
||
/* Semantic state. Reserve under 5% of any surface area; not all
|
||
brands need these — print-first kami inherits defaults rather than
|
||
designing custom warm equivalents. */
|
||
--success: #16a34a;
|
||
--warn: #eab308;
|
||
--danger: #dc2626;
|
||
|
||
/* Monospace. Every brand uses kbd / tabular-nums / code somewhere;
|
||
CJK brands override with a stack that includes their preferred
|
||
CJK monospace face (kami adds TsangerJinKai02 / Source Han Serif). */
|
||
--font-mono: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Monaco, Consolas, monospace;
|
||
|
||
/* Base spacing scale on a 4px grid. Identical across default and
|
||
kami today. Brands with a print-rooted rhythm (different physical
|
||
paper sizes) may rebind these wholesale; keep the names stable. */
|
||
--space-1: 4px;
|
||
--space-2: 8px;
|
||
--space-3: 12px;
|
||
--space-4: 16px;
|
||
--space-5: 20px;
|
||
--space-6: 24px;
|
||
--space-8: 32px;
|
||
--space-12: 48px;
|
||
|
||
/* Radius scale. Pill is functionally fixed at 9999px; the small /
|
||
medium / large tiers are defaults that brands routinely override
|
||
to express softness or sharpness as part of brand mood. */
|
||
--radius-sm: 8px;
|
||
--radius-md: 12px;
|
||
--radius-lg: 16px;
|
||
--radius-pill: 9999px;
|
||
|
||
/* Elevation. Three sanctioned levels (no fourth — that is
|
||
neumorphism territory). Brands forbidding blur shadows (kami,
|
||
paper, editorial) override --elev-raised with a whisper or
|
||
ring-only treatment. */
|
||
--elev-flat: none;
|
||
--elev-ring: 0 0 0 1px var(--border);
|
||
--elev-raised: 0 2px 8px color-mix(in oklab, var(--fg), transparent 92%);
|
||
|
||
/* Focus. Implemented as a box-shadow so it layers outside the
|
||
element without affecting layout. Brands forbidding cool-blue
|
||
glows must override; rebind via accent or a hand-picked ring. */
|
||
--focus-ring: 0 0 0 3px color-mix(in oklab, var(--accent), transparent 70%);
|
||
|
||
/* Motion. Two durations + one easing curve, per the anti-ai-slop
|
||
"short, purposeful transitions (150–250ms) with stable easing"
|
||
contract. Add a third duration only when a real interaction
|
||
needs it; do not invent --motion-slow speculatively. */
|
||
--motion-fast: 150ms;
|
||
--motion-base: 200ms;
|
||
--ease-standard: cubic-bezier(0.2, 0, 0, 1);
|
||
}
|