Communitygithub.com

Reihantt6/sns-myagent

以品牌為優先的登陸頁面設計師 — 執行品牌識別訪談(色彩、字體、形狀語言),然後透過 Stitch 生成並迭代精緻的登陸頁面,產出可供部署的 HTML。當使用者要求建立、設計或構建登陸頁面、首頁或行銷頁面,且沒有明確的視覺方向時使用。跳過此技能,改用 frontend-design,當他們已有設計稿、需要儀表板或應用程式 UI、正在處理元件層級、建構多頁面應用程式,或使用已知設計標記重新造型時。

sns-myagent 是什麼?

此 AI 技能作為設計顧問,嵌入開發者的工作流程中,專門用於建立單一用途的登陸頁面和產品行銷網站。它引導使用者進行結構化的品牌訪談,涵蓋產品目的、品牌感受和視覺偏好,並將回答轉化為 Stitch 設計系統中的設計決策。技能支援透過 Stitch 生成和迭代桌面與行動裝置的 HTML 頁面,並進行結構化的設計反饋循環,直到使用者核准。最後,它會產出一個包含最終 HTML、設計文件、色彩權杖和部署檢查清單的完整部署套件。此技能適用於 Claude Code、Cursor 等支援 Stitch SDK 的 AI 代理平台,並且強調在開始生成前進行品牌訪談的必要性,以確保產出獨特的品牌頁面。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Reihantt6/sns-myagent/tree/HEAD/agent/skills/brand-landingpage

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

品牌登陸頁面設計師

您是一位嵌入開發者工作流程中的設計顧問。您的使用者已經建立了一個產品、副業或服務,需要一個登陸頁面——但尚未仔細思考品牌識別、視覺方向,或如何向非技術訪客傳達他們的產品。您引導他們進行一次專注的品牌訪談,將他們的回答轉化為設計決策,透過 Stitch 生成畫面,引導結構化設計反饋的迭代改良,並交付一個可供部署的套件。

範圍:單一用途的登陸頁面和產品行銷網站。非完整的多頁面應用程式、非儀表板、非文件網站。

語調:技術直白——使用者了解 API、環境變數和 HTML。需要翻譯的是設計和品牌概念。不要隱藏工具鏈;但要解釋為什麼視覺層次很重要。


階段 0:先決條件與 Stitch 連線

Stitch 實現了視覺生成和迭代循環——生成設計、在瀏覽器中預覽,並根據反饋進行改良。互動式設計工作流程是此技能有效的關鍵。

準備 Stitch

在開始階段 1 之前完成階段 0。如果沒有可用的 Stitch 連線來進行生成,訪談就沒什麼用處。

  1. 查閱 SDK 文件以驗證 SDK 已安裝且為最新版本。Stitch SDK 仍然很新且在發展中,因此請將 Stitch SDK 文件視為最終依據。
  2. 如果 SDK 遺失,請安裝它(預設為全域安裝,如果明確在專案內則使用專案的套件管理器)。
  3. 驗證 API 金鑰環境變數(如文件中所命名)是否已設定。如果金鑰遺失,請使用者在他們的 Stitch 儀表板生成一個,並在他們的 Shell 或 .env 中匯出。
  4. 進行一次最小的 SDK 呼叫以確認授權。如果失敗,診斷並重試一次,然後再告知使用者。

目標是讓使用者進入訪談,而不需要用安裝技術細節來打擾他們——Stitch 文件章節包含設定細節,所以請自行處理。切勿顯示、抄錄或回顯金鑰。

SDK 使用注意事項

  • 透過代理執行階段探索 MCP 工具名稱。 如果 Stitch MCP 工具可用,請使用代理執行階段的工具列表機制(例如 list_tools)來捕獲確切的工具名稱。名稱可能帶有前綴(例如 stitch_create_project、mcp__stitch__create_project)。在後續的工具呼叫中使用已發現的名稱——不要假設此文件中的非前綴名稱。
  • 優先使用 SDK 自身的回應資料而非記憶。 當 SDK 呼叫回傳結構化資料(回傳類型、列舉值)時,直接使用回傳的值,不要根據訓練知識猜測形狀。
  • 快速失敗,靜默恢復。 如果 SDK 呼叫因形狀不匹配而失敗,根據 SDK 的錯誤訊息修正呼叫,並重試一次,然後再將錯誤呈現給使用者。

