Communitygithub.com

membranedev/application-skills

Waitlist 整合。管理資料、記錄並自動化工作流程。當使用者想要與 Waitlist 資料互動時使用。

application-skills 是什麼?

這是一個專門用來與 Waitlist 服務互動的 AI 代理技能。Waitlist 是一個 SaaS 應用程式,讓企業能為產品發布或活動建立與管理候補名單,協助他們捕捉潛在客戶並營造期待感,主要使用者為行銷團隊與產品經理。本技能透過 Membrane CLI 提供統一的介面,讓 AI 代理能夠自動處理認證與憑證刷新,簡化與 Waitlist API 的整合流程。支援的平台包括 Claude Code、Cursor、Codex、Warp 和 Windsurf 等常見代理環境。開發者或 AI 代理可以使用預先建置的動作(例如管理參與者、表單及設定),並透過自然語言搜尋來探索可用功能;若預設動作不足,也可直接透過 Membrane 代理發送 HTTP 請求至 Waitlist API。本技能強調安全優於便利:代理人應優先使用 membrane action 來管理資料,避免直接要求使用者提供 API 金鑰,以減少憑證暴露風險與 token 消耗。

相容平台✓Claude Code✓Codex CLI~Cursor✓Windsurf
npx skills add https://github.com/membranedev/application-skills/tree/HEAD/skills/waitlist

在你喜歡的 AI 中提問

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

說明文件

Waitlist

Waitlist 是一個 SaaS 應用程式,讓企業能為產品發布或活動建立並管理候補名單,協助他們捕捉潛在客戶並營造期待感。主要使用者為行銷團隊與產品經理。

官方文件:https://developers.waitlist.com/

Waitlist 概覽

  • 候補名單
    • 參與者
    • 表單
  • 設定

視需要使用的動作名稱與參數。

使用 Waitlist

本技能使用 Membrane CLI 與 Waitlist 互動。Membrane 會自動處理認證與憑證刷新,讓您能專注於整合邏輯而非認證細節。

安裝 CLI

安裝 Membrane CLI 以便從終端機執行 membrane:

npm install -g @membranehq/cli@latest

認證

membrane login --tenant --clientName=<agentType>

此指令會根據互動模式是否可用,開啟瀏覽器進行認證,或將授權 URL 列印到終端機。

無頭環境: 此指令會印出一個授權 URL。請使用者在其瀏覽器中開啟該 URL。當他們完成登入後看到一組驗證碼時,請執行以下指令完成流程:

membrane login complete <code>

在任何指令後加上 --json 可取得機器可讀的 JSON 輸出。

代理類型: claude、openclaw、codex、warp、windsurf 等。這些類型會用於調整工具以最佳配合您的 Harness。

連接到 Waitlist

使用 membrane connection ensure 透過應用程式 URL 或網域來尋找或建立連線:

membrane connection ensure "http://getwaitlist.com/" --json

使用者在瀏覽器中完成認證。輸出內容包含新的連線 ID。

這是取得連線最快的方式。URL 會被正規化為網域,並與已知的應用程式比對。若找不到對應應用程式,則會建立一個新的應用程式,並自動建構對應的連接器。

如果傳回的連線狀態為 "READY",請跳到步驟 2。

1b. 等待連線就緒

如果連線處於 BUILDING 狀態,請輪詢直到就緒:

npx @membranehq/cli connection get <id> --wait --json

--wait 旗標會進行長時間輪詢(最長 --timeout 秒,預設 30 秒)直到狀態變更。持續輪詢直到 state 不再是 BUILDING。

結果狀態告訴您下一步該做什麼:

  • READY — 連線已完全設定完畢。跳到步驟 2。

  • CLIENT_ACTION_REQUIRED — 使用者或代理需要採取某些行動。clientAction 物件描述了所需的動作:

    • clientAction.type — 所需動作的類型:
      • "connect" — 使用者需要進行認證(OAuth、API 金鑰等)。涵蓋初始認證與重新認證已斷開的連線。
      • "provide-input" — 需要更多資訊(例如要連接到哪個應用程式)。
    • clientAction.description — 人類可讀的動作說明。
    • clientAction.uiUrl(可選)— 預先建置的使用者介面 URL,使用者可在此完成動作。若存在則向使用者顯示。
    • clientAction.agentInstructions(可選)— 給 AI 代理的指示,說明如何以程式化方式進行。

    使用者完成動作後(例如在瀏覽器中進行認證),請再次使用 membrane connection get <id> --json 輪詢以檢查狀態是否變為 READY。

  • CONFIGURATION_ERROR 或 SETUP_FAILED — 發生錯誤。請檢查 error 欄位以取得詳細資訊。

搜尋動作

使用自然語言描述您想做的事來進行搜尋:

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

您應始終在特定連線的上下文中搜尋動作。

每個結果包含 id、name、description、inputSchema(動作接受的參數)以及 outputSchema(動作回傳的內容)。

熱門動作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 來探索可用的動作。

執行動作

membrane action run <actionId> --connectionId=CONNECTION_ID --json

若要傳遞 JSON 參數:

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

結果位於回應中的 output 欄位。

代理請求

當可用的動作無法滿足您的需求時,您可以透過 Membrane 的代理直接傳送請求到 Waitlist API。Membrane 會自動將基底 URL 附加到您提供的路徑,並注入正確的認證標頭 — 包括在憑證過期時進行透明的刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用選項:

旗標說明
-X, --methodHTTP 方法(GET、POST、PUT、PATCH、DELETE)。預設為 GET
-H, --header新增請求標頭(可重複),例如 -H "Accept: application/json"
-d, --data請求主體(字串)
--json簡寫方式,用於傳送 JSON 主體並設定 Content-Type: application/json
--rawData原樣傳送主體,不做任何處理
--query查詢字串參數(可重複),例如 --query "limit=10"
--pathParam路徑參數(可重複),例如 --pathParam "id=123"

最佳實務

  • 始終優先使用 Membrane 與外部應用程式溝通 — Membrane 提供預先建置的動作,內建認證、分頁與錯誤處理。這會消耗較少的 token,並使通訊更加安全。
  • 先探索再建置 — 在撰寫自訂 API 呼叫之前,先執行 membrane action list --intent=QUERY(將 QUERY 替換為您的意圖)來尋找現有的動作。預先建置的動作能處理分頁、欄位對應以及原始 API 呼叫遺漏的邊界情況。
  • 讓 Membrane 處理憑證 — 絕對不要向使用者索取 API 金鑰或 token。請建立連線;Membrane 會在伺服器端管理完整的認證生命週期,不留存任何本機祕密。

Individual skills in this repo

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

相關技能