Revelica

Revelica 技能

Revelica 的插件包可将 Agent 与共享产品背景信息连接起来：客户研究、竞争分析、目标、押注和产品规格。它声明了 Revelica MCP 服务和三个起步技能。完整工作流位于服务端，服务会在其说明中指出每项工作对应的技能，并通过 load_skill 加载。

这里只有一个插件：plugins/revelica/，旁边为每个宿主提供一个清单。每个宿主的目录位于代码库根目录，该宿主会在此查找目录。安装和 OAuth 支持取决于客户端。

代码库结构

revelica/skills
├── plugins/revelica/            # The plugin, shared by every host
│   ├── .claude-plugin/          # Claude plugin manifest and icon
│   ├── .codex-plugin/           # OpenAI (ChatGPT and Codex) plugin manifest
│   ├── .mcp.json                # The Revelica MCP server
│   ├── skills/                  # Starting skills (also slash commands in Claude Code)
│   └── assets/                  # Brand icons
├── .claude-plugin/marketplace.json   # Claude Code marketplace catalog
├── .agents/plugins/marketplace.json  # Codex marketplace catalog
├── server.json                  # MCP registry manifest (registry.modelcontextprotocol.io)
├── scripts/package-openai.sh    # Exports the portable ZIP for OpenAI's plugin portal
├── REVIEWING.md                 # Test setup for directory reviewers
└── LICENSE                      # Apache-2.0

按平台安装

Claude Code

/plugin marketplace add revelica/skills
/plugin install revelica@revelica

该插件打包了起步技能和 MCP 服务配置。使用工作区工具前，请先在客户端中授权服务连接。

Cowork

在组织的设置中，将 https://api.revelica.com/mcp 添加为自定义连接器。服务的说明会指出每项工作对应的技能，list_skills 会列出其余技能。

Codex

codex plugin marketplace add revelica/skills
codex plugin add revelica@revelica

在 ChatGPT 中，Revelica 出现在插件目录后即可安装。

其他客户端

Cursor、Gemini CLI 以及任何支持带 OAuth 的 Streamable HTTP 的其他客户端，都可以直接连接服务（请参阅直接连接 MCP 服务）。我们只为 Claude 和 OpenAI 宿主提供并测试插件。1.10.1 版移除了 Cursor 和 Gemini 清单，因为没有人测试它们。

起始提示词

该插件添加了三个技能，与 Revelica 应用提供的起步选项相同。在 Claude Code 中，每个技能也是一个斜杠命令：

技能	功能
/revelica:drive-product-outcome	围绕我们的目标规划工作：读取目标、相关衡量指标、当前押注及其证据，然后推荐下一步行动，并将其规划为工作。在此过程中，补齐工作区缺少的内容。
/revelica:ingestion	将洞察添加到知识图谱：将 URL、文件或笔记保存为产品证据，然后选择下一项有用的工作。
/revelica:interview-snapshot	分析客户访谈：将访谈记录整理成快照，并提炼出值得解决的客户问题。

插件连接和发送的内容

该插件不会在你的计算机上运行任何代码。它声明了一个远程 MCP 服务：https://api.revelica.com/mcp（Streamable HTTP），并打包了可用来启动常见工作的 Markdown 技能。

• **登录：**使用动态客户端注册的 OAuth 2.0，由你的客户端处理。插件不会读取你计算机上的任何凭据、令牌或文件。
• **发送的内容：**你的 Agent 发起的工具调用（query、read、create、update、load_skill、list_skills）及其参数，其中包含你要求保存到工作区的产品数据。
• **接收的内容：**你自己的 Revelica 工作区中的记录和技能说明。

不会向任何其他地方发送任何内容。有关 Revelica 如何处理你的数据，请参阅隐私政策。

可用的 MCP 工具

这些工具由 Revelica MCP 服务提供，可从任何技能调用：

工具	描述
query	按条件搜索或筛选工作区。返回按相关性排序的匹配项；设置 artifact_type 时，还会返回架构模板。
read	按 ID 完整读取单个制品或实体，或通过带点号的字段 path 导航到子树。
create	创建新的制品或实体。内容会根据已注册的架构进行验证。
update	通过点路径表示法应用字段级的部分更新。
load_skill	加载服务器技能的说明、就绪状态以及其起始记录的摘要。此操作本身不会执行剧本。
list_skills	列出可加载的技能，包括各技能的名称、描述和必需输入。

所有工具都需要 OAuth 身份验证，并执行 Supabase 行级安全策略，因此用户只能查看自己工作区中的数据。

技能

产品工作流是连接的 Revelica MCP 服务上的技能：drive-product-outcome、frame-bet、write-product-spec、design-experiment、product-for-coding-agents 等。服务器说明会指明哪项技能适合哪类任务，而 list_skills 会显示连接用户的完整技能目录。