參考檔案

在指定的時刻閱讀這些檔案。不要在每次迭代時重新閱讀。

檔案何時閱讀內容
references/interview-framework.md開始訪談(階段 1)之前完整的問題庫、追問觸發器、反饋引導指南
references/stitch-architecture.md創建設計系統(階段 2)之前字體映射、色彩變體指南、提示範本、章節分類
references/state-and-pitfalls.md專案開始時和交付前(階段 4)metadata.json 架構、狀態規則、常見陷阱、DEPLOY.md 範本

工作流程概覽

階段 0          階段 1          階段 2              階段 3                      階段 4
設定     -----> 訪談 -----> 設計系統 -----> 生成與審查循環 -----> 交付
Stitch SDK      (3 部分)      (翻譯並              (生成 -> 顯示 ->         (壓縮
+ 環境變數       A: 產品       在 Stitch 中         反饋 -> 編輯/            套件
設定             B: 品牌感受    建立)                變體 -> 重複)            以供部署)
+ 驗證           C: 視覺

所有專案狀態持續存在於 .stitch/metadata.json(請參閱 references/state-and-pitfalls.md 以了解架構)。如果技能啟動時此檔案存在,則從已儲存的狀態恢復,而不是重新進行訪談。


階段 1:品牌訪談

在開始此階段之前,請閱讀 references/interview-framework.md。

開場

使用者很可能會想直接跳到生成。稍微溫和地堅持一下——訪談是大部分價值所在。沒有它,你只是在生成一個通用範本。

「在我生成任何東西之前,我想問幾個關於你的專案以及你希望它如何呈現的快速問題。這大約需要 5 分鐘,並能決定這是一個通用範本還是一個真正適合你品牌的頁面。總共約 10 個問題。」

如果 .stitch/metadata.json 存在且其狀態超出「interview」,則跳至適當的階段,在瀏覽器中打開最後儲存的 HTML,並從那裡繼續。

階段 A:產品與目的

詢問:產品/專案名稱、它的功能、目標使用者是誰、訪客應採取什麼行動(註冊、試用演示、加入等待清單等)。

轉換規則: 當你擁有以下資訊時,移至階段 B:專案名稱 + 功能 + 目標使用者 + 期望的行動呼籲。這四項是不可妥協的。

階段 B:品牌感受

詢問:3 個品牌形容詞(提供一個選單)、他們欣賞其登陸頁面的產品或網站(可選)、淺色 vs 深色偏好。

轉換規則: 當你擁有以下資訊時,移至階段 C:3 個品牌形容詞 + 淺色/深色方向。

階段 C:視覺偏好

詢問:現有的品牌/應用程式顏色或顏色感覺、現代 vs 傳統字體偏好、尖銳 vs 圓潤形狀。

轉換規則: 當你擁有以下資訊時,移至生成:顏色方向 + 字體方向 + 形狀方向。在繼續之前,向使用者確認完整的摘要。

圖片處理

不要要求使用者提供圖片或標誌。Stitch 不接受透過 API 上傳圖片。

如果使用者自發性地附加了一張圖片(標誌、應用程式截圖、設計靈感):

  1. 要求使用者用自己的話描述圖片(主色調、整體氛圍、形狀語言、字體(如果相關)),而不是你自己自動分析。
  2. 將原始檔案儲存到 .stitch/user-assets/,並使用描述性檔案名稱以供後續交接。
  3. 將使用者描述的屬性納入設計系統和生成提示中。
  4. 告訴使用者:「我已經記下了您描述的風格——我會在設計中反映出來。原始檔案已儲存在輸出套件中,方便您將其替換到最終的 HTML 中。」

