chris/KingClawArmy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
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

237 lines
8.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 + 模型選擇 |
Reference in New Issue View Git Blame Copy Permalink