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。
8.4 KiB
8.4 KiB
GitHub'dan İlham Alan Tasarım Sistemi
Category: Geliştirici Araçları Kod odaklı platform. Fonksiyonel yoğunluk, beyaz üzerine mavi hassasiyet, Primer temelleri.
1. Görsel Tema ve Atmosfer
GitHub'ın yüzeyi dekore edilmiş değil, mühendislik ürünüdür. Her piksel bir duruş ilan eder: bu, diff'ler, build'ler ve pull request'lerle ilgilenen insanlar için yapılmış bir araçtır. Sayfa arka planı sade bir #ffffff (açık) veya #0d1117 (koyu) şeklindedir; içerik, negatif alan yerine ince çizgi kenarlıklarla ayrılmış yoğun dikdörtgen paneller üzerinde düzenlenir. Bilgi yoğunluğu markanın ta kendisidir — liste satırları, kod satırları, depo başlıkları ve bildirim kartlarının tamamı kaydırmadan yüzlerce öğeyi tarayabilmek için birbirine yakın sıkıştırılmıştır.
Karakteristik vurgular, bağlantılar ve birincil eylemler için Primer mavisi (#0969da) ile birleştirilmiş durumlar, başarı ve merge butonu için GitHub yeşili (#1a7f37)'dir. Her ikisi de tüketici ürünü mavileri ve yeşillerine kıyasla biraz daha mat görünür — yoğun gri metne karşı okunabilecek kadar doygun, ancak tek bir görünüm penceresinde birkaç tanesi göründüğünde arka plana karışacak kadar ölçülüdür.
Tipografi, metnin her işletim sisteminde net bir şekilde görüntülenmesi için ürünün tamamında system-ui yığınını kullanır; kod için ise SFMono / Menlo / Consolas ile eşleştirilir. Editoryal bir görüntüleme yazı tipi yoktur; GitHub'ın sesi, halihazırda kullandığınız sistemin sesidir.
Temel Özellikler:
- Gerçek beyaz zemin (
#ffffff) veya derin lacivert-siyah (#0d1117) — ısı yok, ton yok - İnce çizgi gri kenarlıklar (
#d0d7de) her bölme ve paneli tanımlar - Bağlantılar/birincil için Primer mavisi (
#0969da); başarı/merge için GitHub yeşili (#1a7f37) - Düz yazı için system-ui; kod için SFMono — özel yazı tipi yok
- Minimal dolgu ile yoğun liste satırları; boşluk nadirdir
- 16px / 24px Octicon ikonografisi — tek çizgi, geometrik, tutarlı
- Güçlü renk semantiğiyle hap şekilli durum rozetleri
2. Renk Paleti ve Rolleri
Birincil
- Canvas Default (
#ffffff): Birincil sayfa arka planı, açık tema. - Canvas Subtle (
#f6f8fa): İkincil yüzey, kenar çubuğu, girdi arka planı, başlık şeridi. - Canvas Inset (
#eaeef2): Kod bloğu arka planı, derin iç içe yüzey. - Fg Default (
#1f2328): Birincil metin, başlıklar, mürekkep. - Fg Muted (
#656d76): İkincil metin, açıklamalar, dosya yolları.
Marka Vurgusu
- Primer Blue (
#0969da): Bağlantılar, birincil çağrı-eylem butonları, odak halkası tabanı — evrensel etkileşimli renk. - Primer Blue Hover (
#0550ae): Birincil mavi için üzerine gelme/basılı durumu. - Accent Subtle (
#ddf4ff): Açıklamalar ve bilgi bannerleri için yumuşak mavi yüzey.
Semantik
- Success / Merge Green (
#1a7f37): Birleştirilmiş PR'lar, başarı rozetleri, merge butonu. - Success Subtle (
#dafbe1): Başarı yüzey tonu. - Open Green (
#1a7f37): "Açık" issue/PR durumu. - Closed / Danger Red (
#cf222e): Kapatılmış PR'lar, yıkıcı eylem, doğrulama hatası. - Danger Subtle (
#ffebe9): Hata banner yüzeyi. - Attention / Warning Yellow (
#9a6700): Kehribar yüzeyde uyarı metni. - Attention Subtle (
#fff8c5): Uyarı banner yüzeyi. - Done Purple (
#8250df): Birleştirilmiş-ve-arşivlenmiş, "tamamlandı" durumu, premium rozet. - Sponsor Pink (
#bf3989): Sponsors kalbi, GitHub sponsors markası.
Kenarlık ve Ayırıcı
- Border Default (
#d0d7de): Standart ince çizgi kenarlık, panel dış çizgisi. - Border Muted (
#d8dee4): Panel içindeki iç bölücüler. - Border Subtle (
#eaeef2): Soluk tablo satır bölücüleri.
Koyu Tema
- Dark Canvas (
#0d1117): Koyu sayfa arka planı. - Dark Surface (
#161b22): Kenar çubuğu, başlık, ikincil yüzey. - Dark Border (
#30363d): Standart koyu mod kenarlığı. - Dark Fg (
#e6edf3): Koyu zemin üzerinde birincil metin.
3. Tipografi Kuralları
Yazı Tipi Ailesi
- Gövde / Arayüz:
-apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif - Kod / Monospace:
ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace - Emoji:
"Apple Color Emoji", "Segoe UI Emoji"
Hiyerarşi
| Rol | Yazı Tipi | Boyut | Kalınlık | Satır Yüksekliği | Harf Aralığı | Notlar |
|---|---|---|---|---|---|---|
| Display | system-ui | 32px (2rem) | 600 | 1.25 | -0.01em | Depo başlığı, pazarlama hero |
| H1 | system-ui | 24px (1.5rem) | 600 | 1.25 | normal | Sayfa başlığı |
| H2 | system-ui | 20px (1.25rem) | 600 | 1.25 | normal | Bölüm başlığı |
| H3 | system-ui | 16px (1rem) | 600 | 1.25 | normal | Alt bölüm, panel başlığı |
| Body | system-ui | 14px (0.875rem) | 400 | 1.5 | normal | Varsayılan metin boyutu — 16px değil |
| Body Small | system-ui | 12px (0.75rem) | 400 | 1.4 | normal | Açıklamalar, dosya meta verileri |
| Code | SFMono | 12px (0.75rem) | 400 | 1.45 | normal | Kod blokları, diff |
| Code Inline | SFMono | 0.85em | 400 | inherit | normal | Satır içi code alanları |
İlkeler
- 14px gövde, 16px değil: GitHub'ın düz yazı yoğunluğu onun kimliğidir. Ürün, bir görünüm penceresine daha fazla satır sığdırmak için 14px'te okunur.
- İkili kalınlık: Varsayılan olarak her şey için 400; başlıklar ve vurgu için 600. 500 yok, 700 yok.
- Her zaman sistem yazı tipleri: Chrome için asla bir web yazı tipi yüklemeyin — metin yavaş bağlantılarda da anında görüntülenmelidir.
4. Bileşen Stilleri
Butonlar
Birincil (Yeşil)
- Arka plan:
#1f883d - Metin:
#ffffff - Kenarlık: 1px solid
rgba(31, 35, 40, 0.15) - Dolgu: 5px 16px
- Yarıçap: 6px
- Gölge:
0 1px 0 rgba(31,35,40,0.1) - Üzerine gelme: arka plan
#1a7f37 - Kullanım: "Depo oluştur", "Pull request'i birleştir"
Varsayılan
- Arka plan:
#f6f8fa - Metin:
#1f2328 - Kenarlık: 1px solid
#d0d7de - Dolgu: 5px 16px
- Yarıçap: 6px
- Üzerine gelme: arka plan
#f3f4f6, kenarlık#d0d7de
Dış Çizgi (Mavi Bağlantı Stili)
- Arka plan:
#ffffff - Metin:
#0969da - Kenarlık: 1px solid
#d0d7de - Üzerine gelme: arka plan
#0969da, metin#ffffff
Tehlike
- Arka plan:
#ffffff - Metin:
#cf222e - Kenarlık: 1px solid
#d0d7de - Üzerine gelme: arka plan
#a40e26, metin#ffffff, kenarlık#a40e26
Kartlar / Kutular
- Arka plan:
#ffffff - Kenarlık: 1px solid
#d0d7de - Yarıçap: 6px
- Dolgu: 16px (başlık) + 16px (gövde)
- Başlıkta alt kenarlıklı
#f6f8faşerit bulunur.
Girdiler
- Arka plan:
#ffffff - Kenarlık: 1px solid
#d0d7de - Yarıçap: 6px
- Dolgu: 5px 12px
- Odak: kenarlık
#0969da, halka0 0 0 3px rgba(9,105,218,0.3)
Durum Hapları (Issue / PR)
- Açık: arka plan
#1a7f37, beyaz metin, dolgu 4px 10px, yarıçap 9999px. - Kapalı: arka plan
#cf222e, beyaz metin. - Birleştirildi: arka plan
#8250df, beyaz metin. - Taslak: arka plan
#6e7781, beyaz metin.
Etiketler (Issue/PR Üzerindeki Etiketler)
- Dolgu: 0 7px
- Yarıçap: 9999px
- Yazı tipi: 12px / 500
- Arka plan ve metin programatiktir (etiket rengi → kontrast için metin hesaplanır).
5. Boşluk ve Düzen
- Temel birim: 4px. Boşluk ölçeği: 4, 8, 12, 16, 24, 32, 40, 48.
- Sayfa maksimum genişliği: 1280px (
Container-xl). - Kenar çubuğu: Masaüstünde 296px, 1012px'in altında daralır.
- Satır dolgusu: 16px yatay, 12px dikey (listeler tasarım gereği yoğundur).
6. Hareket
- Süre: Üzerine gelme için 80ms; menü/popover açma için 200ms.
- Yumuşatma: Açılanlar için
ease-out, kapananlar içinease-in. - Kaçınılanlar: Sayfa yükleme animasyonu, parallax, kalıcı mikro etkileşimler. Şeyler görünür; performans sergilemez.
7. Kullanım Kılavuzları
- Yoğun listeleri, kenarlıklı kutuları ve sistem tipografisini bir arada tutun; izole yeşil butonlar GitHub benzeri bir ürün yüzeyi oluşturmak için yeterli değildir.
- Yapıcı depo eylemleri için yeşil, bağlantılar ve odak için mavi, yalnızca issue, PR ve iş akışı durumları için kırmızı/mor/gri kullanın.
- Dekoratif gölgeler veya büyük pazarlama tarzı kartlar yerine sade krom, açık kenarlıklar ve kompakt aralama tercih edin.