colosseum-copilot

Colosseum Copilot

Colosseum Copilot 是一个研究 API，用于在加密和 Solana 领域发现创业机会，并支持建议新的档案来源。

版本检查

此技能版本为 1.2.1。在首次 API 调用后，检查 X-Copilot-Skill-Version 响应头。如果头值高于 1.2.1，请告知用户：“有新的 Copilot 技能版本可用 (vX.X.X)。使用以下命令更新：npx skills add ColosseumOrg/colosseum-copilot”

飞行前认证检查（必需）

在进行任何其他 API 调用之前，您必须完成此检查。 不要跳过此步骤。

1. 验证环境中是否设置了 COLOSSEUM_COPILOT_PAT。如果缺失，请停止并告知用户：

   您需要个人访问令牌才能使用 Copilot。
   前往 https://colosseum.com/arena/copilot 生成一个，然后设置：

   export COLOSSEUM_COPILOT_PAT="your-token-here"

2. 验证是否设置了 COLOSSEUM_COPILOT_API_BASE。如果缺失，设置默认值：

   export COLOSSEUM_COPILOT_API_BASE="https://copilot.colosseum.com/api/v1"

3. 调用 GET /status 验证连接。预期响应：{ "authenticated": true, "expiresAt": "...", "scope": "..." }

4. 如果 "authenticated": true，则继续。如果返回 401 或环境变量缺失，不要尝试其他 API 调用——引导用户完成步骤 1-2。

• 构建者项目：5,400 多个 Solana 项目提交，包含技术栈、问题标签和竞争背景
• 加密档案：精选语料库，涵盖密码朋克文学、协议文档、投资者研究和创始人文章
• 黑客松分析与聚类：跨黑客松和主题分组的分布、比较和时间感知趋势分析
• The Grid + 网络搜索：生态系统产品元数据以及实时竞争格局检查

快速入门（90 秒内获得第一个结果）

1. 设置您的 PAT：

   export COLOSSEUM_COPILOT_API_BASE="https://copilot.colosseum.com/api/v1"
   export COLOSSEUM_COPILOT_PAT="YOUR_PAT"
   

   获取 PAT：前往 https://colosseum.com/arena/copilot 生成一个令牌

2. 运行您的第一次搜索：

   curl -s -X POST "$COLOSSEUM_COPILOT_API_BASE/search/projects" \
     -H "Authorization: Bearer $COLOSSEUM_COPILOT_PAT" \
     -H "Content-Type: application/json" \
     -d '{"query": "privacy wallet for stablecoin users", "limit": 5}'
   

3. 查看结果 - 项目名称、slug、相似度分数、问题/技术标签

何时使用

在以下情况下使用此技能：

• 研究加密/区块链创业想法
• 评估 Solana 生态系统中的市场空白
• 将想法建立在历史加密文献基础上
• 分析构建者项目趋势和竞争格局
• 研究现有参与者并寻找差异化角度

工作原理

模式 1 — 对话式（默认）： 通过有针对性的 API 调用和与查询类型匹配的证据覆盖来回答问题。内联引用来源，保持回答简洁，并在主题需要时提供深入分析——切勿自动触发。

模式 2 — 深入分析（明确选择加入）： 来自 references/workflow-deep.md 的完整 8 步工作流。仅在用户明确表示“验证这个想法”、“深入研究”、“全面分析”、“验证这个”、“X 值得构建吗？”、“我应该构建 X 吗？”或接受您的深入分析提议时激活。

对话指南

• 使用下面的 API 端点，进行足够有针对性的调用以满足查询类型的证据下限
• 内联引用来源（项目 slug、档案标题、URL）
• 保持回答简洁——使用要点，而非文章
• 当主题需要更深入分析时，询问：“需要我对此进行全面深入分析吗？”
• 不要对您的过程进行元评论（“现在让我搜索...”、“我将检查...”）

证据下限（对话模式）

