/ 目錄 / 演練場 / prismatic-skills
● 社群 prismatic-io ⚡ 即開即用

prismatic-skills

作者 prismatic-io · prismatic-io/prismatic-skills

Prismatic.io 官方技能,用於建立程式碼原生整合與自訂連接器——無需點選 UI 介面即可快速建立連接器。

Prismatic 官方發布的技能,專為其整合平台設計。這些技能教導 Claude Code 如何建立程式碼原生的 Prismatic 整合:包含連接器鷹架、撰寫動作處理器、使用 SDK 在本機測試,以及部署。官方來源,聚焦範疇明確。

為什麼要用

核心特性

即時演示

實際使用效果

prismatic-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "prismatic-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "prismatic-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/prismatic-io/prismatic-skills",
          "~/.claude/skills/prismatic-skills"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add prismatic-skill -- git clone https://github.com/prismatic-io/prismatic-skills ~/.claude/skills/prismatic-skills

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: prismatic-skills

為內部 API 建立自訂 Prismatic 連接器

👤 使用 Prismatic 的團隊中負責整合的工程師 ⏱ ~90 min advanced

何時使用: 當您有內部 API 需要讓 Prismatic 流程呼叫時。

前置條件
  • Prismatic 帳號與 SDK — npm i -g @prismatic-io/prism; prism login
  • 已安裝技能 — git clone https://github.com/prismatic-io/prismatic-skills ~/.claude/skills/prismatic-skills
步驟
  1. 建立連接器鷹架
    Use prismatic-skills. Scaffold a connector for our Orders API — base URL, bearer auth, actions for list, get, create.✓ 已複製
    → 包含 TS 入口點、清單檔及測試檔的連接器目錄
  2. 實作動作
    Fill in the listOrders action with pagination and error handling.✓ 已複製
    → 含型別與 Prismatic 輸入/輸出慣例的 TS 實作
  3. 本機測試
    Run the test harness with a mock response.✓ 已複製
    → prism tests 輸出;全部通過

結果: 一個可部署的連接器,讓流程能夠使用其中的動作。

注意事項
  • 缺少輸入驗證 — Prismatic 在平台邊界進行驗證;仍建議使用 Zod 或類似工具確保執行期安全
搭配使用: filesystem

在既有 Prismatic 連接器中新增動作

👤 已部署連接器的維護人員 ⏱ ~30 min intermediate

何時使用: 業務需要在現有整合上新增動作(例如退款流程)時。

步驟
  1. 識別現有模式
    Use prismatic-skills. Look at the existing actions/ and mimic the pattern for a new 'refundOrder' action.✓ 已複製
    → 風格與現有動作一致的動作檔案
  2. 發布
    Bump the connector version and deploy.✓ 已複製
    → prism integrations:publish 執行成功

結果: 連接器已更新,且不會破壞現有流程。

注意事項
  • 未升版本號就變更輸入 schema — 為連接器進行版本控管;舊流程可固定使用舊版本,直到完成遷移

組合

與其他 MCP 搭配,撬動十倍槓桿

prismatic-skill + filesystem

管理多連接器的 monorepo

Add connectors/widgets-api/ following the same pattern as connectors/users-api/.✓ 已複製
prismatic-skill + github

結合技能情境審查連接器 PR

Review this PR against Prismatic connector conventions.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
scaffold_connector name, auth type, actions 建立新連接器時 0
write_action action spec 實作個別動作時 0
run_tests connector path 發布前執行 local
publish_connector connector path 部署時 Prismatic deploy

成本與限制

運行它的成本

API 配額
技能本身無配額限制
每次呼叫 Token 數
Moderate
費用
依 Prismatic 方案計費;技能本身免費
提示
部署前先用 SDK 在本機測試,減少不必要的部署次數。

安全

權限、密鑰、影響範圍

憑證儲存: Prismatic 憑證透過 prism CLI 管理(不儲存於技能中)
資料出站: Prismatic 平台,以及您的連接器所呼叫的各項 API

故障排查

常見錯誤與修復

prism login fails

Token 權限不足或已過期;請重新透過瀏覽器流程登入

驗證: prism me
Connector publishes but flows can't see new action

客戶可能需要在其流程設定中升級連接器版本

Input schema rejected

Prismatic 對輸入格式有特定要求;請參閱官方文件或技能的動作範本

替代方案

prismatic-skills 對比其他方案

替代方案何時用它替代權衡
Prismatic low-code UI適用於簡單整合、無需自訂程式碼的情境彈性較低;無法透過 git 進行版本控管
Raw Prismatic SDK without skill已熟悉 SDK 的使用者缺少引導式鷹架輔助

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills