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

- 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

View File

@@ -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 研究/工程 agents7 agents | 待開始 |
| 行銷團隊上線 | 策略總監 + 市場研究員 + 投放分析師(3 agents | 待開始 |
| 內容團隊上線 | 創意總監 + 文案撰寫員(2 agents | 待開始 |
| 工程團隊上線 | 前端 + 後端工程師2 agents依需求啟用 | 待開始 |

View File

@@ -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人類
├── 管理團隊
│ ├── CEOcoordinator
│ ├── 秘書
│ └── 審查員
├── 管理團隊3 agents
│ ├── CEOcoordinator,全局調度
│ ├── 秘書(記錄、摘要、記憶管理)
│ └── 審查員(品質把關 pass/revise/block
├── 量化研究團隊
│ ├── 量化策略師team lead
│ ├── 財經情報研究員
│ ├── 市場結構研究員
│ ├── 多方研究員
│ ├── 空方研究員
│ ├── 回測工程師
│ └── 資料分析師
├── 量化研究團隊7 agents
│ ├── 量化策略師team leadpipeline 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 ShiftMSS、Order BlockOB、Fair Value GapFVG、Point of InterestPOI |
| **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 |

View File

@@ -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 到 CEOCEO 通知董事長 |
| revise 超過 3 輪 | escalate 到 CEOCEO 通知董事長 |
| agent 執行超時 | 重新指派,帶上 timeout 通知 |
| agent 回傳 missing_fields | 重新指派,明確要求補齊 |
| revise審查退回 | 策略師重新指派被退回的 agent帶上修改意見與 Review_Report,最多 3 輪 |
| block審查否決 | 策略師 escalate 到 CEOCEO 通知董事長 |
| revise 超過 3 輪 | 策略師 escalate 到 CEOCEO 通知董事長 |
| 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 + 模型選擇 |

View File

@@ -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-100100 = 極度樂觀)
- `fear_greed_index`:恐慌/貪婪指數0-1000 = 極度恐慌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": "備註"
}
```