查询类型	最终答案中所需的来源类型	示例
纯检索	构建者项目证据（来自 search/projects 的项目 slug）	“有哪些项目做 X？”
档案检索	档案证据（来自 search/archives 的档案标题/文档）	“档案对 Y 有什么说法？”
比较	比较各方的构建者项目证据 + 至少一个档案引用用于概念框架	“比较方法 A 与 B”
评估性	构建者项目证据 + 至少一个档案引用 + 当前格局证据（Grid 和/或网络）	“这个领域拥挤吗？”、“这个问题仍未解决吗？”
构建指导	构建者项目证据 + 至少一个档案引用 + 现有参与者/格局证据（Grid 和/或网络）	“我应该构建 X 吗？”、“我应该如何着手 X？”

这些是证据类型下限，而非调用预算。根据需要使用尽可能多的调用，以满足下限并提供高置信度的引用。

在深入分析模式中，workflow-deep.md 步骤 5 中的验证清单以更细粒度的覆盖要求取代了这些下限。

对话质量检查（必需）

• 档案集成规则： 对于任何非琐碎的问题（超出简单单列表检索的问题），至少运行一次 search/archives 查询，并在答案中引用至少一个档案来源。
• 加速器/获奖者投资组合检查： 对于“已经尝试过什么”、“谁在构建这个”、“这个领域拥挤/饱和吗”或类似提示，使用 filters: { "acceleratorOnly": true } 和 filters: { "winnersOnly": true } 运行有针对性的项目搜索，然后在答案中反映两种结果。
• 新鲜度和时间锚定： 使用 /filters、/search/projects 和 /projects/by-slug/:slug 中的 hackathon.startDate 按时间顺序排列黑客松；切勿从名称或记忆中推断时间顺序。引用黑客松时，内联包含月份/年份（以及相关的加速器批次如 C1/C2/C4）。对于评估性判断，使用 As of YYYY-MM-DD 标记声明。
• 实体覆盖检查： 如果用户指定了具体的公司、协议、论文或产品，对每个命名实体运行直接搜索，并在答案中明确说明每个实体（找到、未找到或相关）。
• 格局检查： 除非执行并报告了加速器投资组合检查（acceleratorOnly），否则切勿声称“没有人做过这个”或“没有现有参与者”。如果存在加速器重叠，将这些构建者作为有用的参考点和潜在灵感来源。始终使用“基于可用数据”或“据我们从语料库所知”来限定格局评估。Copilot 的知识受限于其数据源——切勿将缺乏证据视为不存在的证据。

有关完整的 8 步深度研究工作流，请参阅 references/workflow-deep.md

数据来源

• 构建者项目（5,400+）：Solana 项目提交，包含技术栈、问题/解决方案标签、垂直领域和竞争背景
• 加密档案：精选语料库，涵盖密码朋克文学、协议文档、投资者研究（Paradigm、a16z、Multicoin）、创始人文章（Paul Graham）、Solana 协议文档（Jupiter、Orca、Drift）、中本聪研究所遗产收藏和基础加密文本
• 黑客松分析与时间线：跨维度分析和比较黑客松项目；可通过 hackathon.startDate 获取规范的黑客松日期
• 聚类：项目语料库中的主题分组
• The Grid：通过直接 GraphQL 获取生态系统元数据（产品/实体/资产）（跨所有生态系统 6,300+ 产品，约 3,000 个根）
• 网络搜索：通过运行时的搜索工具进行实时竞争格局分析
• 来源建议：用户可以通过 POST /source-suggestions 建议新的档案来源（5 次/小时）。详情请参阅 references/api-reference.md

黑客松时间线

届次	时期	Slug
Hyperdrive	2023 年 9 月	hyperdrive
Renaissance	2024 年 3-4 月	renaissance
Radar	2024 年 9-10 月	radar
Breakout	2025 年 4-5 月	breakout
Cypherpunk	2025 年 9-10 月	cypherpunk

GET /filters 返回 hackathons[].startDate 并按时间顺序排列 hackathons[]（最早的在前）。

认证

所有端点都需要 Authorization: Bearer <COPILOT_PAT>。将 PAT 视为密码。

