mcpField
C
catalyst-basics

catalyst-basics

github.com/catalystbyzoho云与 DevOps701.1k 次安装今天更新
代码仓库

关于 catalyst-basics

catalyst-basics 是 Zoho Catalyst 项目设置、命令行、架构和账户信息的指导技能。它将 Agent 引向相关参考资料，并要求在项目操作前检查 Zoho MCP 与项目配置。

主要功能

  1. 01说明项目设置与目录结构
  2. 02指导 Catalyst 命令行操作
  3. 03涵盖服务选择与架构
  4. 04提供 IDE 和 MCP 设置参考

适用场景

  1. 01开始创建 Catalyst 项目
  2. 02查找项目或资源 ID
  3. 03选择 Catalyst 服务
  4. 04为 IDE 配置 Catalyst

MCP 相关

指导 Agent 使用 CatalystbyZoho_* MCP 工具获取组织、项目和资源信息，避免手动索要 ID。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-basics

安装后在 Claude Code 中输入/catalyst-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
architecture.md
cli.md
console-ui-guide.md
project-basics.md
quick-start.md
references/setup/
claude-code.md
cursor.md
github-copilot.md

详细介绍

⚠️ 前置检查： 创建任何项目文件之前，请确认项目目录中存在 .catalystrc 和 catalyst.json。如果不存在：

  1. 使用 MCP（CatalystbyZoho_List_All_Organizations → CatalystbyZoho_List_All_Projects）获取组织 ID 和项目 ID。
  2. 运行：catalyst init --org <orgId> -p <projectId> -ni
  3. 绝不要要求用户以交互方式运行 catalyst init。绝不要手动创建这些文件——它们由 CLI 生成，必须通过 CLI 创建。

工作原理

  1. 先检查 MCP——读取任何本地文件之前，查找 CatalystbyZoho_* 工具。如果可用，使用 MCP 获取组织 ID、项目 ID 和所有资源 ID，而不是询问用户。
  2. 检查账户是否匹配——在运行 catalyst init 之前执行——MCP 和 CLI 可能通过不同的账户进行身份验证。运行 catalyst init --org <id> 之前，请确认两者账户一致： 
    catalyst whoami
    将显示的组织名称与 CatalystbyZoho_List_All_Organizations 的结果进行比较。如果不一致，请运行 catalyst login --force，在继续操作之前重新验证 CLI 身份。
  3. 刚开始使用 Catalyst？——如果用户正在首次设置 Catalyst，或询问“如何开始”，请加载 references/quick-start.md，查看完整的操作指南。
  4. 控制台导航——如果用户询问如何在控制台中查找 ID、创建表、设置权限或配置 CORS，请加载 references/console-ui-guide.md。
  5. 前置检查——确认 .catalystrc 和 catalyst.json 存在。如果缺少，请使用 MCP 获取组织 ID 和项目 ID，并运行 catalyst init --org <orgId> -p <projectId> -ni。绝不要使用交互式 catalyst init。
  6. 项目结构——加载 references/project-basics.md，了解目录布局、catalyst.json、ID 和从开发到生产的检查清单。
  7. CLI 问题——加载 references/cli.md，查看确切的命令、标志和安全规则。
  8. 作答——提供所需的具体 ID 路径或 CLI 命令。如果已连接 MCP，绝不要要求用户手动查找 ID。

触发条件

在以下情况下使用此技能：“如何开始 Catalyst 项目”“什么是 .catalystrc”“在哪里可以找到 Table ID / ZAID / Segment ID / Project ID”“Development 和 Production 有什么区别”“Catalyst 项目结构”“解释一下 catalyst.json”、catalyst init、catalyst deploy、catalyst serve、catalyst login、“如何使用 Claude 设置 Catalyst”“如何在 Cursor 中使用 Catalyst”“如何在 GitHub Copilot 中使用 Catalyst”“我应该使用哪个服务”“X 应该使用哪个 Catalyst 服务”，或任何关于 Catalyst ID、环境、组织、IDE 设置、架构决策或 CLI 子命令的问题。

MCP 连接检查（最先执行）

在读取 .catalystrc、向用户询问 ID 或执行任何与项目相关的操作之前，请检查工具列表中是否提供 Zoho MCP 工具。

查找以 CatalystbyZoho_ 开头的工具（例如，CatalystbyZoho_List_All_Projects、CatalystbyZoho_List_All_Tables）。

如果 MCP 工具可用：

  • 使用 CatalystbyZoho_List_All_Organizations 获取组织 ID
  • 使用 CatalystbyZoho_List_All_Projects 获取项目 ID
  • 使用 MCP 工具直接获取表名、存储桶名称、ZAID 和所有其他项目详情——不要要求用户从控制台复制粘贴 ID

如果 MCP 工具不可用：

  • 请用户在继续操作之前连接 Zoho MCP
  • 指引用户前往：VS Code → Settings → MCP（或 Claude Desktop 的 claude_desktop_config.json），并添加 Catalyst MCP 服务
  • 只有在万不得已时，才从本地项目目录读取 .catalystrc 和 catalyst.json

**如果已连接 MCP，绝不要要求用户手动从控制台查找 ID。**每项项目详情——组织 ID、项目 ID、表 ID、ZAID、存储桶名称——都可以通过 MCP 工具获取。MCP 可用时还要求用户费力查找 ID，会浪费时间并引入复制粘贴错误。

参考资料

加载相关参考文件，获取详细信息：

参考文件内容
references/quick-start.md首次设置——安装 CLI、catalyst init、查找组织/项目 ID、添加函数、本地运行、部署、创建 Data Store 表、配置 CORS/授权域名
references/console-ui-guide.md控制台导航——查找 Project ID/ZAID/Table ID、使用带类型的列创建表、启用 App User 权限（Scopes 和 Permissions）、授权域名 + CORS 开关
references/project-basics.md项目目录结构、catalyst.json、.catalystrc、catalyst-config.json、环境、从开发到生产的检查清单、所有 Catalyst ID（Project ID、ZAID、Table ID、Segment ID 等）
references/cli.md完整 CLI 命令参考——包含标志的所有子命令、Slate/AppSail 非交互式设置、catalyst serve 端口行为、部署范围、安全规则、资源优先的开发顺序
references/architecture.md服务选择指南——不同模式应使用哪些 Catalyst 服务、典型技术栈组合、受区域限制服务的数据中心可用性表
references/setup/claude-code.md在 Claude Code（Claude Desktop）中安装技能并连接 Zoho MCP
references/setup/cursor.md在 Cursor 中安装技能并连接 Zoho MCP
references/setup/github-copilot.md在 GitHub Copilot（VS Code）中安装技能并连接 Zoho MCP

评论

支持 Markdown