Fix Figma Design System Finding (dar yazma)

Overview

Tek bulgu, tek sorunlu node veya minimal küme, minimal okuma/yazma. audit-figma-design-system çıktısı veya eşdeğer net görev tanımı olmadan kapsamı sessizce genişletme.

Ekran geneli veya çoklu bölüm için apply-figma-design-system kullan.

F-MCP araç eşlemesi

figma_execute içinde büyük JSON döndürme; figjam-diagram-builder skill’indeki kısa dönüş disiplinine benzer şekilde özet sonuç tercih et.

F-MCP skill koordinasyonu

Beklenen girdi

Bu skill üç farklı girdi formatını otomatik algılar:

1. Tek finding JSON — audit-figma-design-system çıktısından tek finding objesi. code_location alanı varsa bu format algılanır.
2. Tam audit JSON + indeks — Tüm audit çıktısı + hangi bulgunun düzeltileceği (indeks veya ruleId). findings dizisi varsa bu format algılanır.
3. Serbest metin + URL — Sorun özeti + Figma URL / fileKey + nodeId. Yapılandırılmış JSON yoksa bu format algılanır.

Format algılama sırası: code_location → findings[] → serbest metin fallback.

Audit JSON kullanılıyorsa code_location.absolute_file_path içinden fileKey ve nodeId çıkar: /figma/<fileKey>/nodes/<nodeId>.

Kapsam kuralı

Seçilen bulgu çözülene, blocked veya needs-follow-up raporlanana kadar başka cleanup yapma. Birden fazla bulgu kullanıcıda varsa birini seç veya en yüksek öncelikli tekini uygula; geri kalanı için audit/apply yönlendir.

Required Workflow

1. Plugin bağlantısını doğrula: figma_get_status() — bağlantı yoksa devam etme.
2. Normalize: fileKey, nodeId, bulgu başlığı ve gerekçe.
3. Uyumluluk (belirsiz replacement’ta): Yazmadan önce hangi component/variant, override’lar, layout sözleşmesi — sonuç safe-to-apply | blocked | needs-human-choice. blocked / needs-human-choice ise yazma; durumu bildir.
4. Minimal kanıt: figma_capture_screenshot; yapı için figma_get_design_context veya figma_get_file_data (dar kapsam); token bulgusuysa figma_get_variables / figma_get_styles; gerekirse figma_search_components.
5. Remediasyon modu (tek seç): swap-instance | compose-from-primitives | bind-tokens | align-variant | blocked. En küçük yeterli değişiklik.
6. Yedek: Yıkıcı düzenlemeden önce yalnızca etkilenen alt ağacı veya minimal üst section’ı çoğalt; net isimlendir (Backup - Fix finding …). Mümkünse ayrı figma_execute çağrısı; dönen node id’yi not et.

7. Uygula: figma_execute ile adım adım. Remediasyon modu örnekleri:

   swap-instance (mevcut node'u kütüphane bileşeniyle değiştir):

   const node = await figma.getNodeByIdAsync("<NODE_ID>");
   const comp = await figma.importComponentByKeyAsync("<COMPONENT_KEY>");
   // veya local: figma.root.findOne(n => n.type === "COMPONENT" && n.name === "<NAME>");
   const instance = comp.createInstance();
   instance.x = node.x; instance.y = node.y;
   instance.resize(node.width, node.height);
   if (node.parent) node.parent.insertChild(node.parent.children.indexOf(node), instance);
   node.remove();
   return { swapped: instance.id, replacedName: node.name };

   bind-tokens (hard-coded değeri variable'a bağla):

   const node = await figma.getNodeByIdAsync("<NODE_ID>");
   const variable = await figma.variables.getVariableByIdAsync("<VAR_ID>");
   const fills = [...node.fills];
   const boundPaint = figma.variables.setBoundVariableForPaint(fills[0], "color", variable);
   node.fills = [boundPaint];
   return { bound: node.name, variable: variable.name };

   align-variant (yanlış variant'ı doğrusuyla değiştir):

   const instance = await figma.getNodeByIdAsync("<INSTANCE_ID>");
   instance.setProperties({ "Variant": "Primary" });
   return { aligned: instance.id, newVariant: "Primary" };

8. Doğrula: Bulgunun özellikle çözüldüğünü screenshot ve yapı ile kanıtla; global pattern dokunduysa genişlet.
9. İsteğe bağlı: Regresyon için audit-figma-design-system ile aynı kapsamı yeniden çalıştır (özellikle çok adımlı fix sonrası).

Yazma kuralları

• Belirsiz replacement’ta safe-to-apply yoksa yazma.
• Tek bulgu düzeltildi diye tüm ekranı “sistemde” ilan etme.
• Component key ve variable id’leri isimden önce tercih et.
• Import timeout / erişilemeyen kütüphane → blocked, zorla devam etme.

Kapanış raporu

• Finding fixed: Ne değişti, hangi node.
• Validation: Orijinal şikayetin giderildiği kanıtı.
• Blocked / Follow-up: Varsa kısa.

Evolution Triggers

• Bridge'e yeni figma_execute kalıpları eklendiğinde remediasyon modları güncellenmeli
• Audit bulgu formatı değişirse girdi normalize adımı uyarlanmalı
• Batch düzeltme desteği eklenirse tek/toplu mod ayrımı yapılmalı