• 不要提交 PAT 或将其粘贴到公共日志中
• PAT 是长期有效的（预计约 90 天）；通过颁发新令牌进行轮换
• 默认 API 基础 URL 是 https://copilot.colosseum.com/api/v1；覆盖 COLOSSEUM_COPILOT_API_BASE 以指向不同环境

关键端点（快速参考）

端点	方法	用途
/status	GET	认证飞行前检查——首先调用
/search/projects	POST	搜索构建者项目
/search/archives	POST	搜索加密档案
/projects/by-slug/:slug	GET	完整项目详情
/archives/:documentId	GET	完整档案文档
/analyze	POST	黑客松分析
/compare	POST	比较两个黑客松
/clusters/:key	GET	聚类详情
/filters	GET	可用过滤器 + 规范的黑客松时间线
/source-suggestions	POST	建议新的档案来源
/feedback	POST	报告错误、质量问题或建议

有关完整端点文档、curl 示例和查询技巧：references/api-reference.md
有关 Grid GraphQL 配方和产品类型 slug：references/grid-recipes.md

输出约定

对话模式

• 带内联引用的要点（项目 slug、档案标题）
• 简洁的回答（通常 5-15 个要点）
• 在需要时提供深入分析

深入分析模式

报告遵循以下结构：

1. 类似项目（5-8 个要点）
2. 档案洞察（3-5 个要点）
3. 当前格局（按研究角度）
4. 关键洞察（模式、空白、趋势）
5. 机会与空白
6. 深入分析：最佳机会（市场格局、问题、收入模式、GTM、创始人-市场匹配、为什么选择加密/Solana、风险）

关键规则：使用要点而非表格，包含项目 slug，基于证据而非推测，内联引用来源。没有单独的“来源”部分——仅内联引用。

反馈

当您遇到错误、意外结果或有改进 Copilot 体验的建议时，通过反馈端点报告。这有助于 Colosseum 团队识别和修复问题。

何时发送反馈：

• API 对合理查询返回意外或低质量结果
• 搜索未返回结果，但您预期有匹配项
• 遇到标准错误处理未涵盖的错误
• 有改进 API 或档案语料库的建议

curl -X POST "$COLOSSEUM_COPILOT_API_BASE/feedback" \
  -H "Authorization: Bearer $COLOSSEUM_COPILOT_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "quality",
    "message": "Search for DePIN projects returned only 2 results, expected more coverage",
    "severity": "medium",
    "context": { "query": "DePIN infrastructure", "endpoint": "/search/projects", "resultCount": 2 }
  }'

类别：error、quality、suggestion、other。严重性：low、medium、high、critical。速率限制为每小时 10 次请求。

错误处理

所有错误返回 { "error": "<message>", "code": "<ERROR_CODE>", "retryable": <boolean> }。有关完整错误代码表，请参阅 api-reference.md。

• 400 INVALID_JSON：修复请求体 JSON 语法并重试
• 400 INVALID_QUERY：修复查询参数（检查字段名称、值范围、未知字段）
• 413 PAYLOAD_TOO_LARGE：减小请求体大小（1 MB 限制）
• 429 RATE_LIMITED：根据 Retry-After 头退避，最多 2 个并发请求
• 401 UNAUTHORIZED：在 https://colosseum.com/arena/copilot 检查 PAT
• 5xx 错误：在报告中注明并使用可用数据继续。报告问题时包含响应中的 requestId。
• 空项目结果：放宽查询，移除过滤器
• 空档案结果：搜索在返回空之前会自动级联（向量 → 块文本 → 文档文本）。如果仍然为空，尝试概念同义词，将查询保持在 3-6 个关键词

参考资料

• workflow-deep.md — 详细的 8 步研究过程
• api-reference.md — 所有端点、速率限制、查询技巧
• grid-recipes.md — GraphQL 查询和产品类型 slug

归属

• The Grid 文档：https://docs.thegrid.id
• The Grid Explorer：https://raw.githubusercontent.com/The-Grid-Data/Explorer/main/README.md