chris/KingClawArmy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 全面補強公司定義、排程、Schema

Browse Source 
- company.md：加回前後端工程師（18 agents）、engineering team、完整 .paperclip.yaml 範例、每個 agent 改用表格詳列 Mission/Scope/Forbidden/輸出/Model Tier/Escalation
- pipelines.md：市場情報改為每日 08:00 + 20:00 兩次（台股/美股開盤前）、週市場分析和週數據報告改到週日、移除投放 KPI 排程、新增秘書每日摘要排程、新增每日/每週時間軸、新增停損信號
- schemas.md：所有 schema 加上產出者職稱、新增信心指數/恐慌指數/進出場建議、補齊所有缺少的 Schema

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris
2026-04-10 16:28:35 +00:00
parent da6efce98d
commit aae5913bf2
4 changed files with 1080 additions and 251 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/INDEX.md
View File

@@ -6,9 +6,9 @@
| 文件 | 內容 | | 文件 | 內容 |
|---|---| |---|---|
| [company.md](company.md) | 公司定義、組織架構、團隊與 Agent 完整規格 | | [company.md](company.md) | 公司定義、組織架構（18 agents / 5 teams）、Agent 完整規格、Skills、.paperclip.yaml 設定、Package 結構 |
| [pipelines.md](pipelines.md) | Pipeline 流程、排程定義、審批機制 | | [pipelines.md](pipelines.md) | 量化 Pipeline 流程、排程定義（8 routines）、每日/每週時間軸、審批機制、模型分級、成本控制、停損信號 |
| [schemas.md](schemas.md) | 各 Agent 輸出的 JSON Schema 定義 | | [schemas.md](schemas.md) | 所有 Agent 輸出的 JSON Schema 定義（含信心指數、恐慌指數、進出場建議） |
--- ---
@@ -17,9 +17,10 @@
| 階段 | 說明 | 狀態 | | 階段 | 說明 | 狀態 |
|---|---|---| |---|---|---|
| Paperclip onboard | 初始化 Paperclip 環境 | 待執行 | | Paperclip onboard | 初始化 Paperclip 環境 | 待執行 |
| 建立 Company Package | 建立目錄結構、寫入所有定義 | 待開始 | | 建立 Company Package | 建立目錄結構、寫入所有 AGENTS.md / TEAM.md / SKILL.md | 待開始 |
| 匯入 Paperclip | `paperclipai company import` | 待開始 | | 匯入 Paperclip | `paperclipai company import` | 待開始 |
| 管理團隊上線 | CEO + 秘書 + 審查員 | 待開始 | | 管理團隊上線 | CEO + 秘書 + 審查員（3 agents） | 待開始 |
| 量化團隊上線 | 7 agents | 待開始 | | 量化團隊上線 | 策略師 + 6 研究/工程 agents（7 agents） | 待開始 |
| 行銷團隊上線 | 3 agents | 待開始 | | 行銷團隊上線 | 策略總監 + 市場研究員 + 投放分析師（3 agents） | 待開始 |
| 內容團隊上線 | 2 agents | 待開始 | | 內容團隊上線 | 創意總監 + 文案撰寫員（2 agents） | 待開始 |
| 工程團隊上線 | 前端 + 後端工程師（2 agents，依需求啟用） | 待開始 |

452
docs/company.md
View File

