# KingClawArmy - Pipeline 與排程

> 平台：Paperclip
> 日期：2026-04-10

---

## 1. 量化研究 Pipeline

量化策略師主導整個 pipeline，CEO 只管啟動和例外處理。

```
CEO → 量化策略師（pipeline owner）
         │
         ├─ 財經情報研究員
         │    └─ Finance_Research_Brief.json
         │
         ├─ 市場結構研究員（等情報完成）
         │    └─ Market_Structure_Report.json
         │
         ├─ 多方研究員 ──┐
         ├─ 空方研究員 ──┘ 並行
         │    └─ Bullish_Brief.json / Bearish_Brief.json
         │
         ├─ 策略師收斂
         │    └─ Strategy_Thesis.json（含信心指數、恐慌指數、進出場建議）
         │
         ├─ 審查員
         │    ├─ pass → 繼續
         │    ├─ revise → 重跑被退回角色（最多 3 輪）
         │    └─ block → escalate CEO
         │
         ├─ 回測工程師（策略需要回測時）
         │    └─ Backtest_Report.json
         │
         ├─ 資料分析師（審查 pass 後）
         │    └─ Data_Analysis_Report.json
         │
         └─ CEO → 董事長審批
```

### 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 |
| 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，帶上修改意見與 Review_Report，最多 3 輪 |
| block（審查否決） | 策略師 escalate 到 CEO，CEO 通知董事長 |
| revise 超過 3 輪 | 策略師 escalate 到 CEO，CEO 通知董事長 |
| agent 執行超時 | 策略師重新指派，帶上 timeout 通知 |
| agent 回傳 missing_fields | 策略師重新指派，明確要求補齊 |
| 模型 API 錯誤 | 自動重試 1 次，失敗 → 策略師 escalate CEO |

---

## 2. 排程（Routines）

時區統一：`Asia/Taipei`

### .paperclip.yaml routines 定義

```yaml
routines:
  daily-quant-pipeline:
    triggers:
      - kind: schedule
        cronExpression: "30 7 * * 1-5"
        timezone: Asia/Taipei
        enabled: true
    # CEO 啟動量化 pipeline（台股 09:00 開盤前）

  daily-post-market:
    triggers:
      - kind: schedule
        cronExpression: "30 18 * * 1-5"
        timezone: Asia/Taipei
        enabled: true
    # CEO 啟動盤後情報整理

  morning-market-intel:
    triggers:
      - kind: schedule
        cronExpression: "0 8 * * *"
        timezone: Asia/Taipei
        enabled: true
    # 市場研究員早盤市場情報（台股開盤前）

  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 14 * * 0"
        timezone: Asia/Taipei
        enabled: true
    # 資料分析師每週數據報告（週日下午）

  daily-secretary-digest:
    triggers:
      - kind: schedule
        cronExpression: "0 23 * * *"
        timezone: Asia/Taipei
        enabled: true
    # 秘書每日記憶壓縮與狀態摘要
```

### 排程總覽

| 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  資料分析師 - 每週數據報告
週一～五    每日排程如上
```

---

## 3. 審批機制（HITL）

以下動作需要董事長批准：

| 需要審批的事 | 觸發者 | 說明 |
|---|---|---|
| 量化策略正式執行 | CEO | pipeline 完成後提交審批 |
| 正式部署 | CEO | 程式碼部署到 production |
| DB schema 變更 | CEO | 資料庫結構異動 |
| 廣告正式發布 | CEO | 對外廣告上線 |
| 對外訊息發送 | CEO | 品牌對外溝通 |
| 金流操作 | CEO | 任何涉及金錢的操作 |

### Review Gate

| 必審節點 | 觸發方式 | 審查標準 |
|---|---|---|
| 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 + 信心/恐慌指數合理性 |
| 回測結果提交 | 策略師指派審查員 | 績效指標合理性 + overfitting 檢查 |
| 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 + 安全性 |
| 文案對外 | CEO 指派審查員 | 品牌一致性 + 法規合規 |

---

## 4. 模型分級

搭配 GPT 與 Claude 雙模型，依任務特性分配：

| 等級 | GPT 模型 | Claude 模型 | 適用 Agent |
|---|---|---|---|
| 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 | 回測工程師, 前端工程師, 後端工程師 |
| creative | gpt-5.4 | claude-sonnet-4-6 | 文案撰寫員, 創意總監 |

每個 agent 可在 `.paperclip.yaml` 中指定主要使用的模型，視任務需求切換。

---

## 5. 成本控制

| 策略 | 做法 |
|---|---|
| 模型分級 | 日常用 research/general，策略收斂才用 reasoning-heavy |
| 排程頻率合理 | 不需要的 agent 不排太密的 cron |
| review 輪數上限 | revise 最多 3 輪，超過 escalate 人工處理 |
| 記憶壓縮 | 秘書每日 23:00 壓縮，避免 context 膨脹 |
| 工程團隊按需啟用 | 前後端工程師平常 paused，有任務才啟動 |

---

## 6. 停損信號

| 信號 | 動作 |
|---|---|
| 月費用超預期 2 倍 | 暫停非必要 agent |
| 反覆 revise 超過 5 輪 | 人工介入調整 prompt |
| 回測 winrate > 90% | 停下檢查 overfitting |
| Agent 產出品質持續下降 | 檢查記憶 + prompt + 模型選擇 |