④段整套同步(六节 + 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:
1 parent
fa0a9026c8
commit
5afeb6b78a
4184 files changed
+326
-70
No files matched your search
@@ -0,0 +1,100 @@
|
||||
/* ─────────────────────────────────────────────────────────────────────────
|
||||
* 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);
|
||||
}
|
||||
Reference in new issue
Block a user