- 刪除所有 OpenClaw 時期的 spec/、guides/、migration 文檔 - 新增 company.md:公司定義、16 個 agent、4 個 team、skills、package 結構 - 新增 pipelines.md:量化 pipeline 流程、排程定義、審批機制、GPT+Claude 雙模型分級 - 新增 schemas.md:所有 agent 輸出的 JSON schema 定義 - 更新 INDEX.md:乾淨的文件索引與進度追蹤 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
191 lines
5.7 KiB
Markdown
191 lines
5.7 KiB
Markdown
# 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
|
||
│
|
||
├─ 資料分析師(審查 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 |
|
||
| analysis | data-analyst | 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 | 重新指派,明確要求補齊 |
|
||
|
||
---
|
||
|
||
## 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
|
||
|
||
daily-post-market:
|
||
triggers:
|
||
- kind: schedule
|
||
cronExpression: "30 18 * * 1-5"
|
||
timezone: Asia/Taipei
|
||
enabled: true
|
||
# CEO spawn 財經情報研究員做盤後整理
|
||
|
||
daily-market-intel:
|
||
triggers:
|
||
- kind: schedule
|
||
cronExpression: "0 10 * * *"
|
||
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:
|
||
triggers:
|
||
- kind: schedule
|
||
cronExpression: "0 20 * * *"
|
||
timezone: Asia/Taipei
|
||
enabled: true
|
||
# 資料分析師每日資料摘要
|
||
|
||
weekly-data-report:
|
||
triggers:
|
||
- kind: schedule
|
||
cronExpression: "0 10 * * 1"
|
||
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 | 每週數據報告 |
|
||
|
||
---
|
||
|
||
## 3. 審批機制(HITL)
|
||
|
||
以下動作需要董事長批准:
|
||
|
||
| 需要審批的事 | 觸發者 |
|
||
|---|---|
|
||
| 量化策略正式執行 | CEO |
|
||
| 正式部署 | CEO |
|
||
| DB schema 變更 | CEO |
|
||
| 廣告正式發布 | CEO |
|
||
| 對外訊息發送 | CEO |
|
||
| 金流操作 | CEO |
|
||
|
||
### Review Gate
|
||
|
||
| 必審節點 | 觸發方式 | 審查標準 |
|
||
|---|---|---|
|
||
| 量化策略提交 | 策略師指派審查員 | schema 完整性 + 風控邏輯 |
|
||
| 回測結果提交 | 策略師指派審查員 | 績效指標合理性 |
|
||
| 工程交付 | CEO 指派審查員 | 程式碼品質 + 測試覆蓋 |
|
||
| 文案對外 | CEO 指派審查員 | 品牌一致性 + 法規合規 |
|
||
|
||
---
|
||
|
||
## 4. 模型分級
|
||
|
||
搭配 GPT 與 Claude 雙模型,依任務特性分配:
|
||
|
||
| 等級 | GPT 模型 | Claude 模型 | 適用 Agent |
|
||
|---|---|---|---|
|
||
| reasoning-heavy | gpt-5.4 | claude-opus-4-6 | CEO, 審查員, 策略師, 市場結構研究員, 多方/空方研究員, 策略總監 |
|
||
| 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 |
|
||
| 記憶壓縮 | 定期壓縮避免 context 膨脹 |
|