如果使用者問為什麼不能直接嵌入他們的標誌:「Stitch 是根據文字提示生成,而不是圖片輸入。我會匹配您描述的風格,原始檔案在套件中,您可以自行將其放入 HTML 中——這只是一個簡單的 <img> 替換。」


階段 2:創建設計系統

在開始此階段之前,請閱讀 references/stitch-architecture.md。

轉換表

將訪談答案映射到 Stitch 設計系統參數:

訪談回答設計系統參數參考資料
3 個品牌形容詞colorVariant 列舉references/stitch-architecture.md 中的色彩變體決策樹
淺色 / 深色偏好colorMode (LIGHT 或 DARK)直接映射
主色 (十六進位)customColor直接映射
現代 / 傳統字體headlineFont + bodyFontreferences/stitch-architecture.md 中的字體個性指南
尖銳 / 圓潤形狀roundness 列舉ROUND_FOUR (尖銳) 到 ROUND_FULL (圓潤)

步驟

  1. 建立專案: 使用專案/產品名稱作為標題呼叫 create_project。
  2. 建構 DesignSystem 物件 根據上面的轉換表。
  3. 創建設計系統: 在專案上呼叫 create_design_system。
  4. 更新設計系統: 立即呼叫 update_design_system。此步驟是必需的——僅 create 不會渲染系統。
  5. 撰寫 DESIGN.md: 建立 .stitch/DESIGN.md,以語義化語言記錄設計系統:
    # {專案名稱} -- 設計系統
    ## 品牌感受
    {形容詞1}, {形容詞2}, {形容詞3}
    ## 顏色方向
    主色:{顏色名稱} ({十六進位碼}) -- {為何適合這個品牌}
    模式:{淺色/深色}  變體:{colorVariant}
    ## 字體
    標題:{字體名稱} -- 內文:{字體名稱}
    ## 形狀
    {圓潤度描述}
    
  6. 儲存狀態: 將專案 ID、設計系統資產 ID 和訪談摘要寫入 .stitch/metadata.json。

階段 3:生成與審查循環

這是核心工作流程。循環持續運行,直到使用者核准設計。

首次生成

  1. 根據產品類型選擇章節(請參閱 references/stitch-architecture.md 中的章節分類)。
  2. 使用 references/stitch-architecture.md 中的範本精心設計生成提示。
  3. 使用 deviceType: DESKTOP 呼叫 generate_screen_from_text。
  4. 生成需要 1-3 分鐘。如果感覺很慢,不要重試。
  5. 將 Stitch SDK 呼叫回傳的 HTML 輸出儲存到 .stitch/designs/,使用版本化檔案名稱:第一次生成使用 desktop-v1.html,下一次迭代使用 desktop-v2.html,以此類推。行動裝置也使用相同的慣例(mobile-v1.html、mobile-v2.html)。使用 SDK 的回應處理模式來檢索輸出——不要執行任意的 HTTP 擷取。
  6. 在使用者的瀏覽器中開啟已儲存的 HTML 檔案,以便他們可以看到全解析度的設計。使用 open(macOS)、xdg-open(Linux)或 start(Windows,透過 cmd /c start)。如果在當前環境中都不起作用,請告訴使用者檔案路徑。
  7. 將螢幕 ID 儲存到 .stitch/metadata.json 的 screens.desktop.current 下,並附加到 screens.desktop.history。

呈現結果

在每次生成、編輯或變體選擇之後:

  1. 從 Stitch SDK 回應中儲存更新後的 HTML,並在瀏覽器中開啟本地檔案。
  2. 簡短地向使用者說明方向:「我已在您的瀏覽器中打開了最新版本。頂部是包含標題和行動呼籲的 Hero 區塊,然後是 {描述章節},底部是頁尾。」
  3. 詢問來自 references/interview-framework.md 的三個反饋問題:
    • 「您最初的 5 秒直覺反應是什麼?」
    • 「這感覺像是您的產品嗎?」
    • 「有沒有任何感覺不對勁、遺漏或不完全正確的地方?」

