From aae5913bf28e1934e1447a25d089848ffca0ac66 Mon Sep 17 00:00:00 2001 From: Chris Date: Fri, 10 Apr 2026 16:28:35 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=A8=E9=9D=A2=E8=A3=9C=E5=BC=B7?= =?UTF-8?q?=E5=85=AC=E5=8F=B8=E5=AE=9A=E7=BE=A9=E3=80=81=E6=8E=92=E7=A8=8B?= =?UTF-8?q?=E3=80=81Schema?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- docs/INDEX.md | 17 +- docs/company.md | 452 +++++++++++++++++++++++------- docs/pipelines.md | 178 +++++++----- docs/schemas.md | 684 +++++++++++++++++++++++++++++++++++++++++----- 4 files changed, 1080 insertions(+), 251 deletions(-) diff --git a/docs/INDEX.md b/docs/INDEX.md index 66ae18f..a5bc97e 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -6,9 +6,9 @@ | 文件 | 內容 | |---|---| -| [company.md](company.md) | 公司定義、組織架構、團隊與 Agent 完整規格 | -| [pipelines.md](pipelines.md) | Pipeline 流程、排程定義、審批機制 | -| [schemas.md](schemas.md) | 各 Agent 輸出的 JSON Schema 定義 | +| [company.md](company.md) | 公司定義、組織架構（18 agents / 5 teams）、Agent 完整規格、Skills、.paperclip.yaml 設定、Package 結構 | +| [pipelines.md](pipelines.md) | 量化 Pipeline 流程、排程定義（8 routines）、每日/每週時間軸、審批機制、模型分級、成本控制、停損信號 | +| [schemas.md](schemas.md) | 所有 Agent 輸出的 JSON Schema 定義（含信心指數、恐慌指數、進出場建議） | --- @@ -17,9 +17,10 @@ | 階段 | 說明 | 狀態 | |---|---|---| | Paperclip onboard | 初始化 Paperclip 環境 | 待執行 | -| 建立 Company Package | 建立目錄結構、寫入所有定義 | 待開始 | +| 建立 Company Package | 建立目錄結構、寫入所有 AGENTS.md / TEAM.md / SKILL.md | 待開始 | | 匯入 Paperclip | `paperclipai company import` | 待開始 | -| 管理團隊上線 | CEO + 秘書 + 審查員 | 待開始 | -| 量化團隊上線 | 7 agents | 待開始 | -| 行銷團隊上線 | 3 agents | 待開始 | -| 內容團隊上線 | 2 agents | 待開始 | +| 管理團隊上線 | CEO + 秘書 + 審查員（3 agents） | 待開始 | +| 量化團隊上線 | 策略師 + 6 研究/工程 agents（7 agents） | 待開始 | +| 行銷團隊上線 | 策略總監 + 市場研究員 + 投放分析師（3 agents） | 待開始 | +| 內容團隊上線 | 創意總監 + 文案撰寫員（2 agents） | 待開始 | +| 工程團隊上線 | 前端 + 後端工程師（2 agents，依需求啟用） | 待開始 | diff --git a/docs/company.md b/docs/company.md index a1d8069..bb3648b 100644 --- a/docs/company.md +++ b/docs/company.md @@ -12,12 +12,13 @@ 1. **量化研究**：情報蒐集 → 市場結構分析 → 多空辯論 → 策略形成 → 回測 → 分析 2. **行銷策略**：市場研究 → 品牌/成長策略 → 投放分析 3. **內容創作**：策略 → 文案撰寫 → 視覺方向 +4. **工程開發**：前端介面 / 後端 API（依需求啟用） ### COMPANY.md Frontmatter ```yaml name: KingClawArmy -description: AI Agent 量化研究、行銷策略與內容創作團隊 +description: AI Agent 量化研究、行銷策略、內容創作與工程開發團隊 slug: kingclawarmy schema: agentcompanies/v1 version: 1.0.0 @@ -27,6 +28,7 @@ goals: - 量化研究自動化：從情報蒐集到策略回測的完整 pipeline - 行銷策略系統化：市場研究、品牌策略、投放追蹤 - 內容創作流程化：文案與創意 brief 產出 + - 工程任務自動化：前後端開發與維護 ``` --- @@ -36,33 +38,37 @@ goals: ``` 董事長（Chris，人類） │ -├── 管理團隊 -│ ├── CEO（coordinator） -│ ├── 秘書 -│ └── 審查員 +├── 管理團隊（3 agents） +│ ├── CEO（coordinator，全局調度） +│ ├── 秘書（記錄、摘要、記憶管理） +│ └── 審查員（品質把關 pass/revise/block） │ -├── 量化研究團隊 -│ ├── 量化策略師（team lead） -│ ├── 財經情報研究員 -│ ├── 市場結構研究員 -│ ├── 多方研究員 -│ ├── 空方研究員 -│ ├── 回測工程師 -│ └── 資料分析師 +├── 量化研究團隊（7 agents） +│ ├── 量化策略師（team lead，pipeline owner） +│ ├── 財經情報研究員（蒐集總經/盤前盤後資訊） +│ ├── 市場結構研究員（流動性/技術結構分析） +│ ├── 多方研究員（做多論點整理） +│ ├── 空方研究員（做空論點整理） +│ ├── 回測工程師（策略程式化 + 回測） +│ └── 資料分析師（回測結果分析 + KPI） │ -├── 行銷策略團隊 -│ ├── 策略總監（team lead） -│ ├── 市場研究員 -│ └── 投放分析師 +├── 行銷策略團隊（3 agents） +│ ├── 策略總監（team lead，品牌/成長策略） +│ ├── 市場研究員（競品/消費者/趨勢研究） +│ └── 投放分析師（廣告成效追蹤） │ -├── 內容創意團隊 -│ ├── 創意總監（team lead） -│ └── 文案撰寫員 +├── 內容創意團隊（2 agents） +│ ├── 創意總監（team lead，視覺方向/分鏡） +│ └── 文案撰寫員（廣告文案/影片腳本） │ -└── 小安（閒聊） +├── 工程團隊（2 agents） +│ ├── 前端工程師（UI/UX 開發） +│ └── 後端工程師（API/DB 開發） +│ +└── 小安（閒聊陪伴） ``` -**總計：16 agents** +**總計：18 agents** --- @@ -73,7 +79,7 @@ goals: ```yaml # teams/management/TEAM.md name: 管理團隊 -description: 任務調度、記錄摘要、品質審查 +description: 全局任務調度、工作記錄與摘要、產出品質審查 slug: management schema: agentcompanies/v1 manager: ../agents/ceo/AGENTS.md @@ -86,7 +92,7 @@ manager: ../agents/ceo/AGENTS.md ```yaml # teams/quant-research/TEAM.md name: 量化研究團隊 -description: 量化研究 pipeline：情報 → 結構 → 多空 → 策略 → 回測 → 分析 +description: 量化研究 pipeline：情報蒐集 → 市場結構分析 → 多空辯論 → 策略收斂 → 回測驗證 → 數據分析 slug: quant-research schema: agentcompanies/v1 manager: ../agents/quant-strategist/AGENTS.md @@ -99,7 +105,7 @@ manager: ../agents/quant-strategist/AGENTS.md ```yaml # teams/marketing/TEAM.md name: 行銷策略團隊 -description: 市場研究、品牌策略、投放成效追蹤 +description: 競品與市場研究、品牌與成長策略制定、廣告投放成效追蹤 slug: marketing schema: agentcompanies/v1 manager: ../agents/strategy-director/AGENTS.md @@ -112,7 +118,7 @@ manager: ../agents/strategy-director/AGENTS.md ```yaml # teams/content/TEAM.md name: 內容創意團隊 -description: 文案撰寫與創意方向 +description: 廣告文案撰寫、影片腳本、平面素材 brief、影片分鏡 brief slug: content schema: agentcompanies/v1 manager: ../agents/creative-director/AGENTS.md @@ -120,6 +126,19 @@ manager: ../agents/creative-director/AGENTS.md 成員：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 定義 @@ -136,11 +155,14 @@ skills: [] role: manager ``` -- **Mission**：接收董事長指令，拆解任務，分派給 sub-agent，追蹤進度，收斂結果 -- **Scope**：派工、溝通、讀取所有 agent 產出、發起審批流程、組裝決策包 -- **Forbidden**：不直接寫文案 / 程式 / 部署 / 做研究 -- **輸出**：`Task_Spec.json`, `Final_Decision_Packet.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 接收董事長指令，拆解任務，分派給各團隊 lead，追蹤進度，收斂結果，回報董事長 | +| **Scope** | 派工給各團隊 lead、讀取所有 agent 產出、發起審批流程、組裝決策包、管理多 pipeline 並行、處理 escalation | +| **Forbidden** | 不直接寫文案、不寫程式、不做部署、不做研究、不直接微管理研究員（交給各 team lead） | +| **輸出** | `Task_Spec.json`, `Final_Decision_Packet.json` | +| **Model Tier** | reasoning-heavy | +| **Escalation** | 高風險動作 → 通知董事長審批 | #### secretary @@ -152,11 +174,14 @@ skills: [] role: general ``` -- **Mission**：記錄摘要、維護記憶、產出 State Diff、維護 Todo -- **Scope**：讀寫所有 agent 的記憶、產出摘要 -- **Forbidden**：不做策略決策、不分派任務 -- **輸出**：`Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` -- **Model Tier**：general +| 項目 | 內容 | +|---|---| +| **Mission** | 記錄所有重要決策與會議摘要、維護長期記憶、產出每日狀態差異報告、維護待辦清單 | +| **Scope** | 讀寫所有 agent 的記憶、跨 agent 記憶搜尋、產出每日/每週摘要、追蹤待辦進度 | +| **Forbidden** | 不做策略決策、不分派任務、不修改其他 agent 的產出 | +| **輸出** | `Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` | +| **Model Tier** | general | +| **Escalation** | 記憶衝突或資料異常 → 上報 CEO | #### reviewer @@ -168,11 +193,14 @@ skills: [] role: general ``` -- **Mission**：審查產出品質，判定 pass / revise / block -- **Scope**：唯讀所有 agent 輸出、提出修改建議、風險攔截 -- **Forbidden**：不重寫內容、不拍板決策 -- **輸出**：`Review_Report.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 審查所有重要產出的品質，判定 pass（通過）/ revise（退回修改）/ block（否決） | +| **Scope** | 唯讀所有 agent 輸出、依審查標準評分、提出具體修改建議、識別風險並攔截 | +| **Forbidden** | 不重寫內容、不拍板最終決策、不直接與研究員溝通（透過 team lead） | +| **輸出** | `Review_Report.json` | +| **Model Tier** | reasoning-heavy | +| **Escalation** | block → 通知 CEO → CEO 通知董事長 | --- @@ -188,11 +216,14 @@ skills: [] role: manager ``` -- **Mission**：收斂多空觀點成策略規則 + 風控框架 + bias check，主導量化 pipeline -- **Scope**：收斂研究結果、spawn 研究員、管理研究品質 -- **Forbidden**：不寫正式程式碼、不做資料蒐集 -- **輸出**：`Strategy_Thesis.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 主導量化 pipeline：指派研究員、收斂多空觀點、形成交易策略、管理風控框架、進行 bias check | +| **Scope** | 指派量化團隊成員、收斂研究結果、產出策略論文、提交審查、管理 revise 流程 | +| **Forbidden** | 不寫正式程式碼（交給回測工程師）、不做資料蒐集（交給研究員）、不做最終交易決策（交給董事長） | +| **輸出** | `Strategy_Thesis.json` | +| **Model Tier** | reasoning-heavy | +| **Escalation** | 審查 block 或 revise 超過 3 輪 → 上報 CEO | #### finance-researcher @@ -204,10 +235,13 @@ skills: [deep-research] role: general ``` -- **Mission**：蒐集財經、總經、盤前盤後資訊 -- **Forbidden**：不下交易結論 -- **輸出**：`Finance_Research_Brief.json` -- **Model Tier**：research +| 項目 | 內容 | +|---|---| +| **Mission** | 蒐集財經新聞、總體經濟數據、盤前/盤後資訊、重大事件，並整理成結構化情報摘要 | +| **Scope** | 網路搜尋財經資訊、整理多來源數據、評估事件對市場的影響方向、計算市場情緒分數 | +| **Forbidden** | 不下交易結論、不做策略建議、不評價其他研究員的觀點 | +| **輸出** | `Finance_Research_Brief.json` | +| **Model Tier** | research | #### market-structure-researcher @@ -219,10 +253,13 @@ skills: [deep-research] role: general ``` -- **Mission**：解析流動性、MSS、OB、FVG、POI -- **Forbidden**：不下最終交易結論 -- **輸出**：`Market_Structure_Report.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 分析市場技術結構：流動性分布、Market Structure Shift（MSS）、Order Block（OB）、Fair Value Gap（FVG）、Point of Interest（POI） | +| **Scope** | 多時間框架結構分析、關鍵價位標記、流動性區域識別、趨勢方向判定 | +| **Forbidden** | 不下最終交易結論、不做倉位建議 | +| **輸出** | `Market_Structure_Report.json` | +| **Model Tier** | reasoning-heavy | #### bullish-researcher @@ -234,10 +271,13 @@ skills: [] role: general ``` -- **Mission**：整理支持做多的論點 -- **Forbidden**：不直接拍板、不做空方論述 -- **輸出**：`Bullish_Brief.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 基於情報與市場結構，整理所有支持做多的論點，附帶證據與信心度 | +| **Scope** | 分析利多因素、標記支撐位與催化劑、評估論點失效條件、給出整體做多信心度 | +| **Forbidden** | 不直接拍板交易、不做空方論述、不評價空方觀點 | +| **輸出** | `Bullish_Brief.json` | +| **Model Tier** | reasoning-heavy | #### bearish-researcher @@ -249,10 +289,13 @@ skills: [] role: general ``` -- **Mission**：整理反對交易的論點 -- **Forbidden**：不直接拍板、不做多方論述 -- **輸出**：`Bearish_Brief.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 基於情報與市場結構，整理所有反對做多（或支持做空）的論點，附帶證據與信心度 | +| **Scope** | 分析利空因素、標記壓力位與風險事件、評估論點失效條件、給出整體做空信心度 | +| **Forbidden** | 不直接拍板交易、不做多方論述、不評價多方觀點 | +| **輸出** | `Bearish_Brief.json` | +| **Model Tier** | reasoning-heavy | #### quant-engineer @@ -264,10 +307,13 @@ skills: [code-reviewer] role: engineer ``` -- **Mission**：將策略規則轉成 Pine Script / Python 回測 -- **Forbidden**：不自行更改策略方向 -- **輸出**：`Backtest_Report.json` -- **Model Tier**：coder +| 項目 | 內容 | +|---|---| +| **Mission** | 將策略師產出的策略規則轉成可執行的 Pine Script 或 Python 回測程式，運行回測並提交結果 | +| **Scope** | 撰寫策略程式碼、設定回測參數、執行回測、產出績效報告、管理程式碼版本 | +| **Forbidden** | 不自行更改策略方向或參數（必須依照策略師的 spec）、不做策略判斷 | +| **輸出** | `Backtest_Report.json` | +| **Model Tier** | coder | #### data-analyst @@ -279,10 +325,13 @@ skills: [deep-research] role: general ``` -- **Mission**：分析回測結果，計算 KPI，提供洞察 -- **Forbidden**：不自行定策略方向 -- **輸出**：`Data_Analysis_Report.json` -- **Model Tier**：general +| 項目 | 內容 | +|---|---| +| **Mission** | 分析回測結果與歷史交易數據，計算績效 KPI，識別模式與異常，提供數據洞察與建議 | +| **Scope** | 計算勝率/盈虧比/Sharpe 等指標、視覺化分析、識別 overfitting 風險、產出 proceed/adjust/reject 建議 | +| **Forbidden** | 不自行定策略方向、不修改回測程式碼 | +| **輸出** | `Data_Analysis_Report.json` | +| **Model Tier** | general | --- @@ -298,10 +347,13 @@ skills: [] role: manager ``` -- **Mission**：定義 USP、品牌敘事、campaign、漏斗策略 -- **Forbidden**：不直接寫最終文案 -- **輸出**：`Brand_Strategy_Plan.json`, `Growth_Strategy_Plan.json` -- **Model Tier**：reasoning-heavy +| 項目 | 內容 | +|---|---| +| **Mission** | 制定品牌策略、USP 定位、成長漏斗策略、Campaign 規劃，指導行銷團隊執行方向 | +| **Scope** | 定義品牌敘事與差異化、規劃行銷活動、設定 KPI 目標、審核行銷產出 | +| **Forbidden** | 不直接寫最終文案（交給內容團隊）、不做投放操作 | +| **輸出** | `Brand_Strategy_Plan.json`, `Growth_Strategy_Plan.json` | +| **Model Tier** | reasoning-heavy | #### market-researcher @@ -313,9 +365,13 @@ skills: [deep-research] 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 @@ -327,9 +383,13 @@ skills: [] 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 ``` -- **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 @@ -359,13 +423,57 @@ skills: [seo-blog-writer] 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 @@ -377,8 +485,12 @@ skills: [] role: general ``` -- **Mission**：閒聊放鬆 -- **Model Tier**：general +| 項目 | 內容 | +|---|---| +| **Mission** | 閒聊放鬆、日常陪伴、輕鬆話題 | +| **Scope** | 自由對話、生活話題、心情陪伴 | +| **Forbidden** | 不做工作決策、不處理正式任務 | +| **Model Tier** | general | --- @@ -389,8 +501,8 @@ role: general ```yaml # skills/deep-research/SKILL.md name: Deep Research -description: 深度網路搜尋與資料整理，支援多來源交叉驗證 -allowed-tools: [web_search, browser] +description: 深度網路搜尋與資料整理，支援多來源交叉驗證、事實查核、資料摘要 +allowed-tools: [web_search, browser, web_fetch] ``` 使用者：finance-researcher, market-structure-researcher, data-analyst, market-researcher @@ -400,31 +512,155 @@ allowed-tools: [web_search, browser] ```yaml # skills/code-reviewer/SKILL.md name: Code Reviewer -description: 程式碼品質審查、回測腳本驗證 -allowed-tools: [code_execution, file_ops] +description: 程式碼品質審查、回測腳本驗證、程式碼執行與檔案操作 +allowed-tools: [code_execution, file_ops, exec] ``` -使用者：quant-engineer +使用者：quant-engineer, frontend-engineer, backend-engineer ### seo-blog-writer ```yaml # skills/seo-blog-writer/SKILL.md name: SEO Blog Writer -description: SEO 優化的部落格文章撰寫 -allowed-tools: [] +description: SEO 關鍵字研究與優化、部落格文章結構規劃、meta 標籤撰寫 +allowed-tools: [web_search] ``` 使用者：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/ ├── COMPANY.md ├── .paperclip.yaml +│ ├── agents/ │ ├── ceo/AGENTS.md │ ├── secretary/AGENTS.md @@ -441,25 +677,30 @@ kingclawarmy/ │ ├── ads-analyst/AGENTS.md │ ├── creative-director/AGENTS.md │ ├── copywriter/AGENTS.md +│ ├── frontend-engineer/AGENTS.md +│ ├── backend-engineer/AGENTS.md │ └── xiao-an/AGENTS.md +│ ├── teams/ │ ├── management/TEAM.md │ ├── quant-research/TEAM.md │ ├── marketing/TEAM.md -│ └── content/TEAM.md +│ ├── content/TEAM.md +│ └── engineering/TEAM.md +│ ├── skills/ │ ├── deep-research/SKILL.md │ ├── code-reviewer/SKILL.md │ └── seo-blog-writer/SKILL.md +│ └── projects/ ├── daily-quant-pipeline/PROJECT.md - ├── market-intel/PROJECT.md - └── ads-tracking/PROJECT.md + └── market-intel/PROJECT.md ``` --- -## 7. 共用行為規範 +## 8. 共用行為規範 所有 agent 的 AGENTS.md 結尾附加： @@ -467,20 +708,23 @@ kingclawarmy/ ## 行為規範 - 只在你的職權範圍內行動 -- 缺少必要資訊時，回傳 missing_fields 清單 +- 缺少必要資訊時，回傳 missing_fields 清單而非空值或猜測 - 遇到衝突、不確定、高風險時，上報而非猜測 - 輸出必須遵循指定的 JSON schema - 不在 JSON 之外添加額外說明 +- 所有分析須附上資料來源 +- 涉及金額、交易、對外發布時，必須標記需要 HITL 審批 ``` --- -## 8. 待確認事項 +## 9. 待確認事項 | 項目 | 問題 | 影響 | |---|---|---| | Discord 整合 | Paperclip adapter 是否支援 Discord？或需要 http/process adapter 串接？ | .paperclip.yaml adapter 設定 | | Pipeline 表達 | project/task 能否表達 sequential + parallel 依賴？ | 量化 pipeline 設計 | | 審批機制 | approval request 能否對接 Discord 通知？ | HITL 流程 | -| 模型設定 | adapter 支援哪些 model provider？ | adapter type 選擇 | +| 模型切換 | 同一 agent 能否在不同任務中使用不同模型？ | 成本優化 | | 跨 agent 記憶 | 是否有跨 agent 記憶搜尋功能？ | 秘書和策略師的運作方式 | +| 工程團隊啟用 | 前後端工程師初期是否先 paused？ | 初始 import 時的 agent status | diff --git a/docs/pipelines.md b/docs/pipelines.md index c314d82..f4e4556 100644 --- a/docs/pipelines.md +++ b/docs/pipelines.md @@ -23,13 +23,16 @@ CEO → 量化策略師（pipeline owner） │ └─ Bullish_Brief.json / Bearish_Brief.json │ ├─ 策略師收斂 - │ └─ Strategy_Thesis.json + │ └─ Strategy_Thesis.json（含信心指數、恐慌指數、進出場建議） │ ├─ 審查員 │ ├─ pass → 繼續 │ ├─ revise → 重跑被退回角色（最多 3 輪） │ └─ block → escalate CEO │ + ├─ 回測工程師（策略需要回測時） + │ └─ Backtest_Report.json + │ ├─ 資料分析師（審查 pass 後） │ └─ Data_Analysis_Report.json │ @@ -38,26 +41,28 @@ CEO → 量化策略師（pipeline owner） ### Pipeline 步驟定義 -| Step | Agent | 依賴 | 輸出 | -|---|---|---|---| -| intel | finance-researcher | — | Finance_Research_Brief.json | -| structure | market-structure-researcher | intel | Market_Structure_Report.json | -| bull | bullish-researcher | structure | Bullish_Brief.json | -| bear | bearish-researcher | structure | Bearish_Brief.json | -| converge | quant-strategist | bull, bear | Strategy_Thesis.json | -| review | reviewer | converge | Review_Report.json | -| analysis | data-analyst | review (pass) | Data_Analysis_Report.json | -| approve | HITL (董事長) | analysis | — | +| Step | Agent | 職稱 | 依賴 | 輸出 | +|---|---|---|---|---| +| intel | finance-researcher | 財經情報研究員 | — | Finance_Research_Brief.json | +| structure | market-structure-researcher | 市場結構研究員 | intel | Market_Structure_Report.json | +| bull | bullish-researcher | 多方研究員 | structure | Bullish_Brief.json | +| bear | bearish-researcher | 空方研究員 | structure | Bearish_Brief.json | +| converge | quant-strategist | 量化策略師 | bull, bear | Strategy_Thesis.json | +| review | reviewer | 審查員 | converge | Review_Report.json | +| backtest | quant-engineer | 回測工程師 | review (pass, if requires_backtest) | Backtest_Report.json | +| analysis | data-analyst | 資料分析師 | backtest or review (pass) | Data_Analysis_Report.json | +| approve | HITL (董事長) | — | analysis | — | ### 例外處理 | 情況 | 處理方式 | |---|---| -| revise（審查退回） | 重新指派被退回的 agent，帶上修改意見，最多 3 輪 | -| block（審查否決） | escalate 到 CEO，CEO 通知董事長 | -| revise 超過 3 輪 | escalate 到 CEO，CEO 通知董事長 | -| agent 執行超時 | 重新指派，帶上 timeout 通知 | -| agent 回傳 missing_fields | 重新指派，明確要求補齊 | +| revise（審查退回） | 策略師重新指派被退回的 agent，帶上修改意見與 Review_Report，最多 3 輪 | +| block（審查否決） | 策略師 escalate 到 CEO，CEO 通知董事長 | +| revise 超過 3 輪 | 策略師 escalate 到 CEO，CEO 通知董事長 | +| agent 執行超時 | 策略師重新指派，帶上 timeout 通知 | +| agent 回傳 missing_fields | 策略師重新指派，明確要求補齊 | +| 模型 API 錯誤 | 自動重試 1 次，失敗 → 策略師 escalate CEO | --- @@ -75,7 +80,7 @@ routines: cronExpression: "30 7 * * 1-5" timezone: Asia/Taipei enabled: true - # CEO 啟動量化 pipeline + # CEO 啟動量化 pipeline（台股 09:00 開盤前） daily-post-market: triggers: @@ -83,60 +88,89 @@ routines: cronExpression: "30 18 * * 1-5" timezone: Asia/Taipei enabled: true - # CEO spawn 財經情報研究員做盤後整理 + # CEO 啟動盤後情報整理 - daily-market-intel: + morning-market-intel: triggers: - kind: schedule - cronExpression: "0 10 * * *" + cronExpression: "0 8 * * *" timezone: Asia/Taipei enabled: true - # 市場研究員每日市場情報 + # 市場研究員早盤市場情報（台股開盤前） - weekly-market-report: - 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: + evening-market-intel: triggers: - kind: schedule cronExpression: "0 20 * * *" timezone: Asia/Taipei 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: triggers: - kind: schedule - cronExpression: "0 10 * * 1" + cronExpression: "0 14 * * 0" timezone: Asia/Taipei enabled: true - # 資料分析師每週數據報告 + # 資料分析師每週數據報告（週日下午） + + daily-secretary-digest: + triggers: + - kind: schedule + cronExpression: "0 23 * * *" + timezone: Asia/Taipei + enabled: true + # 秘書每日記憶壓縮與狀態摘要 ``` -### 排程對應 Agent +### 排程總覽 -| Routine | Agent | 頻率 | 說明 | -|---|---|---|---| -| daily-quant-pipeline | ceo | 週一至五 07:30 | 盤前啟動量化 pipeline | -| daily-post-market | ceo | 週一至五 18:30 | 盤後情報整理 | -| daily-market-intel | market-researcher | 每日 10:00 | 每日市場情報 | -| weekly-market-report | market-researcher | 每週一 09:00 | 每週市場分析 | -| daily-ads-check | ads-analyst | 每日 09:30 | 投放 KPI 檢查 | -| daily-data-summary | data-analyst | 每日 20:00 | 每日資料摘要 | -| weekly-data-report | data-analyst | 每週一 10:00 | 每週數據報告 | +| Routine | Agent | 職稱 | 頻率 | 說明 | +|---|---|---|---|---| +| daily-quant-pipeline | ceo | 執行長 | 週一至五 07:30 | 盤前啟動量化 pipeline | +| daily-post-market | ceo | 執行長 | 週一至五 18:30 | 盤後情報整理 | +| morning-market-intel | market-researcher | 市場研究員 | 每日 08:00 | 早盤市場情報（台股開盤前） | +| evening-market-intel | market-researcher | 市場研究員 | 每日 20:00 | 晚間市場情報（美股開盤前） | +| weekly-market-report | market-researcher | 市場研究員 | 每週日 10:00 | 每週市場分析報告 | +| daily-data-summary | data-analyst | 資料分析師 | 週一至五 21: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 | -| DB schema 變更 | CEO | -| 廣告正式發布 | CEO | -| 對外訊息發送 | CEO | -| 金流操作 | CEO | +| 需要審批的事 | 觸發者 | 說明 | +|---|---|---| +| 量化策略正式執行 | CEO | pipeline 完成後提交審批 | +| 正式部署 | CEO | 程式碼部署到 production | +| DB schema 變更 | CEO | 資料庫結構異動 | +| 廣告正式發布 | CEO | 對外廣告上線 | +| 對外訊息發送 | CEO | 品牌對外溝通 | +| 金流操作 | CEO | 任何涉及金錢的操作 | ### Review Gate | 必審節點 | 觸發方式 | 審查標準 | |---|---|---| -| 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 | -| 回測結果提交 | 策略師指派審查員 | 績效指標合理性 | -| 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 | +| 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 + 信心/恐慌指數合理性 | +| 回測結果提交 | 策略師指派審查員 | 績效指標合理性 + overfitting 檢查 | +| 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 + 安全性 | | 文案對外 | CEO 指派審查員 | 品牌一致性 + 法規合規 | --- @@ -170,10 +204,10 @@ routines: | 等級 | 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 | 秘書, 投放分析師, 資料分析師, 小安 | | 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 | 文案撰寫員, 創意總監 | 每個 agent 可在 `.paperclip.yaml` 中指定主要使用的模型，視任務需求切換。 @@ -186,5 +220,17 @@ routines: |---|---| | 模型分級 | 日常用 research/general，策略收斂才用 reasoning-heavy | | 排程頻率合理 | 不需要的 agent 不排太密的 cron | -| review 輪數上限 | revise 最多 3 輪，超過 escalate | -| 記憶壓縮 | 定期壓縮避免 context 膨脹 | +| review 輪數上限 | revise 最多 3 輪，超過 escalate 人工處理 | +| 記憶壓縮 | 秘書每日 23:00 壓縮，避免 context 膨脹 | +| 工程團隊按需啟用 | 前後端工程師平常 paused，有任務才啟動 | + +--- + +## 6. 停損信號 + +| 信號 | 動作 | +|---|---| +| 月費用超預期 2 倍 | 暫停非必要 agent | +| 反覆 revise 超過 5 輪 | 人工介入調整 prompt | +| 回測 winrate > 90% | 停下檢查 overfitting | +| Agent 產出品質持續下降 | 檢查記憶 + prompt + 模型選擇 | diff --git a/docs/schemas.md b/docs/schemas.md index 57be364..9355445 100644 --- a/docs/schemas.md +++ b/docs/schemas.md @@ -9,82 +9,175 @@ ## Finance_Research_Brief.json -產出者：finance-researcher +> 產出者：**財經情報研究員**（finance-researcher） ```json { "date": "2026-04-10", "market": "BTC/USDT", - "macro_summary": "...", + "session": "pre_market|post_market|intraday", + "macro_summary": "總體經濟概況摘要", "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 }, - "data_sources": ["..."] + "sentiment": { + "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-researcher +> 產出者：**市場結構研究員**（market-structure-researcher） ```json { "date": "2026-04-10", "market": "BTC/USDT", - "timeframes_analyzed": ["H4", "H1"], + "timeframes_analyzed": ["D1", "H4", "H1"], "structure": { "trend": "bullish|bearish|ranging", "mss_detected": true, + "mss_details": "MSS 發生的位置與時間描述", "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": [ - { "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-researcher +> 產出者：**多方研究員**（bullish-researcher） ```json { "date": "2026-04-10", "market": "BTC/USDT", - "thesis": "核心論點（一句話）", + "thesis": "核心做多論點（一句話）", "arguments": [ - { "point": "...", "evidence": "...", "confidence": 0.0 } + { + "point": "論點", + "evidence": "支持證據", + "confidence": 0.0 + } ], "key_levels": [ - { "type": "support|resistance", "price": 0, "timeframe": "H4", "evidence": "..." } + { + "type": "support|resistance|entry|target", + "price": 0, + "timeframe": "H4", + "evidence": "為什麼這個價位重要" + } ], - "catalysts": ["..."], - "invalidation": "什麼條件下論點失效", - "confidence": 0.0, - "data_sources": ["..."] + "catalysts": ["潛在催化劑 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"] } ``` +**欄位說明：** +- `confidence_index`：對做多論點的整體信心度（0.0-1.0） +- `entry_exit_suggestion`：多方視角的進出場建議 + --- ## 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 -產出者：quant-strategist +> 產出者：**量化策略師**（quant-strategist） ```json { @@ -92,39 +185,77 @@ "market": "BTC/USDT", "direction": "long|short|neutral", "thesis": "收斂後的策略論點", - "entry_zone": [0, 0], - "stop_loss": 0, - "take_profit": [0, 0], - "risk_reward": 0.0, - "position_size_pct": 0.0, - "risk_assessment": { + "market_indicators": { + "confidence_index": 0.0, + "fear_greed_index": 0.0, + "market_regime": "trending|ranging|volatile|calm" + }, + "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, "bias_check": "confirmed|conflicting", "bull_confidence": 0.0, "bear_confidence": 0.0 }, - "invalidation": "...", - "requires_backtest": true + "invalidation": "什麼條件下整個策略失效", + "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 -產出者：reviewer +> 產出者：**審查員**（reviewer） ```json { "date": "2026-04-10", "reviewed_artifact": "Strategy_Thesis.json", + "reviewed_agent": "quant-strategist", "verdict": "pass|revise|block", "score": 0.0, + "checklist": { + "schema_complete": true, + "risk_management_valid": true, + "data_sources_verified": true, + "confidence_reasonable": true, + "no_overfitting_risk": true + }, "issues": [ - { "severity": "critical|major|minor", "field": "...", "description": "...", "suggestion": "..." } + { + "severity": "critical|major|minor", + "field": "對應的欄位名", + "description": "問題描述", + "suggestion": "修改建議" + } ], - "revise_target": "quant-strategist|bullish-researcher|...", - "summary": "..." + "revise_target": "quant-strategist|bullish-researcher|bearish-researcher|...", + "revise_round": 1, + "summary": "審查結論摘要" } ``` @@ -132,23 +263,41 @@ ## Backtest_Report.json -產出者：quant-engineer +> 產出者：**回測工程師**（quant-engineer） ```json { "date": "2026-04-10", "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": { "total_trades": 0, + "winning_trades": 0, + "losing_trades": 0, "win_rate": 0.0, "profit_factor": 0.0, + "net_profit": 0.0, + "net_profit_pct": 0.0, "max_drawdown_pct": 0.0, + "max_drawdown_duration": "天數", "sharpe_ratio": 0.0, - "avg_rr": 0.0 + "sortino_ratio": 0.0, + "avg_rr": 0.0, + "avg_holding_period": "小時/天" }, - "code_artifact": "...", - "notes": "..." + "equity_curve_description": "權益曲線特徵描述", + "code_artifact": "程式碼檔案路徑或內容", + "notes": "回測備註與注意事項" } ``` @@ -156,11 +305,12 @@ ## Data_Analysis_Report.json -產出者：data-analyst +> 產出者：**資料分析師**（data-analyst） ```json { "date": "2026-04-10", + "report_type": "daily|weekly|backtest_analysis", "analyzed_artifact": "Backtest_Report.json", "metrics": { "total_trades": 0, @@ -168,11 +318,26 @@ "profit_factor": 0.0, "max_drawdown_pct": 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", - "summary": "..." + "recommendation_rationale": "建議依據", + "summary": "分析結論摘要" } ``` @@ -180,17 +345,59 @@ ## Task_Spec.json -產出者：ceo +> 產出者：**執行長**（ceo） ```json { - "task_id": "...", - "title": "...", + "task_id": "TASK-001", + "title": "任務標題", "assignee": "agent-slug", - "priority": "high|medium|low", - "description": "...", - "expected_output": "Schema 名稱", - "deadline": "2026-04-10T18:00:00+08:00" + "assignee_title": "Agent 職稱", + "team": "team-slug", + "priority": "critical|high|medium|low", + "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 -產出者：secretary +> 產出者：**秘書**（secretary） ```json { "date": "2026-04-10", - "participants": ["agent-slug", "..."], - "key_decisions": ["..."], - "action_items": [ - { "assignee": "agent-slug", "task": "...", "deadline": "..." } + "summary_type": "daily|weekly|meeting|incident", + "participants": [ + { "agent": "agent-slug", "title": "Agent 職稱" } ], - "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 -產出者：strategy-director +> 產出者：**策略總監**（strategy-director） ```json { "date": "2026-04-10", - "usp": "...", - "brand_narrative": "...", - "target_audience": ["..."], - "campaigns": [ - { "name": "...", "channel": "...", "objective": "...", "kpi": "..." } + "version": "1.0", + "usp": "獨特賣點定義", + "brand_narrative": "品牌故事與核心訊息", + "brand_voice": { + "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-analyst +> 產出者：**投放分析師**（ads-analyst） ```json { "date": "2026-04-10", - "platform": "...", - "metrics": { - "ctr": 0.0, - "cvr": 0.0, - "cpl": 0.0, - "roas": 0.0, - "spend": 0.0 - }, - "top_creatives": ["..."], - "recommendations": ["..."] + "report_period": "2026-04-01 ~ 2026-04-10", + "platforms": [ + { + "platform": "平台名稱", + "metrics": { + "impressions": 0, + "clicks": 0, + "ctr": 0.0, + "conversions": 0, + "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": "備註" } ```