@@ -12,12 +12,13 @@
1. **量化研究**：情報蒐集 → 市場結構分析 → 多空辯論 → 策略形成 → 回測 → 分析 1. **量化研究**：情報蒐集 → 市場結構分析 → 多空辯論 → 策略形成 → 回測 → 分析
2. **行銷策略**：市場研究 → 品牌/成長策略 → 投放分析 2. **行銷策略**：市場研究 → 品牌/成長策略 → 投放分析
3. **內容創作**：策略 → 文案撰寫 → 視覺方向 3. **內容創作**：策略 → 文案撰寫 → 視覺方向
4. **工程開發**：前端介面 / 後端 API（依需求啟用）
### COMPANY.md Frontmatter ### COMPANY.md Frontmatter
```yaml ```yaml
name: KingClawArmy name: KingClawArmy
description: AI Agent 量化研究、行銷策略與內容創作團隊 description: AI Agent 量化研究、行銷策略、內容創作與工程開發團隊
slug: kingclawarmy slug: kingclawarmy
schema: agentcompanies/v1 schema: agentcompanies/v1
version: 1.0.0 version: 1.0.0
@@ -27,6 +28,7 @@ goals:
- 量化研究自動化：從情報蒐集到策略回測的完整 pipeline - 量化研究自動化：從情報蒐集到策略回測的完整 pipeline
- 行銷策略系統化：市場研究、品牌策略、投放追蹤 - 行銷策略系統化：市場研究、品牌策略、投放追蹤
- 內容創作流程化：文案與創意 brief 產出 - 內容創作流程化：文案與創意 brief 產出
- 工程任務自動化：前後端開發與維護
``` ```
--- ---
@@ -36,33 +38,37 @@ goals:
``` ```
董事長（Chris，人類） 董事長（Chris，人類）
│ │
├── 管理團隊 ├── 管理團隊（3 agents）
│ ├── CEO（coordinator） │ ├── CEO（coordinator，全局調度）
│ ├── 秘書 │ ├── 秘書（記錄、摘要、記憶管理）
│ └── 審查員 │ └── 審查員（品質把關 pass/revise/block）
│ │
├── 量化研究團隊 ├── 量化研究團隊（7 agents）
│ ├── 量化策略師（team lead） │ ├── 量化策略師（team lead，pipeline owner）
│ ├── 財經情報研究員 │ ├── 財經情報研究員（蒐集總經/盤前盤後資訊）
│ ├── 市場結構研究員 │ ├── 市場結構研究員（流動性/技術結構分析）
│ ├── 多方研究員 │ ├── 多方研究員（做多論點整理）
│ ├── 空方研究員 │ ├── 空方研究員（做空論點整理）
│ ├── 回測工程師 │ ├── 回測工程師（策略程式化 + 回測）
│ └── 資料分析師 │ └── 資料分析師（回測結果分析 + KPI）
│ │
├── 行銷策略團隊 ├── 行銷策略團隊（3 agents）
│ ├── 策略總監（team lead） │ ├── 策略總監（team lead，品牌/成長策略）
│ ├── 市場研究員 │ ├── 市場研究員（競品/消費者/趨勢研究）
│ └── 投放分析師 │ └── 投放分析師（廣告成效追蹤）
│ │
├── 內容創意團隊 ├── 內容創意團隊（2 agents）
│ ├── 創意總監（team lead） │ ├── 創意總監（team lead，視覺方向/分鏡）
│ └── 文案撰寫員 │ └── 文案撰寫員（廣告文案/影片腳本）
│ │
└── 小安（閒聊） ├── 工程團隊（2 agents）
│ ├── 前端工程師（UI/UX 開發）
│ └── 後端工程師（API/DB 開發）
│
└── 小安（閒聊陪伴）
``` ```
**總計：16 agents** **總計：18 agents**
--- ---
@@ -73,7 +79,7 @@ goals:
```yaml ```yaml
# teams/management/TEAM.md # teams/management/TEAM.md
name: 管理團隊 name: 管理團隊
description: 任務調度、記錄摘要、品質審查 description: 全局任務調度、工作記錄與摘要、產出品質審查
slug: management slug: management
schema: agentcompanies/v1 schema: agentcompanies/v1
manager: ../agents/ceo/AGENTS.md manager: ../agents/ceo/AGENTS.md
@@ -86,7 +92,7 @@ manager: ../agents/ceo/AGENTS.md
```yaml ```yaml
# teams/quant-research/TEAM.md # teams/quant-research/TEAM.md
name: 量化研究團隊 name: 量化研究團隊
description: 量化研究 pipeline：情報 → 結構 → 多空 → 策略 → 回測 → 分析 description: 量化研究 pipeline：情報蒐集 → 市場結構分析 → 多空辯論 → 策略收斂 → 回測驗證 → 數據分析
slug: quant-research slug: quant-research
schema: agentcompanies/v1 schema: agentcompanies/v1
manager: ../agents/quant-strategist/AGENTS.md manager: ../agents/quant-strategist/AGENTS.md
@@ -99,7 +105,7 @@ manager: ../agents/quant-strategist/AGENTS.md
```yaml ```yaml
# teams/marketing/TEAM.md # teams/marketing/TEAM.md
name: 行銷策略團隊 name: 行銷策略團隊
description: 市場研究、品牌策略、投放成效追蹤 description: 競品與市場研究、品牌與成長策略制定、廣告投放成效追蹤
slug: marketing slug: marketing
schema: agentcompanies/v1 schema: agentcompanies/v1
manager: ../agents/strategy-director/AGENTS.md manager: ../agents/strategy-director/AGENTS.md
@@ -112,7 +118,7 @@ manager: ../agents/strategy-director/AGENTS.md
```yaml ```yaml
# teams/content/TEAM.md # teams/content/TEAM.md
name: 內容創意團隊 name: 內容創意團隊
description: 文案撰寫與創意方向 description: 廣告文案撰寫、影片腳本、平面素材 brief、影片分鏡 brief
slug: content slug: content
schema: agentcompanies/v1 schema: agentcompanies/v1
manager: ../agents/creative-director/AGENTS.md manager: ../agents/creative-director/AGENTS.md
@@ -120,6 +126,19 @@ manager: ../agents/creative-director/AGENTS.md
成員：copywriter 成員：copywriter
### engineering
```yaml
# teams/engineering/TEAM.md
name: 工程團隊
description: 前端介面開發、後端 API 與資料庫開發，依需求啟用
slug: engineering
schema: agentcompanies/v1
manager: ../agents/ceo/AGENTS.md
```
成員：frontend-engineer, backend-engineer
--- ---
## 4. Agent 定義 ## 4. Agent 定義
@@ -136,11 +155,14 @@ skills: []
role: manager role: manager
``` ```
- **Mission**：接收董事長指令，拆解任務，分派給 sub-agent，追蹤進度，收斂結果 | 項目 | 內容 |
- **Scope**：派工、溝通、讀取所有 agent 產出、發起審批流程、組裝決策包 |---|---|
- **Forbidden**：不直接寫文案 / 程式 / 部署 / 做研究 | **Mission** | 接收董事長指令，拆解任務，分派給各團隊 lead，追蹤進度，收斂結果，回報董事長 |
- **輸出**：`Task_Spec.json`, `Final_Decision_Packet.json` | **Scope** | 派工給各團隊 lead、讀取所有 agent 產出、發起審批流程、組裝決策包、管理多 pipeline 並行、處理 escalation |
- **Model Tier**：reasoning-heavy | **Forbidden** | 不直接寫文案、不寫程式、不做部署、不做研究、不直接微管理研究員（交給各 team lead） |
| **輸出** | `Task_Spec.json`, `Final_Decision_Packet.json` |
| **Model Tier** | reasoning-heavy |
| **Escalation** | 高風險動作 → 通知董事長審批 |
#### secretary #### secretary
@@ -152,11 +174,14 @@ skills: []
role: general role: general
``` ```
- **Mission**：記錄摘要、維護記憶、產出 State Diff、維護 Todo | 項目 | 內容 |
- **Scope**：讀寫所有 agent 的記憶、產出摘要 |---|---|
- **Forbidden**：不做策略決策、不分派任務 | **Mission** | 記錄所有重要決策與會議摘要、維護長期記憶、產出每日狀態差異報告、維護待辦清單 |
- **輸出**：`Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` | **Scope** | 讀寫所有 agent 的記憶、跨 agent 記憶搜尋、產出每日/每週摘要、追蹤待辦進度 |
- **Model Tier**：general | **Forbidden** | 不做策略決策、不分派任務、不修改其他 agent 的產出 |
| **輸出** | `Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` |
| **Model Tier** | general |
| **Escalation** | 記憶衝突或資料異常 → 上報 CEO |
#### reviewer #### reviewer
@@ -168,11 +193,14 @@ skills: []
role: general role: general
``` ```
- **Mission**：審查產出品質，判定 pass / revise / block | 項目 | 內容 |
- **Scope**：唯讀所有 agent 輸出、提出修改建議、風險攔截 |---|---|
- **Forbidden**：不重寫內容、不拍板決策 | **Mission** | 審查所有重要產出的品質，判定 pass（通過）/ revise（退回修改）/ block（否決） |
- **輸出**：`Review_Report.json` | **Scope** | 唯讀所有 agent 輸出、依審查標準評分、提出具體修改建議、識別風險並攔截 |
- **Model Tier**：reasoning-heavy | **Forbidden** | 不重寫內容、不拍板最終決策、不直接與研究員溝通（透過 team lead） |
| **輸出** | `Review_Report.json` |
| **Model Tier** | reasoning-heavy |
| **Escalation** | block → 通知 CEO → CEO 通知董事長 |
--- ---
@@ -188,11 +216,14 @@ skills: []
role: manager role: manager
``` ```
- **Mission**：收斂多空觀點成策略規則 + 風控框架 + bias check，主導量化 pipeline | 項目 | 內容 |
- **Scope**：收斂研究結果、spawn 研究員、管理研究品質 |---|---|
- **Forbidden**：不寫正式程式碼、不做資料蒐集 | **Mission** | 主導量化 pipeline：指派研究員、收斂多空觀點、形成交易策略、管理風控框架、進行 bias check |
- **輸出**：`Strategy_Thesis.json` | **Scope** | 指派量化團隊成員、收斂研究結果、產出策略論文、提交審查、管理 revise 流程 |
- **Model Tier**：reasoning-heavy | **Forbidden** | 不寫正式程式碼（交給回測工程師）、不做資料蒐集（交給研究員）、不做最終交易決策（交給董事長） |
| **輸出** | `Strategy_Thesis.json` |
| **Model Tier** | reasoning-heavy |
| **Escalation** | 審查 block 或 revise 超過 3 輪 → 上報 CEO |
#### finance-researcher #### finance-researcher
@@ -204,10 +235,13 @@ skills: [deep-research]
role: general role: general
``` ```
- **Mission**：蒐集財經、總經、盤前盤後資訊 | 項目 | 內容 |
- **Forbidden**：不下交易結論 |---|---|
- **輸出**：`Finance_Research_Brief.json` | **Mission** | 蒐集財經新聞、總體經濟數據、盤前/盤後資訊、重大事件，並整理成結構化情報摘要 |
- **Model Tier**：research | **Scope** | 網路搜尋財經資訊、整理多來源數據、評估事件對市場的影響方向、計算市場情緒分數 |
| **Forbidden** | 不下交易結論、不做策略建議、不評價其他研究員的觀點 |
| **輸出** | `Finance_Research_Brief.json` |
| **Model Tier** | research |
#### market-structure-researcher #### market-structure-researcher
@@ -219,10 +253,13 @@ skills: [deep-research]
role: general role: general
``` ```
- **Mission**：解析流動性、MSS、OB、FVG、POI | 項目 | 內容 |
- **Forbidden**：不下最終交易結論 |---|---|
- **輸出**：`Market_Structure_Report.json` | **Mission** | 分析市場技術結構：流動性分布、Market Structure Shift（MSS）、Order Block（OB）、Fair Value Gap（FVG）、Point of Interest（POI） |
- **Model Tier**：reasoning-heavy | **Scope** | 多時間框架結構分析、關鍵價位標記、流動性區域識別、趨勢方向判定 |
| **Forbidden** | 不下最終交易結論、不做倉位建議 |
| **輸出** | `Market_Structure_Report.json` |
| **Model Tier** | reasoning-heavy |
#### bullish-researcher #### bullish-researcher
@@ -234,10 +271,13 @@ skills: []
role: general role: general
``` ```
- **Mission**：整理支持做多的論點 | 項目 | 內容 |
- **Forbidden**：不直接拍板、不做空方論述 |---|---|
- **輸出**：`Bullish_Brief.json` | **Mission** | 基於情報與市場結構，整理所有支持做多的論點，附帶證據與信心度 |
- **Model Tier**：reasoning-heavy | **Scope** | 分析利多因素、標記支撐位與催化劑、評估論點失效條件、給出整體做多信心度 |
| **Forbidden** | 不直接拍板交易、不做空方論述、不評價空方觀點 |
| **輸出** | `Bullish_Brief.json` |
| **Model Tier** | reasoning-heavy |
#### bearish-researcher #### bearish-researcher
@@ -249,10 +289,13 @@ skills: []
role: general role: general
``` ```
- **Mission**：整理反對交易的論點 | 項目 | 內容 |
- **Forbidden**：不直接拍板、不做多方論述 |---|---|
- **輸出**：`Bearish_Brief.json` | **Mission** | 基於情報與市場結構，整理所有反對做多（或支持做空）的論點，附帶證據與信心度 |
- **Model Tier**：reasoning-heavy | **Scope** | 分析利空因素、標記壓力位與風險事件、評估論點失效條件、給出整體做空信心度 |
| **Forbidden** | 不直接拍板交易、不做多方論述、不評價多方觀點 |
| **輸出** | `Bearish_Brief.json` |
| **Model Tier** | reasoning-heavy |
#### quant-engineer #### quant-engineer
@@ -264,10 +307,13 @@ skills: [code-reviewer]
role: engineer role: engineer
``` ```
- **Mission**：將策略規則轉成 Pine Script / Python 回測 | 項目 | 內容 |
- **Forbidden**：不自行更改策略方向 |---|---|
- **輸出**：`Backtest_Report.json` | **Mission** | 將策略師產出的策略規則轉成可執行的 Pine Script 或 Python 回測程式，運行回測並提交結果 |
- **Model Tier**：coder | **Scope** | 撰寫策略程式碼、設定回測參數、執行回測、產出績效報告、管理程式碼版本 |
| **Forbidden** | 不自行更改策略方向或參數（必須依照策略師的 spec）、不做策略判斷 |
| **輸出** | `Backtest_Report.json` |
| **Model Tier** | coder |
#### data-analyst #### data-analyst
@@ -279,10 +325,13 @@ skills: [deep-research]
role: general role: general
``` ```
- **Mission**：分析回測結果，計算 KPI，提供洞察 | 項目 | 內容 |
- **Forbidden**：不自行定策略方向 |---|---|
- **輸出**：`Data_Analysis_Report.json` | **Mission** | 分析回測結果與歷史交易數據，計算績效 KPI，識別模式與異常，提供數據洞察與建議 |
- **Model Tier**：general | **Scope** | 計算勝率/盈虧比/Sharpe 等指標、視覺化分析、識別 overfitting 風險、產出 proceed/adjust/reject 建議 |
| **Forbidden** | 不自行定策略方向、不修改回測程式碼 |
| **輸出** | `Data_Analysis_Report.json` |
| **Model Tier** | general |
--- ---
@@ -298,10 +347,13 @@ skills: []
role: manager role: manager
``` ```
- **Mission**：定義 USP、品牌敘事、campaign、漏斗策略 | 項目 | 內容 |
- **Forbidden**：不直接寫最終文案 |---|---|
- **輸出**：`Brand_Strategy_Plan.json`, `Growth_Strategy_Plan.json` | **Mission** | 制定品牌策略、USP 定位、成長漏斗策略、Campaign 規劃，指導行銷團隊執行方向 |
- **Model Tier**：reasoning-heavy | **Scope** | 定義品牌敘事與差異化、規劃行銷活動、設定 KPI 目標、審核行銷產出 |
| **Forbidden** | 不直接寫最終文案（交給內容團隊）、不做投放操作 |
| **輸出** | `Brand_Strategy_Plan.json`, `Growth_Strategy_Plan.json` |
| **Model Tier** | reasoning-heavy |
#### market-researcher #### market-researcher
@@ -313,9 +365,13 @@ skills: [deep-research]
role: general role: general
``` ```
- **Mission**：蒐集競品、消費者痛點、平台趨勢並分析 | 項目 | 內容 |
- **輸出**：`Market_Research_Brief.json`, `Market_Analysis_Report.json` |---|---|
- **Model Tier**：research | **Mission** | 蒐集競品動態、消費者痛點、平台趨勢、市場機會，產出結構化研究報告 |
| **Scope** | 競品分析、消費者行為研究、產業趨勢追蹤、SWOT 分析、市場規模評估 |
| **Forbidden** | 不做品牌策略決策（交給策略總監） |
| **輸出** | `Market_Research_Brief.json`, `Market_Analysis_Report.json` |
| **Model Tier** | research |
#### ads-analyst #### ads-analyst
@@ -327,9 +383,13 @@ skills: []
role: general role: general
``` ```
- **Mission**：分析 CTR / CVR / CPL / ROAS，提出優化建議 | 項目 | 內容 |
- **輸出**：`Ads_Performance_Report.json` |---|---|
- **Model Tier**：general | **Mission** | 追蹤廣告投放成效，分析 CTR/CVR/CPL/ROAS 等指標，提出優化建議 |
| **Scope** | 各平台投放數據整理、素材成效排名、A/B 測試分析、預算分配建議 |
| **Forbidden** | 不自行調整投放設定（需經策略總監核准） |
| **輸出** | `Ads_Performance_Report.json` |
| **Model Tier** | general |
--- ---
@@ -345,9 +405,13 @@ skills: []
role: manager role: manager
``` ```
- **Mission**：平面素材 brief + 影片分鏡 brief | 項目 | 內容 |
- **輸出**：`Creative_Brief.json`, `Storyboard_Brief.json` |---|---|
- **Model Tier**：creative | **Mission** | 制定視覺方向、平面素材 brief、影片分鏡 brief，確保品牌視覺一致性 |
| **Scope** | 創意方向定調、素材 brief 撰寫、分鏡規劃、品牌視覺規範維護 |
| **Forbidden** | 不寫正式文案（交給文案撰寫員）、不做品牌策略決策（交給策略總監） |
| **輸出** | `Creative_Brief.json`, `Storyboard_Brief.json` |
| **Model Tier** | creative |
#### copywriter #### copywriter
@@ -359,13 +423,57 @@ skills: [seo-blog-writer]
role: general role: general
``` ```
- **Mission**：廣告文案 + 影片腳本 | 項目 | 內容 |
- **輸出**：`Copywriting_Pack.json`, `Video_Script_Pack.json` |---|---|
- **Model Tier**：creative | **Mission** | 依據品牌策略與創意 brief，撰寫廣告文案、社群貼文、影片腳本、SEO 文章 |
| **Scope** | 廣告標題與文案、社群內容、影片旁白腳本、Landing page 文案、部落格文章 |
| **Forbidden** | 不自行定調品牌語氣（依照品牌規範）、不做視覺設計 |
| **輸出** | `Copywriting_Pack.json`, `Video_Script_Pack.json` |
| **Model Tier** | creative |
--- ---
### 4.5 閒聊 ### 4.5 工程團隊
#### frontend-engineer
```yaml
name: 前端工程師
title: Frontend Engineer
reportsTo: ceo
skills: [code-reviewer]
role: engineer
```
| 項目 | 內容 |
|---|---|
| **Mission** | 前端介面開發、UI/UX 實作、元件建置、效能優化 |
| **Scope** | 頁面開發、元件庫維護、RWD 適配、前端測試、與後端 API 串接 |
| **Forbidden** | 不自行更改產品需求（依照 CEO 或設計 spec）、不直接修改後端邏輯 |
| **輸出** | 程式碼交付（PR） |
| **Model Tier** | coder |
#### backend-engineer
```yaml
name: 後端工程師
title: Backend Engineer
reportsTo: ceo
skills: [code-reviewer]
role: engineer
```
| 項目 | 內容 |
|---|---|
| **Mission** | 後端 API 開發、資料庫設計與維護、系統架構、效能與安全 |
| **Scope** | API 端點開發、DB schema 設計、資料遷移、系統監控、第三方服務串接 |
| **Forbidden** | 不自行更改 DB schema 到 production（需 HITL 審批）、不自行更改產品需求 |
| **輸出** | 程式碼交付（PR） |
| **Model Tier** | coder |
---
### 4.6 閒聊
#### xiao-an #### xiao-an
@@ -377,8 +485,12 @@ skills: []
role: general role: general
``` ```
- **Mission**：閒聊放鬆 | 項目 | 內容 |
- **Model Tier**：general |---|---|
| **Mission** | 閒聊放鬆、日常陪伴、輕鬆話題 |
| **Scope** | 自由對話、生活話題、心情陪伴 |
| **Forbidden** | 不做工作決策、不處理正式任務 |
| **Model Tier** | general |
--- ---
@@ -389,8 +501,8 @@ role: general
```yaml ```yaml
# skills/deep-research/SKILL.md # skills/deep-research/SKILL.md
name: Deep Research name: Deep Research
description: 深度網路搜尋與資料整理，支援多來源交叉驗證 description: 深度網路搜尋與資料整理，支援多來源交叉驗證、事實查核、資料摘要
allowed-tools: [web_search, browser] allowed-tools: [web_search, browser, web_fetch]
``` ```
使用者：finance-researcher, market-structure-researcher, data-analyst, market-researcher 使用者：finance-researcher, market-structure-researcher, data-analyst, market-researcher
@@ -400,31 +512,155 @@ allowed-tools: [web_search, browser]
```yaml ```yaml
# skills/code-reviewer/SKILL.md # skills/code-reviewer/SKILL.md
name: Code Reviewer name: Code Reviewer
description: 程式碼品質審查、回測腳本驗證 description: 程式碼品質審查、回測腳本驗證、程式碼執行與檔案操作
allowed-tools: [code_execution, file_ops] allowed-tools: [code_execution, file_ops, exec]
``` ```
使用者：quant-engineer 使用者：quant-engineer, frontend-engineer, backend-engineer
### seo-blog-writer ### seo-blog-writer
```yaml ```yaml
# skills/seo-blog-writer/SKILL.md # skills/seo-blog-writer/SKILL.md
name: SEO Blog Writer name: SEO Blog Writer
description: SEO 優化的部落格文章撰寫 description: SEO 關鍵字研究與優化、部落格文章結構規劃、meta 標籤撰寫
allowed-tools: [] allowed-tools: [web_search]
``` ```
使用者：copywriter 使用者：copywriter
--- ---
## 6. Package 目錄結構 ## 6. .paperclip.yaml 設定概要
```yaml
schema: paperclip/v1
agents:
ceo:
adapter:
type: claude_local
config:
model: claude-opus-4-6
permissions:
canCreateAgents: true
secretary:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
reviewer:
adapter:
type: claude_local
config:
model: claude-opus-4-6
quant-strategist:
adapter:
type: claude_local
config:
model: claude-opus-4-6
permissions:
canCreateAgents: true
finance-researcher:
adapter:
type: claude_local
config:
model: claude-haiku-4-5
market-structure-researcher:
adapter:
type: claude_local
config:
model: claude-opus-4-6
bullish-researcher:
adapter:
type: claude_local
config:
model: claude-opus-4-6
bearish-researcher:
adapter:
type: claude_local
config:
model: claude-opus-4-6
quant-engineer:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
data-analyst:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
strategy-director:
adapter:
type: claude_local
config:
model: claude-opus-4-6
market-researcher:
adapter:
type: claude_local
config:
model: claude-haiku-4-5
ads-analyst:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
creative-director:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
copywriter:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
frontend-engineer:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
backend-engineer:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
xiao-an:
adapter:
type: claude_local
config:
model: claude-sonnet-4-6
# routines 定義見 pipelines.md
```
---
## 7. Package 目錄結構
``` ```
kingclawarmy/ kingclawarmy/
├── COMPANY.md ├── COMPANY.md
├── .paperclip.yaml ├── .paperclip.yaml
│
├── agents/ ├── agents/
│ ├── ceo/AGENTS.md │ ├── ceo/AGENTS.md
│ ├── secretary/AGENTS.md │ ├── secretary/AGENTS.md
@@ -441,25 +677,30 @@ kingclawarmy/
│ ├── ads-analyst/AGENTS.md │ ├── ads-analyst/AGENTS.md
│ ├── creative-director/AGENTS.md │ ├── creative-director/AGENTS.md
│ ├── copywriter/AGENTS.md │ ├── copywriter/AGENTS.md
│ ├── frontend-engineer/AGENTS.md
│ ├── backend-engineer/AGENTS.md
│ └── xiao-an/AGENTS.md │ └── xiao-an/AGENTS.md
│
├── teams/ ├── teams/
│ ├── management/TEAM.md │ ├── management/TEAM.md
│ ├── quant-research/TEAM.md │ ├── quant-research/TEAM.md
│ ├── marketing/TEAM.md │ ├── marketing/TEAM.md
│ └── content/TEAM.md │ ├── content/TEAM.md
│ └── engineering/TEAM.md
│
├── skills/ ├── skills/
│ ├── deep-research/SKILL.md │ ├── deep-research/SKILL.md
│ ├── code-reviewer/SKILL.md │ ├── code-reviewer/SKILL.md
│ └── seo-blog-writer/SKILL.md │ └── seo-blog-writer/SKILL.md
│
└── projects/ └── projects/
├── daily-quant-pipeline/PROJECT.md ├── daily-quant-pipeline/PROJECT.md
├── market-intel/PROJECT.md └── market-intel/PROJECT.md
└── ads-tracking/PROJECT.md
``` ```
--- ---
## 7. 共用行為規範 ## 8. 共用行為規範
所有 agent 的 AGENTS.md 結尾附加： 所有 agent 的 AGENTS.md 結尾附加：
@@ -467,20 +708,23 @@ kingclawarmy/
## 行為規範 ## 行為規範
- 只在你的職權範圍內行動 - 只在你的職權範圍內行動
- 缺少必要資訊時，回傳 missing_fields 清單 - 缺少必要資訊時，回傳 missing_fields 清單而非空值或猜測
- 遇到衝突、不確定、高風險時，上報而非猜測 - 遇到衝突、不確定、高風險時，上報而非猜測
- 輸出必須遵循指定的 JSON schema - 輸出必須遵循指定的 JSON schema
- 不在 JSON 之外添加額外說明 - 不在 JSON 之外添加額外說明
- 所有分析須附上資料來源
- 涉及金額、交易、對外發布時，必須標記需要 HITL 審批
``` ```
--- ---
## 8. 待確認事項 ## 9. 待確認事項
| 項目 | 問題 | 影響 | | 項目 | 問題 | 影響 |
|---|---|---| |---|---|---|
| Discord 整合 | Paperclip adapter 是否支援 Discord？或需要 http/process adapter 串接？ | .paperclip.yaml adapter 設定 | | Discord 整合 | Paperclip adapter 是否支援 Discord？或需要 http/process adapter 串接？ | .paperclip.yaml adapter 設定 |
| Pipeline 表達 | project/task 能否表達 sequential + parallel 依賴？ | 量化 pipeline 設計 | | Pipeline 表達 | project/task 能否表達 sequential + parallel 依賴？ | 量化 pipeline 設計 |
| 審批機制 | approval request 能否對接 Discord 通知？ | HITL 流程 | | 審批機制 | approval request 能否對接 Discord 通知？ | HITL 流程 |
| 模型設定 | adapter 支援哪些 model provider？ | adapter type 選擇 | | 模型切換 | 同一 agent 能否在不同任務中使用不同模型？ | 成本優化 |
| 跨 agent 記憶 | 是否有跨 agent 記憶搜尋功能？ | 秘書和策略師的運作方式 | | 跨 agent 記憶 | 是否有跨 agent 記憶搜尋功能？ | 秘書和策略師的運作方式 |
| 工程團隊啟用 | 前後端工程師初期是否先 paused？ | 初始 import 時的 agent status |