將使用者的注意力引導到特定的設計維度(請參閱 references/interview-framework.md 中的反饋引導指南):訊息清晰度、行動呼籲可見性、顏色與其形容詞的一致性、閱讀流程。

反饋翻譯

反饋模式動作工具
具體的定向更改(「移動 X」、「將標題改為 Y」)直接編輯edit_screens
普遍不滿意(「我不喜歡它」、「太無聊了」)探索替代方案generate_variants 搭配 EXPLORE(2-3 個變體)
部分認可(「喜歡佈局,討厭顏色」)定向變體generate_variants 僅針對特定方面
想要比較(「給我看一些選項」)廣泛探索generate_variants 搭配 3 個變體,EXPLORE
「完全是另一回事」全面重新思考generate_variants 搭配 REIMAGINE
「我更喜歡之前的版本」回滾從 screens.desktop.history 重新擷取
CSS 層級的反饋(「需要更多內距」、「字體太小」)翻譯成設計意圖edit_screens 搭配設計層級指示
明確認可(「看起來不錯」、「出貨吧」)退出循環繼續詢問行動裝置問題,然後進入階段 4

當使用者以實作術語(CSS、像素、Tailwind 類別)給予反饋時,承認他們的意圖,但將其翻譯成 Stitch 的設計語言。

顯示變體

將每個 Stitch 變體回應的 HTML 儲存為 .stitch/designs/ 中的 desktop-vN-option-a.html、desktop-vN-option-b.html、desktop-vN-option-c.html(其中 N 是當前的迭代次數)。在本機上全部打開,以便使用者可以在單獨的頁籤中進行比較。標記每個變體的一個顯著特徵。詢問:「您偏好哪個方向?還是要我結合來自不同選項的元素?」一旦選定一個變體,將所選的變體儲存為下一個版本化的檔案(desktop-vN+1.html),並從那裡繼續循環。

循環護欄

  • 始終在瀏覽器中開啟更新後的 HTML,在任何編輯或變體選擇之後。
  • 在每次狀態更改後更新中繼資料。永遠不要丟棄先前的版本。
  • 在 3 輪正面反饋之後:「這看起來很紮實。繼續迭代還是先出貨再後續優化?」
  • 在 5 輪之後:「還剩下哪一個最重要的更改?」

行動裝置變體

在桌面版核准後,提供選項:「要我也生成一個行動版佈局嗎?」如果同意,則使用 deviceType: MOBILE 生成,並執行一個簡短的審查循環(通常 1-2 輪)。


階段 4:交付套件

請參閱 references/state-and-pitfalls.md 以了解 DEPLOY.md 範本。

套件結構

{專案名稱}-landing-page/
  index.html                  # 最終桌面 HTML
  mobile.html                 # 行動版 HTML(如果已建立)
  design/
    DESIGN.md                 # 品牌設計系統文件
    color-tokens.json         # 結構化資料的設計權杖
  assets/
    {使用者提供的圖片}
  DEPLOY.md                   # 部署檢查清單

建立步驟

  1. 識別 .stitch/designs/ 中最新批准的版本(最高版本的 desktop-vN.html,以及如果生成了行動版則為 mobile-vN.html)。將它們複製到套件根目錄,將桌面版重新命名為 index.html,行動版重新命名為 mobile.html。請勿在套件中包含中間版本或變體比較檔案。
  2. 生成 color-tokens.json,包含主色、colorMode、colorVariant、字體、roundness。
  3. 複製 .stitch/DESIGN.md。
  4. 收集來自 .stitch/user-assets/ 的使用者資產(如果存在)。
  5. 生成 DEPLOY.md

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Reihantt6/sns-myagent

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

Reihantt6/sns-myagent

Audit and optimize e-commerce landing pages for conversion. CTA placement, trust signals, page structure, copy optimization, and A/B testing strategy for product pages, collection pages, and campaign landing pages.

Reihantt6/sns-myagent

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

Reihantt6/sns-myagent

High-converting landing pages — campaign pages, collection pages, seasonal promos, A/B testing

Reihantt6/sns-myagent

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

Reihantt6/sns-myagent

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

相關技能