Appllama 使用技能
Appllama 是一個收錄頂尖營收行動應用程式的資料庫 — 包含真實畫面、流程和 UI 模式，以及營收與下載量的背景資訊。MCP 使其成為代理的研究平台：不只是研究工具，更是建構者的工具。 你研究那些已經成功的產品，然後建構出更好的東西。
請將此技能與 appllama-design-skill 搭配使用於每個設計/實作步驟 — 這個技能告訴你該研究什麼；那個技能告訴你該如何建構。
基本規則（請先閱讀）
- 從
get_credits開始 — 這是免費的。 它會告訴你餘額、限制和重置日期。Pro 方案每月包含 1,500 個信用點數（每月 1 日 UTC 時間完整重置）；其他每個工具呼叫消耗 1 個信用點數。 - 進行深入研究。 設計語言存在於完整的旅程中，而不只是一個範例 — 走過與任務相關的每個應用程式的每個畫面，包括圖片。這就是資料庫的用途。唯一違反條款的行為是「收割」：掃描整個資料庫以提取資料集本身，而不是為了解決真實任務。這不是研究，並且會在伺服器端被偵測到。
- 媒體連結約在 1 小時後過期。 請及時下載/查看你研究的內容。如果連結在任務中途失效，請重新請求該頁面以取得新連結 — 畫面 ID 是持久的，但連結不是。
- 忽略浮水印。 每張 Appllama 圖片和影片在左上角都帶有一個小的 Appllama 浮水印。它是來源標記，而非畫面的一部分 — 不要讓它影響你對該角落（狀態列、返回按鈕、標題）的判斷，也永遠不要在你建構的任何內容中複製它。
- 分頁是順序性的。 每個列表回應都帶有
next_cursor；將其傳回以繼續。你不能直接跳到第 N 頁 — 而且游標僅適用於產生它的同一查詢。如果游標出錯，請捨棄它並從第一頁重新開始。 - 如果遇到速率限制，請耐心等待。 每分鐘和每日的限制遠高於實際研究所需；在罕見的觸發情況下，請等待指定的時間 — 不要重試轟炸。
- 錯誤就是指示。 工具錯誤訊息是用來讓你採取行動的（游標過期 → 重新開始；信用點數不足 → 告知用戶他們的信用點數將於每月 1 日重置，並且他們可以在「設定」→「使用量」中請求更多）。
工具地圖
| 工具 | 功能 | 典型用途 |
|---|---|---|
get_credits | 餘額、限制、重置日期。免費。 | 每次工作階段開始 |
search_apps | 每頁 10 個應用程式：名稱、營收、下載量、評分、發布日期、畫面數量、包含畫面數量的流程列表。支援自然語言 query 查詢 + 篩選條件（營收/下載量/評分/發布日期/價格/入門步驟）+ sort 排序 + board_id | 尋找特定類別或需求的頂尖應用程式 |
get_app | 單一應用程式的完整資訊：評分細項、類別排名、IAP 定價、主要國家、流程 | 決定是否值得深入研究某個應用程式 |
list_app_screens | 每頁 10 個畫面，依照旅程順序排列（歡迎畫面 → 入門引導 → 付費牆 → 產品），每個畫面包含媒體連結、流程、UI 元素、顏色。可依 flow 或 section 篩選 | 逐個畫面走訪應用程式 |
search_screens | 搜尋整個資料庫中的畫面。mode="keyword" 關鍵字模式比對畫面名稱 + 篩選條件（流程、畫面類型、元素、app_id）；mode="semantic" 語意模式依意義/視覺語言搜尋 | 為某種畫面類型收集設計參考 |
get_screen | 單一畫面的完整資訊 + 最多 5 個來自其他應用程式的視覺相似畫面。接受 screen_ref = app_id/screen_id（appllama.io 上「複製畫面 ID」產生的格式） | 用戶貼上畫面參考；或深入研究某個參考 |
list_flows | 流程分類法，包含畫面/應用程式數量 | 探索特定類別有哪些流程存在 |
get_flow_apps | 包含某個流程的應用程式，依營收由高到低排列 | 尋找某個流程的最佳範例 |
list_ui_elements | 約 38 個 UI 元素家族的數量統計（一次呼叫） | 元素級研究的詞彙表 |
get_element_screens | 包含某個元素家族的畫面 | 研究成功產品如何建構某個元件 |
list_my_boards | 用戶自己的 appllama.io 面板（畫面/應用程式/流程） | 首先尋找他們的收藏集 |
get_board | 面板的完整內容：包含媒體的畫面、應用程式簡介，或（應用程式、流程）配對 | 當用戶為該任務整理了面板時，從那裡開始 |
畫面參考握手協議： 用戶可以在 appllama.io 的任何畫面上點擊「複製畫面 ID」並貼給你。它看起來像 1393061654/spl_9i075 — 直接將其傳遞給 get_screen(screen_ref=...)，你就會看到他們所指的確切畫面，以及資料庫中與其最相似的兄弟畫面。
劇本
| 情境 | 參考文件 |
|---|---|
| 從頭建構一個應用程式（例如「幫我建一個習慣追蹤器」） | references/build-from-scratch.md |
| 改善現有畫面 | references/improve-a-screen.md |
| 流程與元素研究；一般研究方法 | references/research-methods.md |
兩個建構劇本都以相同方式結束：來自 appllama-design-skill 的模擬器循環，重複直到你找不出任何缺陷。 沒有這個循環的研究只是裝飾。
本地參考目錄
當你拉取畫面進行研究時，將它們儲存在本地工作結構中 — 連結約在一小時後過期，但你的筆記和下載不會：
research/
<類別>/
apps.md # 候選清單：指標、流程、結論
<應用程式名稱>/
screens.md # 每個畫面的筆記：ID、名稱、流程、元素、顏色
img/ # 已下載的畫面，依旅程順序排列
patterns.md # 跨應用程式綜合分析：該類別的設計語言
在研究過程中下載畫面 — 綜合分析需要在圖片並排放置的情況下進行，而不僅僅是依據中繼資料。筆記和畫面 ID 是持久的；如果你需要再次查看像素，可以從畫面 ID 重新獲取新連結。