棱镜技能

Claude Code 插件，用于通过对话构建和管理 Prismatic 集成。 构建自定义组件、生成代码本机集成、探索您的 Prismatic 环境并操作平台 — 所有这些都可以通过您的编辑器完成。

先决条件

• Prism CLI：通过 npm install -g @prismatic-io/prism 安装（还提供捆绑的 MCP 服务器）
• Prismatic 帐户：具有集成/组件权限的活动帐户
• Node.js 18+：工作流程脚本所需（通过 tsx 运行）
• Claude Code：CLI 或具有插件支持的扩展

安装

在 Claude Code 中添加市场并安装插件：

/plugin marketplace add prismatic-io/prismatic-skills
/plugin install prismatic-skills@prismatic-skills

开发/测试

对于本地开发，直接加载插件：

claude --plugin-dir /path/to/prismatic-skills

可用命令

/prismatic-skills:build-component

构建并部署 Prismatic 自定义组件。

/prismatic-skills:build-component Canny API connector

工作流程：

1. 设置 - 验证 Prism CLI 和身份验证
2. 要求 - 交互式调查问卷（组件类型、API 详细信息）
3. API研究 - 对于连接器，研究外部API
4. Scaffold - 通过 Prism CLI 生成组件结构
5. 代码生成 - 实施操作、触发器、连接
6. 构建和发布 - 编译并部署到 Prismatic

/prismatic-skills:build-integration

构建并部署 Prismatic 代码本机集成 (CNI)。

/prismatic-skills:build-integration Salesforce to Slack sync

工作流程：

1. 设置 - 验证 Prism CLI 和身份验证
2. 要求 - 互动问卷（系统、触发器、数据流）
3. 凭据收集 - 如果需要，收集 OAuth/API 凭据
4. 脚手架 - 使用组件清单生成项目结构
5. 代码生成 - 创建 TypeScript 文件（流程、配置页面等）
6. 构建、部署和测试 - 编译、部署和测试流程
7. 迭代 - 修复问题、重建、重新部署

/prismatic-skills:orby

向 Prismatic 平台指南 Orby 询问您的环境或让它执行平台操作。

/prismatic-skills:orby What integrations do I have?
/prismatic-skills:orby Deploy the Slack integration to Acme Corp
/prismatic-skills:orby How do I query execution logs in GraphQL?
/prismatic-skills:orby Show me the last 10 failed executions

能力：

• 环境探索 - 列出组件、集成、实例、客户和执行
• 平台运营 - 部署集成、管理实例、创建客户
• GraphQL 查询构造 - 针对 Prismatic API 构建并执行查询
• 文档搜索 - 从 prismatic.io/docs 搜索和检索内容
• 工作流程编排 - 多步骤操作，例如端到端部署
• 故障排除 - 调查失败的执行、检查日志、诊断问题

代理

代理	描述
component-builder	构建从需求到部署的自定义组件。 使用 DAG 驱动的调查问卷、可选的 API 研究以及用于脚手架、构建和发布的每阶段脚本。
cni-builder	构建从需求到部署的代码本机集成。 管理组件清单、OAuth 配置、TypeScript 生成、部署和测试周期。
external-api-researcher	通过获取和分析文档来研究外部 API。 将身份验证方法、端点、数据模型和 Webhook 功能提取到结构化 JSON 规范中。 仅当需求 DAG 确定需要研究时才产生。
orby	交互式棱柱形平台指南。 探索您的环境、执行平台操作、构建 GraphQL 查询、搜索文档并编排多步骤工作流程。

技能

该插件包括代理可以利用的四个知识库：

技能	目的
component-patterns	用于构建自定义组件的参考文档、代码生成模式和完整示例（实用程序、API 密钥连接器、OAuth2 连接器）
integration-patterns	参考文档、CNI 模式库（webhooks、状态持久性、错误处理、OAuth、多流等）以及代码本机集成的代码生成指南
prismatic-api	GraphQL 查询参考、API 访问层次结构（MCP 工具/Prism CLI）、客户、实例、执行、日志、组件和集成的查询模式
prismatic-docs	prismatic.io/docs 的文档搜索策略以及 Prismatic 示例存储库中的示例代码导航

脚本

构建器代理由 scripts/ 中的 TypeScript 脚本驱动，处理工作流程的每个阶段。 代理通过 npx tsx 调用这些脚本，而不是直接执行平台操作。

工作流程脚本（根级别）：

• prerequisites.ts - 验证 Prism CLI、身份验证并创建会话目录
• gather-requirements.ts - 基于 DAG 的交互式调查问卷，按依赖顺序遍历需求，自动跳过不相关的问题
• write-answer.ts - 编写需求文件的答案以供编程使用

组件脚本 (scripts/components/):

• scaffold-component.ts - 通过 Prism CLI 创建组件项目结构
• build-component.ts - 使用 webpack 编译 TypeScript
• publish-component.ts - 将组件部署到 Prismatic
• validate-component.ts - 验证已发布的组件

集成脚本 (scripts/integrations/):

• scaffold-project.ts - 使用组件清单创建 CNI 项目
• find-components.ts - 查找可用的 Prismatic 组件
• extract-connections.ts - 从组件中提取连接选项
• get-credential-prompts.ts - 获取连接的凭据字段
• build-integration.ts - 编译 TypeScript
• deploy-integration.ts - 部署到棱柱形
• test-integration.ts - 测试流程执行
• install-dependencies.ts - 安装 npm 包
• validate-typescript.ts - TypeScript 验证
• troubleshoot.ts - 快速诊断
• package-for-download.ts - 创建可下载包

共享实用程序 (scripts/shared/):- graphql.ts - 通过 Prism CLI 执行 GraphQL 查询

• prism-retry.ts - CLI 命令重试逻辑
• project-directory.ts - 会话目录管理
• search-connections.ts - 查找与集成无关的连接
• check-prism-access.ts - 验证 Prism CLI 身份验证
• timing.ts - 性能计时实用程序

存储库结构

prismatic-skills/
├── .claude-plugin/
│   ├── plugin.json                  # Plugin manifest
│   └── marketplace.json             # Marketplace catalog
├── .mcp.json                        # Bundled Prism MCP server config
├── commands/
│   ├── build-component.md           # /prismatic-skills:build-component
│   ├── build-integration.md         # /prismatic-skills:build-integration
│   └── orby.md                      # /prismatic-skills:orby
├── agents/
│   ├── component-builder.md
│   ├── cni-builder.md
│   ├── external-api-researcher.md
│   └── orby.md
├── skills/
│   ├── component-patterns/          # Component reference docs & examples
│   ├── integration-patterns/        # CNI reference docs & pattern library
│   ├── prismatic-api/               # GraphQL & API reference
│   └── prismatic-docs/              # Documentation search reference
├── scripts/
│   ├── prerequisites.ts             # Environment setup
│   ├── gather-requirements.ts       # DAG-based questionnaire
│   ├── write-answer.ts              # Programmatic answer writing
│   ├── components/                  # Component lifecycle scripts
│   ├── integrations/                # Integration lifecycle scripts
│   ├── shared/                      # Shared utilities
│   └── questions/
│       ├── component.json           # Component questionnaire DAG
│       └── integration.json         # Integration questionnaire DAG
└── README.md

许可证

我的