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. 深入分析：最佳機會 (市場格局、問題、收入模式、上市策略、創辦人市場契合度、為何選擇加密貨幣/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