178
docs/pipelines.md
View File

@@ -23,13 +23,16 @@ CEO → 量化策略師（pipeline owner）
│ └─ Bullish_Brief.json / Bearish_Brief.json │ └─ Bullish_Brief.json / Bearish_Brief.json
│ │
├─ 策略師收斂 ├─ 策略師收斂
│ └─ Strategy_Thesis.json │ └─ Strategy_Thesis.json（含信心指數、恐慌指數、進出場建議）
│ │
├─ 審查員 ├─ 審查員
│ ├─ pass → 繼續 │ ├─ pass → 繼續
│ ├─ revise → 重跑被退回角色（最多 3 輪） │ ├─ revise → 重跑被退回角色（最多 3 輪）
│ └─ block → escalate CEO │ └─ block → escalate CEO
│ │
├─ 回測工程師（策略需要回測時）
│ └─ Backtest_Report.json
│
├─ 資料分析師（審查 pass 後） ├─ 資料分析師（審查 pass 後）
│ └─ Data_Analysis_Report.json │ └─ Data_Analysis_Report.json
│ │
@@ -38,26 +41,28 @@ CEO → 量化策略師（pipeline owner）
### Pipeline 步驟定義 ### Pipeline 步驟定義
| Step | Agent | 依賴 | 輸出 | | Step | Agent | 職稱 | 依賴 | 輸出 |
|---|---|---|---| |---|---|---|---|---|
| intel | finance-researcher | — | Finance_Research_Brief.json | | intel | finance-researcher | 財經情報研究員 | — | Finance_Research_Brief.json |
| structure | market-structure-researcher | intel | Market_Structure_Report.json | | structure | market-structure-researcher | 市場結構研究員 | intel | Market_Structure_Report.json |
| bull | bullish-researcher | structure | Bullish_Brief.json | | bull | bullish-researcher | 多方研究員 | structure | Bullish_Brief.json |
| bear | bearish-researcher | structure | Bearish_Brief.json | | bear | bearish-researcher | 空方研究員 | structure | Bearish_Brief.json |
| converge | quant-strategist | bull, bear | Strategy_Thesis.json | | converge | quant-strategist | 量化策略師 | bull, bear | Strategy_Thesis.json |
| review | reviewer | converge | Review_Report.json | | review | reviewer | 審查員 | converge | Review_Report.json |
| analysis | data-analyst | review (pass) | Data_Analysis_Report.json | | backtest | quant-engineer | 回測工程師 | review (pass, if requires_backtest) | Backtest_Report.json |
| approve | HITL (董事長) | analysis | — | | analysis | data-analyst | 資料分析師 | backtest or review (pass) | Data_Analysis_Report.json |
| approve | HITL (董事長) | — | analysis | — |
### 例外處理 ### 例外處理
| 情況 | 處理方式 | | 情況 | 處理方式 |
|---|---| |---|---|
| revise（審查退回） | 重新指派被退回的 agent，帶上修改意見，最多 3 輪 | | revise（審查退回） | 策略師重新指派被退回的 agent，帶上修改意見與 Review_Report，最多 3 輪 |
| block（審查否決） | escalate 到 CEO，CEO 通知董事長 | | block（審查否決） | 策略師 escalate 到 CEO，CEO 通知董事長 |
| revise 超過 3 輪 | escalate 到 CEO，CEO 通知董事長 | | revise 超過 3 輪 | 策略師 escalate 到 CEO，CEO 通知董事長 |
| agent 執行超時 | 重新指派，帶上 timeout 通知 | | agent 執行超時 | 策略師重新指派，帶上 timeout 通知 |
| agent 回傳 missing_fields | 重新指派，明確要求補齊 | | agent 回傳 missing_fields | 策略師重新指派，明確要求補齊 |
| 模型 API 錯誤 | 自動重試 1 次，失敗 → 策略師 escalate CEO |
--- ---
@@ -75,7 +80,7 @@ routines:
cronExpression: "30 7 * * 1-5" cronExpression: "30 7 * * 1-5"
timezone: Asia/Taipei timezone: Asia/Taipei
enabled: true enabled: true
# CEO 啟動量化 pipeline # CEO 啟動量化 pipeline（台股 09:00 開盤前）
daily-post-market: daily-post-market:
triggers: triggers:
@@ -83,60 +88,89 @@ routines:
cronExpression: "30 18 * * 1-5" cronExpression: "30 18 * * 1-5"
timezone: Asia/Taipei timezone: Asia/Taipei
enabled: true enabled: true
# CEO spawn 財經情報研究員做盤後整理 # CEO 啟動盤後情報整理
daily-market-intel: morning-market-intel:
triggers: triggers:
- kind: schedule - kind: schedule
cronExpression: "0 10 * * *" cronExpression: "0 8 * * *"
timezone: Asia/Taipei timezone: Asia/Taipei
enabled: true enabled: true
# 市場研究員每日市場情報 # 市場研究員早盤市場情報（台股開盤前）
weekly-market-report: evening-market-intel:
triggers:
- kind: schedule
cronExpression: "0 9 * * 1"
timezone: Asia/Taipei
enabled: true
# 市場研究員每週市場分析報告
daily-ads-check:
triggers:
- kind: schedule
cronExpression: "30 9 * * *"
timezone: Asia/Taipei
enabled: true
# 投放分析師每日 KPI 檢查
daily-data-summary:
triggers: triggers:
- kind: schedule - kind: schedule
cronExpression: "0 20 * * *" cronExpression: "0 20 * * *"
timezone: Asia/Taipei timezone: Asia/Taipei
enabled: true enabled: true
# 資料分析師每日資料摘要 # 市場研究員晚間市場情報（美股開盤前）
weekly-market-report:
triggers:
- kind: schedule
cronExpression: "0 10 * * 0"
timezone: Asia/Taipei
enabled: true
# 市場研究員每週市場分析報告（週日）
daily-data-summary:
triggers:
- kind: schedule
cronExpression: "0 21 * * 1-5"
timezone: Asia/Taipei
enabled: true
# 資料分析師每日資料摘要（收盤後）
weekly-data-report: weekly-data-report:
triggers: triggers:
- kind: schedule - kind: schedule
cronExpression: "0 10 * * 1" cronExpression: "0 14 * * 0"
timezone: Asia/Taipei timezone: Asia/Taipei
enabled: true enabled: true
# 資料分析師每週數據報告 # 資料分析師每週數據報告（週日下午）
daily-secretary-digest:
triggers:
- kind: schedule
cronExpression: "0 23 * * *"
timezone: Asia/Taipei
enabled: true
# 秘書每日記憶壓縮與狀態摘要
``` ```
### 排程對應 Agent ### 排程總覽
| Routine | Agent | 頻率 | 說明 | | Routine | Agent | 職稱 | 頻率 | 說明 |
|---|---|---|---| |---|---|---|---|---|
| daily-quant-pipeline | ceo | 週一至五 07:30 | 盤前啟動量化 pipeline | | daily-quant-pipeline | ceo | 執行長 | 週一至五 07:30 | 盤前啟動量化 pipeline |
| daily-post-market | ceo | 週一至五 18:30 | 盤後情報整理 | | daily-post-market | ceo | 執行長 | 週一至五 18:30 | 盤後情報整理 |
| daily-market-intel | market-researcher | 每日 10:00 | 每日市場情報 | | morning-market-intel | market-researcher | 市場研究員 | 每日 08:00 | 早盤市場情報（台股開盤前） |
| weekly-market-report | market-researcher | 每週一 09:00 | 每週市場分析 | | evening-market-intel | market-researcher | 市場研究員 | 每日 20:00 | 晚間市場情報（美股開盤前） |
| daily-ads-check | ads-analyst | 每日 09:30 | 投放 KPI 檢查 | | weekly-market-report | market-researcher | 市場研究員 | 每週日 10:00 | 每週市場分析報告 |
| daily-data-summary | data-analyst | 每日 20:00 | 每日資料摘要 | | daily-data-summary | data-analyst | 資料分析師 | 週一至五 21:00 | 每日資料摘要 |
| weekly-data-report | data-analyst | 每週一 10:00 | 每週數據報告 | | weekly-data-report | data-analyst | 資料分析師 | 每週日 14:00 | 每週數據報告 |
| daily-secretary-digest | secretary | 秘書 | 每日 23:00 | 每日記憶壓縮與狀態摘要 |
### 每日時間軸
```
07:30 CEO 啟動量化 pipeline
08:00 市場研究員 - 早盤市場情報（台股 09:00 開盤前）
～ 量化 pipeline 運行中 ～
18:30 CEO 啟動盤後情報整理
20:00 市場研究員 - 晚間市場情報（美股 21:30 開盤前）
21:00 資料分析師 - 每日資料摘要
23:00 秘書 - 每日記憶壓縮
```
### 每週時間軸
```
週日 10:00 市場研究員 - 每週市場分析報告
週日 14:00 資料分析師 - 每週數據報告
週一～五 每日排程如上
```
--- ---
@@ -144,22 +178,22 @@ routines:
以下動作需要董事長批准： 以下動作需要董事長批准：
| 需要審批的事 | 觸發者 | | 需要審批的事 | 觸發者 | 說明 |
|---|---| |---|---|---|
| 量化策略正式執行 | CEO | | 量化策略正式執行 | CEO | pipeline 完成後提交審批 |
| 正式部署 | CEO | | 正式部署 | CEO | 程式碼部署到 production |
| DB schema 變更 | CEO | | DB schema 變更 | CEO | 資料庫結構異動 |
| 廣告正式發布 | CEO | | 廣告正式發布 | CEO | 對外廣告上線 |
| 對外訊息發送 | CEO | | 對外訊息發送 | CEO | 品牌對外溝通 |
| 金流操作 | CEO | | 金流操作 | CEO | 任何涉及金錢的操作 |
### Review Gate ### Review Gate
| 必審節點 | 觸發方式 | 審查標準 | | 必審節點 | 觸發方式 | 審查標準 |
|---|---|---| |---|---|---|
| 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 | | 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 + 信心/恐慌指數合理性 |
| 回測結果提交 | 策略師指派審查員 | 績效指標合理性 | | 回測結果提交 | 策略師指派審查員 | 績效指標合理性 + overfitting 檢查 |
| 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 | | 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 + 安全性 |
| 文案對外 | CEO 指派審查員 | 品牌一致性 + 法規合規 | | 文案對外 | CEO 指派審查員 | 品牌一致性 + 法規合規 |
--- ---
@@ -170,10 +204,10 @@ routines:
| 等級 | GPT 模型 | Claude 模型 | 適用 Agent | | 等級 | GPT 模型 | Claude 模型 | 適用 Agent |
|---|---|---|---| |---|---|---|---|
| reasoning-heavy | gpt-5.4 | claude-opus-4-6 | CEO, 審查員, 策略師, 市場結構研究員, 多方/空方研究員, 策略總監 | | reasoning-heavy | gpt-5.4 | claude-opus-4-6 | 執行長, 審查員, 量化策略師, 市場結構研究員, 多方/空方研究員, 策略總監 |
| general | gpt-5.4-mini | claude-sonnet-4-6 | 秘書, 投放分析師, 資料分析師, 小安 | | general | gpt-5.4-mini | claude-sonnet-4-6 | 秘書, 投放分析師, 資料分析師, 小安 |
| research | gpt-5.4-mini | claude-haiku-4-5 | 財經情報研究員, 市場研究員 | | research | gpt-5.4-mini | claude-haiku-4-5 | 財經情報研究員, 市場研究員 |
| coder | gpt-5.4 | claude-sonnet-4-6 | 回測工程師 | | coder | gpt-5.4 | claude-sonnet-4-6 | 回測工程師, 前端工程師, 後端工程師 |
| creative | gpt-5.4 | claude-sonnet-4-6 | 文案撰寫員, 創意總監 | | creative | gpt-5.4 | claude-sonnet-4-6 | 文案撰寫員, 創意總監 |
每個 agent 可在 `.paperclip.yaml` 中指定主要使用的模型，視任務需求切換。 每個 agent 可在 `.paperclip.yaml` 中指定主要使用的模型，視任務需求切換。
@@ -186,5 +220,17 @@ routines:
|---|---| |---|---|
| 模型分級 | 日常用 research/general，策略收斂才用 reasoning-heavy | | 模型分級 | 日常用 research/general，策略收斂才用 reasoning-heavy |
| 排程頻率合理 | 不需要的 agent 不排太密的 cron | | 排程頻率合理 | 不需要的 agent 不排太密的 cron |
| review 輪數上限 | revise 最多 3 輪，超過 escalate | | review 輪數上限 | revise 最多 3 輪，超過 escalate 人工處理 |
| 記憶壓縮 | 定期壓縮避免 context 膨脹 | | 記憶壓縮 | 秘書每日 23:00 壓縮，避免 context 膨脹 |
| 工程團隊按需啟用 | 前後端工程師平常 paused，有任務才啟動 |
---
## 6. 停損信號
| 信號 | 動作 |
|---|---|
| 月費用超預期 2 倍 | 暫停非必要 agent |
| 反覆 revise 超過 5 輪 | 人工介入調整 prompt |
| 回測 winrate > 90% | 停下檢查 overfitting |
| Agent 產出品質持續下降 | 檢查記憶 + prompt + 模型選擇 |

