Files
KingClawArmy/docs/pipelines.md
Chris aae5913bf2 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>
2026-04-10 16:28:35 +00:00

8.1 KiB
Raw Blame History

KingClawArmy - Pipeline 與排程

平台Paperclip 日期2026-04-10


1. 量化研究 Pipeline

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

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 到 CEOCEO 通知董事長
revise 超過 3 輪 策略師 escalate 到 CEOCEO 通知董事長
agent 執行超時 策略師重新指派,帶上 timeout 通知
agent 回傳 missing_fields 策略師重新指派,明確要求補齊
模型 API 錯誤 自動重試 1 次,失敗 → 策略師 escalate CEO

2. 排程Routines

時區統一:Asia/Taipei

.paperclip.yaml routines 定義

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 + 模型選擇