ai-handoff-export

AI Handoff Export

Overview

Bu skill, dağınık Figma çıktılarını tek bir teslimat formatında toplar:

• HANDOFF_TEMPLATE.md (insan okunur)
• handoff.manifest.json (makine okunur, schema tabanlı)

Önemli: Tüm veriler plugin bridge üzerinden alınır. Şablon: repo kökünde HANDOFF_TEMPLATE.md; şema: docs/handoff.manifest.schema.json.

F-MCP skill koordinasyonu

• Önce: Tuval DS uyumu için isteğe bağlı audit-figma-design-system / apply-figma-design-system; token isimleri için design-token-pipeline ile uyumlu manifest.
• Sonra: implement-design ana tüketici; code-design-mapper özetini manifest’e işleyebilirsin.
• PO/PM akışı: Teknik olmayan ekran özeti için figma-screen-analyzer; değişiklik etkisi için ds-impact-analysis

Required Workflow

Step 1: Plugin Bağlantısını Doğrula

figma_get_status()

Step 2: Hedef node'ları netleştir

• Kullanıcı URL verdiyse node-id değerini ayıkla.
• Node belirsizse figma_get_file_data(depth=1) ile kapsam çıkar.

Step 3: Design context topla

figma_get_design_context çağrısı:

• includeLayout=true
• includeVisual=true
• includeTypography=true
• includeCodeReady=true
• depth=2

Step 4: Token ve component reuse özeti çıkar

• figma_get_variables
• figma_search_components
• gerekiyorsa figma_get_component_for_development

Step 4.5: Prototip Akış Diyagramı (v1.9.9+)

Ekran prototip bağlantıları içeriyorsa handoff'a "Prototip Akışı" bölümü ekle:

const proto = await figma_get_prototype_connections({ pageScope: true });

Manifest'e prototypeFlow anahtarı olarak yaz:

{
  "prototypeFlow": {
    "startingPoints": [{ "nodeId": "...", "name": "Login Akışı" }],
    "connections": [
      { "source": "Login/LoginBtn", "destination": "Home", "trigger": "ON_CLICK", "action": "NAVIGATE", "transition": { "type": "SLIDE_IN", "direction": "RIGHT", "duration": 0.3 } }
    ],
    "totalReactions": 12
  }
}

HANDOFF_TEMPLATE'e "## Prototip Akışı" bölümü ekle (Mermaid graph TD):

graph TD
  Login -->|Giriş Yap - SLIDE_IN/RIGHT 300ms| Home
  Login -->|Kayıt Ol - SLIDE_IN/RIGHT 300ms| Register
  Login -->|Şifremi Unuttum - SLIDE_IN/RIGHT 300ms| ForgotPassword