684
docs/schemas.md
View File

@@ -9,82 +9,175 @@
## Finance_Research_Brief.json ## Finance_Research_Brief.json
產出者：finance-researcher > 產出者：**財經情報研究員**（finance-researcher）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"market": "BTC/USDT", "market": "BTC/USDT",
"macro_summary": "...", "session": "pre_market|post_market|intraday",
"macro_summary": "總體經濟概況摘要",
"key_events": [ "key_events": [
{ "event": "...", "impact": "bullish|bearish|neutral", "source": "..." } {
"event": "事件描述",
"time": "2026-04-10T08:30:00+08:00",
"impact": "bullish|bearish|neutral",
"severity": "high|medium|low",
"source": "來源"
}
], ],
"sentiment": { "overall": "bullish|bearish|neutral", "score": 0.0 }, "sentiment": {
"data_sources": ["..."] "overall": "bullish|bearish|neutral",
"confidence_index": 0.0,
"fear_greed_index": 0.0,
"rationale": "情緒評分依據"
},
"data_sources": ["來源 1", "來源 2"]
} }
``` ```
**欄位說明：**
- `confidence_index`：市場信心指數（0-100，100 = 極度樂觀）
- `fear_greed_index`：恐慌/貪婪指數（0-100，0 = 極度恐慌，100 = 極度貪婪）
- `session`：盤前/盤後/盤中，標示這份情報的時間區段
--- ---
## Market_Structure_Report.json ## Market_Structure_Report.json
產出者：market-structure-researcher > 產出者：**市場結構研究員**（market-structure-researcher）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"market": "BTC/USDT", "market": "BTC/USDT",
"timeframes_analyzed": ["H4", "H1"], "timeframes_analyzed": ["D1", "H4", "H1"],
"structure": { "structure": {
"trend": "bullish|bearish|ranging", "trend": "bullish|bearish|ranging",
"mss_detected": true, "mss_detected": true,
"mss_details": "MSS 發生的位置與時間描述",
"key_levels": [ "key_levels": [
{ "type": "OB|FVG|POI|support|resistance", "price": 0, "timeframe": "H4", "tested": false } {
"type": "OB|FVG|POI|support|resistance",
"price": 0,
"timeframe": "H4",
"tested": false,
"notes": "補充說明"
}
] ]
}, },
"liquidity_zones": [ "liquidity_zones": [
{ "type": "buy_side|sell_side", "range": [0, 0], "significance": "high|medium|low" } {
] "type": "buy_side|sell_side",
"range": [0, 0],
"significance": "high|medium|low",
"notes": "補充說明"
}
],
"entry_exit_suggestion": {
"suggested_direction": "long|short|neutral",
"ideal_entry_zone": [0, 0],
"stop_loss_zone": [0, 0],
"take_profit_targets": [0, 0, 0],
"confidence": 0.0,
"rationale": "進出場建議依據"
}
} }
``` ```
**欄位說明：**
- `entry_exit_suggestion`：基於市場結構的進出場建議（僅供策略師參考，不作為最終決策）
- `confidence`：對進出場建議的信心度（0.0-1.0）
--- ---
## Bullish_Brief.json ## Bullish_Brief.json
產出者：bullish-researcher > 產出者：**多方研究員**（bullish-researcher）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"market": "BTC/USDT", "market": "BTC/USDT",
"thesis": "核心論點（一句話）", "thesis": "核心做多論點（一句話）",
"arguments": [ "arguments": [
{ "point": "...", "evidence": "...", "confidence": 0.0 } {
"point": "論點",
"evidence": "支持證據",
"confidence": 0.0
}
], ],
"key_levels": [ "key_levels": [
{ "type": "support|resistance", "price": 0, "timeframe": "H4", "evidence": "..." } {
"type": "support|resistance|entry|target",
"price": 0,
"timeframe": "H4",
"evidence": "為什麼這個價位重要"
}
], ],
"catalysts": ["..."], "catalysts": ["潛在催化劑 1", "潛在催化劑 2"],
"invalidation": "什麼條件下論點失效", "entry_exit_suggestion": {
"confidence": 0.0, "suggested_entry": [0, 0],
"data_sources": ["..."] "stop_loss": 0,
"take_profit": [0, 0],
"risk_reward": 0.0,
"rationale": "進出場依據"
},
"invalidation": "什麼條件下做多論點失效",
"confidence_index": 0.0,
"data_sources": ["來源 1", "來源 2"]
} }
``` ```
**欄位說明：**
- `confidence_index`：對做多論點的整體信心度（0.0-1.0）
- `entry_exit_suggestion`：多方視角的進出場建議
--- ---
## Bearish_Brief.json ## Bearish_Brief.json
產出者：bearish-researcher > 產出者：**空方研究員**（bearish-researcher）
格式同 Bullish_Brief.json，立場相反。 ```json
{
"date": "2026-04-10",
"market": "BTC/USDT",
"thesis": "核心做空論點（一句話）",
"arguments": [
{
"point": "論點",
"evidence": "支持證據",
"confidence": 0.0
}
],
"key_levels": [
{
"type": "support|resistance|entry|target",
"price": 0,
"timeframe": "H4",
"evidence": "為什麼這個價位重要"
}
],
"risk_factors": ["風險因素 1", "風險因素 2"],
"entry_exit_suggestion": {
"suggested_entry": [0, 0],
"stop_loss": 0,
"take_profit": [0, 0],
"risk_reward": 0.0,
"rationale": "進出場依據"
},
"invalidation": "什麼條件下做空論點失效",
"confidence_index": 0.0,
"data_sources": ["來源 1", "來源 2"]
}
```
--- ---
## Strategy_Thesis.json ## Strategy_Thesis.json
產出者：quant-strategist > 產出者：**量化策略師**（quant-strategist）
```json ```json
{ {
@@ -92,39 +185,77 @@
"market": "BTC/USDT", "market": "BTC/USDT",
"direction": "long|short|neutral", "direction": "long|short|neutral",
"thesis": "收斂後的策略論點", "thesis": "收斂後的策略論點",
"entry_zone": [0, 0], "market_indicators": {
"stop_loss": 0, "confidence_index": 0.0,
"take_profit": [0, 0], "fear_greed_index": 0.0,
"risk_reward": 0.0, "market_regime": "trending|ranging|volatile|calm"
"position_size_pct": 0.0, },
"risk_assessment": { "entry_plan": {
"entry_zone": [0, 0],
"entry_trigger": "觸發進場的條件描述",
"order_type": "limit|market|stop_limit"
},
"exit_plan": {
"stop_loss": 0,
"stop_loss_type": "fixed|trailing|structure_based",
"take_profit_targets": [
{ "price": 0, "portion_pct": 50, "rationale": "第一目標依據" },
{ "price": 0, "portion_pct": 50, "rationale": "第二目標依據" }
]
},
"risk_management": {
"risk_reward": 0.0,
"position_size_pct": 0.0,
"max_drawdown_pct": 0.0, "max_drawdown_pct": 0.0,
"bias_check": "confirmed|conflicting", "bias_check": "confirmed|conflicting",
"bull_confidence": 0.0, "bull_confidence": 0.0,
"bear_confidence": 0.0 "bear_confidence": 0.0
}, },
"invalidation": "...", "invalidation": "什麼條件下整個策略失效",
"requires_backtest": true "requires_backtest": true,
"urgency": "immediate|today|this_week|no_rush",
"summary": "給董事長看的一段話摘要"
} }
``` ```
**欄位說明：**
- `confidence_index`：策略師對這個策略的整體信心度（0.0-1.0，綜合多空信心）
- `fear_greed_index`：當前市場恐慌/貪婪程度（0-100）
- `market_regime`：當前市場狀態分類
- `entry_plan`：完整的進場計畫（區間、觸發條件、下單方式）
- `exit_plan`：完整的出場計畫（停損、分批止盈）
--- ---
## Review_Report.json ## Review_Report.json
產出者：reviewer > 產出者：**審查員**（reviewer）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"reviewed_artifact": "Strategy_Thesis.json", "reviewed_artifact": "Strategy_Thesis.json",
"reviewed_agent": "quant-strategist",
"verdict": "pass|revise|block", "verdict": "pass|revise|block",
"score": 0.0, "score": 0.0,
"checklist": {
"schema_complete": true,
"risk_management_valid": true,
"data_sources_verified": true,
"confidence_reasonable": true,
"no_overfitting_risk": true
},
"issues": [ "issues": [
{ "severity": "critical|major|minor", "field": "...", "description": "...", "suggestion": "..." } {
"severity": "critical|major|minor",
"field": "對應的欄位名",
"description": "問題描述",
"suggestion": "修改建議"
}
], ],
"revise_target": "quant-strategist|bullish-researcher|...", "revise_target": "quant-strategist|bullish-researcher|bearish-researcher|...",
"summary": "..." "revise_round": 1,
"summary": "審查結論摘要"
} }
``` ```
@@ -132,23 +263,41 @@
## Backtest_Report.json ## Backtest_Report.json
產出者：quant-engineer > 產出者：**回測工程師**（quant-engineer）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"strategy_ref": "Strategy_Thesis.json", "strategy_ref": "Strategy_Thesis.json",
"platform": "pine_script|python", "platform": "pine_script|python|other",
"backtest_period": {
"start": "2025-01-01",
"end": "2026-04-10",
"data_source": "資料來源"
},
"parameters": {
"initial_capital": 10000,
"commission_pct": 0.1,
"slippage_pct": 0.05
},
"results": { "results": {
"total_trades": 0, "total_trades": 0,
"winning_trades": 0,
"losing_trades": 0,
"win_rate": 0.0, "win_rate": 0.0,
"profit_factor": 0.0, "profit_factor": 0.0,
"net_profit": 0.0,
"net_profit_pct": 0.0,
"max_drawdown_pct": 0.0, "max_drawdown_pct": 0.0,
"max_drawdown_duration": "天數",
"sharpe_ratio": 0.0, "sharpe_ratio": 0.0,
"avg_rr": 0.0 "sortino_ratio": 0.0,
"avg_rr": 0.0,
"avg_holding_period": "小時/天"
}, },
"code_artifact": "...", "equity_curve_description": "權益曲線特徵描述",
"notes": "..." "code_artifact": "程式碼檔案路徑或內容",
"notes": "回測備註與注意事項"
} }
``` ```
@@ -156,11 +305,12 @@
## Data_Analysis_Report.json ## Data_Analysis_Report.json
產出者：data-analyst > 產出者：**資料分析師**（data-analyst）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"report_type": "daily|weekly|backtest_analysis",
"analyzed_artifact": "Backtest_Report.json", "analyzed_artifact": "Backtest_Report.json",
"metrics": { "metrics": {
"total_trades": 0, "total_trades": 0,
@@ -168,11 +318,26 @@
"profit_factor": 0.0, "profit_factor": 0.0,
"max_drawdown_pct": 0.0, "max_drawdown_pct": 0.0,
"sharpe_ratio": 0.0, "sharpe_ratio": 0.0,
"avg_rr": 0.0 "sortino_ratio": 0.0,
"avg_rr": 0.0,
"calmar_ratio": 0.0
}, },
"insights": ["..."], "distribution_analysis": {
"profit_distribution": "盈虧分布特徵",
"trade_duration_distribution": "持倉時間分布特徵",
"time_of_day_performance": "不同時段表現差異"
},
"risk_flags": [
{
"type": "overfitting|curve_fitting|small_sample|outlier_dependency|other",
"description": "風險描述",
"severity": "high|medium|low"
}
],
"insights": ["洞察 1", "洞察 2"],
"recommendation": "proceed|adjust|reject", "recommendation": "proceed|adjust|reject",
"summary": "..." "recommendation_rationale": "建議依據",
"summary": "分析結論摘要"
} }
``` ```
@@ -180,17 +345,59 @@
## Task_Spec.json ## Task_Spec.json
產出者：ceo > 產出者：**執行長**（ceo）
```json ```json
{ {
"task_id": "...", "task_id": "TASK-001",
"title": "...", "title": "任務標題",
"assignee": "agent-slug", "assignee": "agent-slug",
"priority": "high|medium|low", "assignee_title": "Agent 職稱",
"description": "...", "team": "team-slug",
"expected_output": "Schema 名稱", "priority": "critical|high|medium|low",
"deadline": "2026-04-10T18:00:00+08:00" "description": "詳細任務描述",
"context": "任務背景與相關資訊",
"expected_output": "預期輸出的 Schema 名稱",
"dependencies": ["前置任務 ID"],
"deadline": "2026-04-10T18:00:00+08:00",
"requires_review": true,
"requires_hitl": false
}
```
---
## Final_Decision_Packet.json
> 產出者：**執行長**（ceo）
```json
{
"date": "2026-04-10",
"pipeline": "quant|marketing|content",
"title": "決策包標題",
"summary": "給董事長的摘要（200 字內）",
"recommendation": "proceed|hold|abort",
"key_findings": [
{
"source_agent": "agent-slug",
"source_title": "Agent 職稱",
"finding": "關鍵發現"
}
],
"risk_assessment": {
"overall_risk": "high|medium|low",
"confidence_index": 0.0,
"fear_greed_index": 0.0,
"key_risks": ["風險 1", "風險 2"]
},
"action_items": [
{
"action": "需要執行的動作",
"requires_approval": true
}
],
"attached_reports": ["Strategy_Thesis.json", "Review_Report.json", "Data_Analysis_Report.json"]
} }
``` ```
@@ -198,17 +405,83 @@
## Meeting_Summary.json ## Meeting_Summary.json
產出者：secretary > 產出者：**秘書**（secretary）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"participants": ["agent-slug", "..."], "summary_type": "daily|weekly|meeting|incident",
"key_decisions": ["..."], "participants": [
"action_items": [ { "agent": "agent-slug", "title": "Agent 職稱" }
{ "assignee": "agent-slug", "task": "...", "deadline": "..." }
], ],
"notes": "..." "key_decisions": [
{
"decision": "決策內容",
"decided_by": "agent-slug",
"rationale": "決策依據"
}
],
"action_items": [
{
"assignee": "agent-slug",
"assignee_title": "Agent 職稱",
"task": "待辦內容",
"deadline": "2026-04-11",
"status": "pending|in_progress|done"
}
],
"highlights": ["今日重點 1", "今日重點 2"],
"issues": ["待解決問題 1"],
"notes": "其他備註"
}
```
---
## State_Diff.json
> 產出者：**秘書**（secretary）
```json
{
"date": "2026-04-10",
"compared_to": "2026-04-09",
"changes": [
{
"category": "strategy|personnel|schedule|system|other",
"description": "變更描述",
"changed_by": "agent-slug",
"impact": "high|medium|low"
}
],
"new_items": ["新增的事項"],
"resolved_items": ["已解決的事項"],
"ongoing_items": ["持續進行中的事項"]
}
```
---
## Todo_List.json
> 產出者：**秘書**（secretary）
```json
{
"date": "2026-04-10",
"items": [
{
"id": "TODO-001",
"title": "待辦標題",
"assignee": "agent-slug",
"assignee_title": "Agent 職稱",
"priority": "critical|high|medium|low",
"status": "pending|in_progress|blocked|done",
"created_date": "2026-04-09",
"due_date": "2026-04-11",
"notes": "備註"
}
]
} }
``` ```
@@ -216,18 +489,145 @@
## Brand_Strategy_Plan.json ## Brand_Strategy_Plan.json
產出者：strategy-director > 產出者：**策略總監**（strategy-director）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"usp": "...", "version": "1.0",
"brand_narrative": "...", "usp": "獨特賣點定義",
"target_audience": ["..."], "brand_narrative": "品牌故事與核心訊息",
"campaigns": [ "brand_voice": {
{ "name": "...", "channel": "...", "objective": "...", "kpi": "..." } "tone": "語氣描述",
"personality": "品牌人格特質",
"do": ["應該做的"],
"dont": ["不應該做的"]
},
"target_audience": [
{
"segment": "受眾分群名稱",
"demographics": "人口統計描述",
"pain_points": ["痛點"],
"motivations": ["動機"]
}
], ],
"funnel_strategy": "..." "campaigns": [
{
"name": "活動名稱",
"channel": "投放管道",
"objective": "活動目標",
"kpi": "衡量指標",
"budget_allocation_pct": 0.0
}
],
"funnel_strategy": {
"awareness": "認知階段策略",
"consideration": "考慮階段策略",
"conversion": "轉換階段策略",
"retention": "留存階段策略"
}
}
```
---
## Growth_Strategy_Plan.json
> 產出者：**策略總監**（strategy-director）
```json
{
"date": "2026-04-10",
"growth_model": "成長模型描述",
"channels": [
{
"channel": "管道名稱",
"strategy": "策略描述",
"expected_cac": 0.0,
"expected_ltv": 0.0,
"priority": "high|medium|low"
}
],
"experiments": [
{
"hypothesis": "假設",
"test_method": "測試方法",
"success_metric": "成功指標",
"duration": "測試期間"
}
],
"milestones": [
{
"target": "目標描述",
"deadline": "2026-06-30",
"status": "planned|in_progress|achieved"
}
]
}
```
---
## Market_Research_Brief.json
> 產出者：**市場研究員**（market-researcher）
```json
{
"date": "2026-04-10",
"report_type": "daily_morning|daily_evening|weekly",
"market_overview": "市場概況摘要",
"competitors": [
{
"name": "競品名稱",
"recent_moves": "近期動態",
"threat_level": "high|medium|low"
}
],
"consumer_insights": [
{
"insight": "消費者洞察",
"source": "來源",
"actionable": true
}
],
"trends": [
{
"trend": "趨勢描述",
"direction": "growing|stable|declining",
"relevance": "high|medium|low"
}
],
"opportunities": ["機會 1", "機會 2"],
"threats": ["威脅 1", "威脅 2"],
"data_sources": ["來源 1", "來源 2"]
}
```
---
## Market_Analysis_Report.json
> 產出者：**市場研究員**（market-researcher）
```json
{
"date": "2026-04-10",
"analysis_period": "2026-04-07 ~ 2026-04-10",
"market_size": {
"tam": "Total Addressable Market",
"sam": "Serviceable Addressable Market",
"som": "Serviceable Obtainable Market"
},
"swot": {
"strengths": ["優勢"],
"weaknesses": ["劣勢"],
"opportunities": ["機會"],
"threats": ["威脅"]
},
"competitive_landscape": "競爭格局分析",
"recommendations": ["建議 1", "建議 2"],
"data_sources": ["來源 1", "來源 2"]
} }
``` ```
@@ -235,20 +635,158 @@
## Ads_Performance_Report.json ## Ads_Performance_Report.json
產出者：ads-analyst > 產出者：**投放分析師**（ads-analyst）
```json ```json
{ {
"date": "2026-04-10", "date": "2026-04-10",
"platform": "...", "report_period": "2026-04-01 ~ 2026-04-10",
"metrics": { "platforms": [
"ctr": 0.0, {
"cvr": 0.0, "platform": "平台名稱",
"cpl": 0.0, "metrics": {
"roas": 0.0, "impressions": 0,
"spend": 0.0 "clicks": 0,
}, "ctr": 0.0,
"top_creatives": ["..."], "conversions": 0,
"recommendations": ["..."] "cvr": 0.0,
"cpl": 0.0,
"cpa": 0.0,
"roas": 0.0,
"spend": 0.0
}
}
],
"top_creatives": [
{
"creative_id": "素材 ID",
"description": "素材描述",
"ctr": 0.0,
"cvr": 0.0
}
],
"ab_test_results": [
{
"test_name": "測試名稱",
"winner": "A|B",
"lift_pct": 0.0,
"confidence": 0.0
}
],
"budget_utilization_pct": 0.0,
"recommendations": ["優化建議 1", "優化建議 2"]
}
```
---
## Creative_Brief.json
> 產出者：**創意總監**（creative-director）
```json
{
"date": "2026-04-10",
"project": "專案名稱",
"objective": "創意目標",
"target_audience": "目標受眾描述",
"key_message": "核心訊息",
"tone_and_mood": "語氣與氛圍",
"visual_direction": {
"style": "視覺風格",
"color_palette": ["色碼"],
"references": ["參考連結或描述"]
},
"deliverables": [
{
"type": "banner|social_post|video|landing_page",
"dimensions": "尺寸",
"quantity": 1,
"notes": "備註"
}
],
"brand_guidelines_ref": "品牌規範引用",
"deadline": "2026-04-15"
}
```
---
## Storyboard_Brief.json
> 產出者：**創意總監**（creative-director）
```json
{
"date": "2026-04-10",
"project": "專案名稱",
"video_type": "ad|explainer|testimonial|brand",
"duration_seconds": 30,
"scenes": [
{
"scene_number": 1,
"duration_seconds": 5,
"visual": "畫面描述",
"audio": "音效/音樂/旁白描述",
"text_overlay": "畫面文字",
"transition": "cut|fade|slide"
}
],
"cta": "Call to Action",
"notes": "備註"
}
```
---
## Copywriting_Pack.json
> 產出者：**文案撰寫員**（copywriter）
```json
{
"date": "2026-04-10",
"project": "專案名稱",
"brand_voice_ref": "品牌語氣引用",
"pieces": [
{
"type": "headline|body|cta|social_post|email|blog|landing_page",
"platform": "投放平台",
"headline": "標題",
"body": "內文",
"cta": "Call to Action",
"seo_keywords": ["關鍵字"],
"character_count": 0,
"variations": ["變體 A", "變體 B"]
}
],
"notes": "備註"
}
```
---
## Video_Script_Pack.json
> 產出者：**文案撰寫員**（copywriter）
```json
{
"date": "2026-04-10",
"project": "專案名稱",
"video_type": "ad|explainer|testimonial|brand",
"duration_seconds": 30,
"script": [
{
"timecode": "00:00-00:05",
"speaker": "旁白|角色名",
"dialogue": "台詞/旁白內容",
"visual_cue": "對應的畫面提示",
"notes": "備註"
}
],
"cta": "Call to Action",
"tone": "語氣描述",
"notes": "備註"
} }
``` ```