一、④段整套同步(用户选候选 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。
8.0 KiB
Ontwerpsysteem geïnspireerd door GitHub
Category: Ontwikkelaarstools Codegedreven platform. Functionele dichtheid, blauw-op-wit precisie, Primer-fundamenten.
1. Visueel thema en sfeer
GitHub's oppervlak is geconstrueerd, niet gedecoreerd. Elk pixel verkondigt een standpunt: dit is een tool voor mensen die geven om diffs, builds en pull requests. De pagina-achtergrond is een strak #ffffff (licht) of #0d1117 (donker), met inhoud gerangschikt op dichte rechthoekige panelen gescheiden door haarlijndunne randen in plaats van negatieve ruimte. Informatiedichtheid is het merk — lijstrijen, coderegels, repositoryheaders en notificatiekaarten staan dicht op elkaar, zodat een gevorderde gebruiker honderd items kan scannen zonder te scrollen.
De kenmerkende accenten zijn Primer-blauw (#0969da) voor links en primaire acties, en GitHub-groen (#1a7f37) voor samengevoegde statussen, succes en de samenvoegknop zelf. Beide ogen licht gedempt vergeleken met consumentenproduct-blauw en -groen — verzadigd genoeg om leesbaar te zijn op de dichte grijze tekst, terughoudend genoeg om op te gaan in de achtergrond wanneer er meerdere in één viewport verschijnen.
Typografie gebruikt de system-ui-stack door het hele product, zodat tekst scherp wordt weergegeven op elk besturingssysteem, aangevuld met SFMono / Menlo / Consolas voor code. Er is geen redactioneel weergavelettertype; de stem van GitHub is de stem van het systeem dat je al gebruikt.
Kernkenmerken:
- Echt wit canvas (
#ffffff) of diep marinezwart (#0d1117) — geen warmte, geen tint - Haarlijndunne grijze randen (
#d0d7de) definiëren elk paneel en vlak - Primer-blauw (
#0969da) voor links/primair; GitHub-groen (#1a7f37) voor succes/samenvoegen - system-ui voor proza; SFMono voor code — geen aangepast lettertype
- Dichte lijstrijen met minimale opvulling; witruimte is zeldzaam
- Octicon-pictogrammen op 16px / 24px — enkellijnig, geometrisch, consistent
- Peervormige statusbadges met sterke kleursemantieken
2. Kleurenpalet en rollen
Primair
- Canvas Standaard (
#ffffff): Primaire pagina-achtergrond, licht thema. - Canvas Subtiel (
#f6f8fa): Secundaire oppervlak, zijbalk, invoerveld-achtergrond, koptekstbalk. - Canvas Inset (
#eaeef2): Codeblok-achtergrond, diep ingebed oppervlak. - Fg Standaard (
#1f2328): Primaire tekst, koppen, inkt. - Fg Gedempt (
#656d76): Secundaire tekst, bijschriften, bestandspaden.
Merkaccent
- Primer-blauw (
#0969da): Links, primaire CTA's, focusring-basis — de universele interactieve kleur. - Primer-blauw hover (
#0550ae): Hover/ingedrukt voor primair blauw. - Accent Subtiel (
#ddf4ff): Zacht blauw oppervlak voor uitroepen, informatiebanners.
Semantisch
- Succes / Samenvoeging Groen (
#1a7f37): Samengevoegde PR's, succesbadges, samenvoegknop. - Succes Subtiel (
#dafbe1): Succes oppervlaktint. - Open Groen (
#1a7f37): "Open" issue/PR-status. - Gesloten / Gevaar Rood (
#cf222e): Gesloten PR's, destructieve actie, validatiefout. - Gevaar Subtiel (
#ffebe9): Foutbanner-oppervlak. - Aandacht / Waarschuwing Geel (
#9a6700): Waarschuwingstekst op amberkleurig oppervlak. - Aandacht Subtiel (
#fff8c5): Waarschuwingsbanner-oppervlak. - Gereed Paars (
#8250df): Samengevoegd-en-gearchiveerd, "gereed"-status, premium-badge. - Sponsor Roze (
#bf3989): Sponsors-hart, GitHub-sponsorsmerk.
Rand en scheiding
- Rand Standaard (
#d0d7de): Standaard haarlijndunne rand, paneelomtrek. - Rand Gedempt (
#d8dee4): Binnenste scheidingslijnen binnen een paneel. - Rand Subtiel (
#eaeef2): Vage tabelrijscheidingslijnen.
Donker thema
- Donker Canvas (
#0d1117): Donkere pagina-achtergrond. - Donker Oppervlak (
#161b22): Zijbalk, koptekst, secundair oppervlak. - Donkere Rand (
#30363d): Standaard donkermodus-rand. - Donker Fg (
#e6edf3): Primaire tekst op donker.
3. Typografieregels
Lettertypefamilie
- Hoofdtekst / UI:
-apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif - Code / Mono:
ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace - Emoji:
"Apple Color Emoji", "Segoe UI Emoji"
Hiërarchie
| Rol | Lettertype | Grootte | Gewicht | Regelafstand | Letterafstand | Opmerkingen |
|---|---|---|---|---|---|---|
| Display | system-ui | 32px (2rem) | 600 | 1.25 | -0.01em | Repositoryheader, marketinghero |
| H1 | system-ui | 24px (1.5rem) | 600 | 1.25 | normaal | Paginakopping |
| H2 | system-ui | 20px (1.25rem) | 600 | 1.25 | normaal | Sectiekopping |
| H3 | system-ui | 16px (1rem) | 600 | 1.25 | normaal | Subonderdeel, paneelkopje |
| Hoofdtekst | system-ui | 14px (0.875rem) | 400 | 1.5 | normaal | Standaard tekstgrootte — niet 16px |
| Kleine tekst | system-ui | 12px (0.75rem) | 400 | 1.4 | normaal | Bijschriften, bestandsmetadata |
| Code | SFMono | 12px (0.75rem) | 400 | 1.45 | normaal | Codeblokken, diff |
| Inline code | SFMono | 0.85em | 400 | overnemen | normaal | Inline code-spans |
Principes
- 14px tekst, niet 16px: GitHub's prozadichtheid is zijn identiteit. Het product wordt gelezen op 14px om meer rijen in een viewport te passen.
- Binair gewicht: 400 voor alles standaard; 600 voor koppen en nadruk. Geen 500, geen 700.
- Altijd systeemlettertypen: laad nooit een weblettertype voor de chrome — tekst moet direct renderen op trage verbindingen.
4. Componentstijlen
Knoppen
Primair (Groen)
- Achtergrond:
#1f883d - Tekst:
#ffffff - Rand: 1px solid
rgba(31, 35, 40, 0.15) - Opvulling: 5px 16px
- Radius: 6px
- Schaduw:
0 1px 0 rgba(31,35,40,0.1) - Hover: achtergrond
#1a7f37 - Gebruik: "Repository aanmaken", "Pull request samenvoegen"
Standaard
- Achtergrond:
#f6f8fa - Tekst:
#1f2328 - Rand: 1px solid
#d0d7de - Opvulling: 5px 16px
- Radius: 6px
- Hover: achtergrond
#f3f4f6, rand#d0d7de
Omtrek (blauwe linkstijl)
- Achtergrond:
#ffffff - Tekst:
#0969da - Rand: 1px solid
#d0d7de - Hover: achtergrond
#0969da, tekst#ffffff
Gevaar
- Achtergrond:
#ffffff - Tekst:
#cf222e - Rand: 1px solid
#d0d7de - Hover: achtergrond
#a40e26, tekst#ffffff, rand#a40e26
Kaarten / Vakken
- Achtergrond:
#ffffff - Rand: 1px solid
#d0d7de - Radius: 6px
- Opvulling: 16px (koptekst) + 16px (inhoud)
- Koptekst heeft een
#f6f8fa-balk met onderrand.
Invoervelden
- Achtergrond:
#ffffff - Rand: 1px solid
#d0d7de - Radius: 6px
- Opvulling: 5px 12px
- Focus: rand
#0969da, ring0 0 0 3px rgba(9,105,218,0.3)
Statuspillen (Issue / PR)
- Open: achtergrond
#1a7f37, tekst wit, opvulling 4px 10px, radius 9999px. - Gesloten: achtergrond
#cf222e, tekst wit. - Samengevoegd: achtergrond
#8250df, tekst wit. - Concept: achtergrond
#6e7781, tekst wit.
Labels (Tags op issues/PR's)
- Opvulling: 0 7px
- Radius: 9999px
- Lettertype: 12px / 500
- Achtergrond en tekst zijn programmatisch (labelkleur → tekst berekend voor contrast).
5. Afstand en indeling
- Basiseenheid: 4px. Afstandsschaal: 4, 8, 12, 16, 24, 32, 40, 48.
- Maximale paginabreedte: 1280px (
Container-xl). - Zijbalk: 296px op desktop, klapt samen onder 1012px.
- Rijopvulling: 16px horizontaal, 12px verticaal (lijsten zijn bewust compact).
6. Beweging
- Duur: 80ms voor hover; 200ms voor menu/popover openen.
- Versoepeling:
ease-outvoor openen,ease-invoor sluiten. - Vermeden: paginalaadinimaties, parallax, aanhoudende micro-interacties. Dingen verschijnen; ze voeren geen show op.
7. Gebruiksrichtlijnen
- Houd dichte lijsten, omrande vakken en systeemtypografie bij elkaar; geïsoleerde groene knoppen zijn niet genoeg om een GitHub-achtig productoppervlak te creëren.
- Gebruik groen voor constructieve repositoryacties, blauw voor links en focus, en rood/paars/grijs alleen voor issue-, PR- en workflowstatussen.
- Geef de voorkeur aan rustige opmaak, expliciete randen en compacte afstand boven decoratieve schaduwen of grote marketingkaarten.