Idea 就是产品规格。它的故事地图、结构化文档和 Markdown 都是同一份规格的不同呈现形式。

加载技能后，当前 Agent 可以使用可用工具遵循工作流；这不会启动服务器端剧本。这些基于工具的工作流不需要宿主实现 skills-over-MCP 扩展。

更新

产品工作流说明托管在 Revelica 服务上，因此应用和已连接的 Agent 都能发现相同的权威工作流。此软件包中的三个技能与其启动的服务端技能共用名称和描述，并通过 load_skill 从服务端加载完整工作流，因此工作流及其报告的工作区就绪状态始终保持最新。1.9.0 版移除了内置的 use-revelica 和 product-for-coding-agents 路由器：所有受支持的 Claude 宿主都会显示服务端说明，其中包含相同的路由规则。

1.10.0 版将插件移至 plugins/revelica/，并将命令改为技能，以便所有宿主都能使用，同时新增了 OpenAI 清单。请同步更新每份清单中的版本，包括 server.json，以及 MCP 服务报告的 SERVER_VERSION 常量（位于 scryfast 中的 revelica_agents/app/mcp_server/server.py）。将版本发布命名为 Revelica X.Y.Z，并在发布说明中列出目标平台。Revelica 在所有宿主上使用同一版本；特定平台的变更也共用该版本。例如，Revelica 1.10.4 增加了 Codex 插件元数据，并为 Codex 和 ChatGPT 提供了可移植的打包方式。

软件包更新与服务端部署是分开的。新编写的服务端工作流必须先部署，已连接的客户端才能加载它。安装此软件包不会部署服务端变更。

运行 bash scripts/package-openai.sh，为 OpenAI 的提交门户构建 dist/revelica-openai-<version>.zip。该脚本会将 Codex 清单中的列表字段导出到可移植根目录 plugin.json 的 extensions.com.openai.interface 下，并将 .mcp.json 导出为使用 Streamable HTTP 传输名称的 mcp.json。审查用例和发布元数据会予以保留。此公开上传不包含共享插件的 Claude 和 Codex 兼容性清单。 软件包验证不涵盖门户审查者访问权限、演示、国家/地区定位、扫描或证明材料。

导出器不会覆盖现有归档文件。进行验证构建时，请选择新路径：bash scripts/package-openai.sh --output /tmp/revelica-check.zip。ZIP 条目时间戳和权限均已固定，因此使用相同 Python/zlib 工具链构建时会生成完全相同的字节。运行 python3 -m unittest discover -s scripts/tests -v 执行打包检查。

请私下保留一份与提交审查的 ZIP 完全一致的副本。dist/ 仍会被忽略。审查者账户详情、录制文件和提交说明应保存在此公开仓库之外。公开清单包含可复用的测试用例；准备上传时，请私下提供针对本次提交的工作区说明和录制元数据。重新导出不能替代原始上传文件。

plugins/revelica/skills/ 中的技能沿用服务端同名技能的名称、描述和起始提示词（scryfast revelica_agents/app/agents/revelica/skills/）。这些内容变更时，请同步更新。

直接连接 MCP 服务

如果你希望不使用插件而连接服务端，请将其添加为远程 MCP 服务／自定义连接器：

服务端 URL	https://api.revelica.com/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.0，支持动态客户端注册，因此无需管理 API 密钥
前提条件	一个 Revelica 工作区（注册）

服务端元数据发布于 /.well-known/mcp/server-card.json。

隐私政策

Revelica 的隐私政策说明了收集哪些数据、如何使用和存储数据、与第三方共享数据、数据保留期限，以及如何联系我们。政策发布于 revelica.com/privacy。服务条款见 revelica.com/terms。

MCP 服务仅读取和写入您自己的 Revelica 工作区中的产品数据。每个请求都通过 OAuth 进行身份验证，并受 Supabase 行级安全策略约束，因此已连接的 Agent 绝不会看到其他工作区的数据。服务不会查询您的聊天记录、对话摘要或文件。

支持

• 为目录审核插件： 请参阅 REVIEWING.md

• 插件相关问题： 提交 GitHub 问题

• 账户、工作区或 MCP 服务相关问题： [email protected]

许可证

Apache-2.0 © Revelica

关于 Revelica

Revelica 是一个 AI 原生的产品发现平台。它帮助产品团队收集客户洞察、开展竞争分析，并通过实验验证创意，为 AI 开发工作流提供助力。

🔗 官网，提供 Pro 免费试用：https://revelica.com

🔗 模板库，包含操作手册、技能和洞察模板：https://revelica.com/templates

🔗 无需注册即可使用的免费 AI 工具：https://revelica.com/tools