KingClawArmy/docs/agent_company_runtime_config_v2.md

# AI Agent Company - Runtime 配置檔（Prompt / LangGraph / Scheduler）

> 用途：只放 runtime 設定  
> 內容：角色 prompt 規格、LangGraph 節點命名、scheduler / webhook / cron、第一梯隊量化優先版

---

## 1. 角色 Prompt 共用規則

### 1.1 Prompt 必備欄位

| 欄位 | 說明 |
|---|---|
| Role | 角色名稱 |
| Mission | 任務目標 |
| Scope | 允許做的事 |
| Forbidden | 禁止事項 |
| Inputs | 預期輸入 |
| Outputs | 預期輸出 |
| Success Criteria | 成功標準 |
| Failure Conditions | 失敗條件 |
| Escalation | 何時交給 CEO / 審查員 / 董事長 |
| Style | 輸出風格 |
| Output Rule | 必須輸出 JSON |

### 1.2 Prompt 共用結尾
```text
You must only operate within your assigned role boundary.
Do not perform work outside your scope.
If required information is missing, explicitly return the missing_fields list.
If there is conflict, uncertainty, or high risk, escalate instead of guessing.
Your output must follow the required JSON schema exactly.
Do not add extra commentary outside the JSON payload.
```

---

## 2. 各角色 Prompt 規格（簡版）

| 角色 | Mission | Forbidden | Output |
|---|---|---|---|
| CEO / COO | 拆任務、分派、收斂、匯報 | 不直接寫文案 / 寫程式 / 部署 | Task_Spec.json、Final_Decision_Packet.json |
| 秘書 | 摘要、State Diff、Todo、記憶壓縮 | 不做策略決策 | Meeting_Summary.json、State_Diff.json、Todo_List.json |
| 審查員 | pass / revise / block、風險攔截 | 不重寫全部內容 | Review_Report.json |
| 財經情報研究員 | 財經 / 總經 / 盤前盤後資訊整理 | 不下交易結論 | Finance_Research_Brief.json |
| 市場結構研究員 | 結構、流動性、MSS、POI 分析 | 不下最終交易結論 | Market_Structure_Report.json |
| 多方研究員 | 建立支持交易論點 | 不直接拍板 | Bullish_Research_Report.json |
| 空方 / 反方研究員 | 建立反對交易論點 | 不直接拍板 | Bearish_Research_Report.json |
| 量化策略研究員 | 收斂成正式規則 | 不寫正式程式碼 | Quant_Strategy_Spec.json |
| 風控研究員 | 風控框架、bias check、position sizing | 不發明策略方向 | Risk_Control_Spec.json |
| 回測工程師 / Quant Engineer | 把規則轉成 Pine / Python 回測 | 不自行改策略方向 | Backtest_Delivery.json |
| 資料分析員 | KPI、回測分析、洞察 | 不自行定策略方向 | Data_Analysis_Report.json |
| 品牌策略總監 | USP、受眾、品牌敘事 | 不直接寫最終文案 | Brand_Strategy_Plan.json |
| 成長策略總監 | Campaign、funnel、轉換策略 | 不寫底層 SQL | Growth_Strategy_Plan.json |
| 市場研究分析師 | 市場變化與競品分析 | 不盯每日 KPI | Market_Analysis_Report.json |
| 投放成效分析師 | CTR / CVR / CPL / ROAS 診斷 | 不做品牌定位 | Ads_Performance_Report.json |
| 廣告文案撰寫員 | 廣告文案、Hook、CTA | 不改整體策略 | Copywriting_Pack.json |
| 影片腳本撰寫員 | 影片腳本、旁白、節奏 | 不做平面廣告文案 | Video_Script_Pack.json |
| 平面視覺設計總監 | 平面 brief、素材 QA | 不負責影片分鏡 | Static_Creative_Brief.json |
| 影片分鏡創意總監 | 分鏡 brief、影片視覺 QA | 不負責平面素材 | Storyboard_Brief.json |
| 前端工程師 | 前端頁面、UI、埋點 | 不定商業策略 | Frontend_Delivery.json |
| 後端工程師 | API、DB、Directus、自動化 | 不寫廣告文案 | Backend_Delivery.json |

---

## 3. LangGraph 節點命名

### 3.1 命名規則

| 規則 | 說明 |
|---|---|
| 小寫 snake_case | 統一命名 |
| `role_*` | 角色節點 |
| `sys_*` | 系統節點 |
| `gate_*` | 審核節點 |
| `hitl_*` | 人工中斷節點 |

### 3.2 節點表

| 類型 | 節點名稱 | 用途 |
|---|---|---|
| 系統 | `sys_receive_request` | 接收董事長需求 |
| 角色 | `role_ceo_dispatch` | CEO 拆任務 |
| 角色 | `role_secretary_summarize` | 秘書摘要與 state diff |
| 角色 | `role_reviewer_audit` | 審查員審核 |
| 系統 | `sys_prepare_final_packet` | 組裝決策包 |
| HITL | `hitl_chairman_decision` | 董事長決策 |
| 角色 | `role_finance_research` | 財經情報研究員 |
| 角色 | `role_market_research` | 市場情報研究員 |
| 角色 | `role_market_structure` | 市場結構研究員 |
| 角色 | `role_bullish_case` | 多方研究員 |
| 角色 | `role_bearish_case` | 空方 / 反方研究員 |
| 角色 | `role_quant_strategy` | 量化策略研究員 |
| 角色 | `role_risk_control` | 風控研究員 |
| 角色 | `role_quant_backtest` | 回測工程師 / Quant Engineer |
| 角色 | `role_data_analysis` | 資料分析員 |
| 角色 | `role_brand_strategy` | 品牌策略總監 |
| 角色 | `role_growth_strategy` | 成長策略總監 |
| 角色 | `role_market_analysis` | 市場研究分析師 |
| 角色 | `role_ads_analysis` | 投放成效分析師 |
| 角色 | `role_ad_copywriting` | 廣告文案撰寫員 |
| 角色 | `role_video_script` | 影片腳本撰寫員 |
| 角色 | `role_static_creative` | 平面視覺設計總監 |
| 角色 | `role_storyboard_creative` | 影片分鏡創意總監 |
| 角色 | `role_frontend_build` | 前端工程師 |
| 角色 | `role_backend_build` | 後端工程師 |
| 系統 | `sys_run_sandbox_tests` | sandbox 驗證 |
| gate | `gate_quant_review` | 量化策略與回測前審核 |
| gate | `gate_engineering_review` | 工程交付前審核 |
| gate | `gate_content_review` | 對外文案與素材前審核 |
| HITL | `hitl_db_schema_approval` | 正式 DB schema 變更前批准 |
| HITL | `hitl_production_deploy_approval` | 正式部署前批准 |
| HITL | `hitl_quant_execution_approval` | 量化策略正式自動執行前批准 |

---

## 4. 量化優先主流程

| 順序 | 節點 |
|---:|---|
| 1 | `sys_receive_request` |
| 2 | `role_ceo_dispatch` |
| 3 | `role_finance_research` |
| 4 | `role_market_structure` |
| 5 | `role_bullish_case` |
| 6 | `role_bearish_case` |
| 7 | `role_quant_strategy` |
| 8 | `role_risk_control` |
| 9 | `role_quant_backtest` |
| 10 | `role_data_analysis` |
| 11 | `role_secretary_summarize` |
| 12 | `gate_quant_review` |
| 13 | `sys_prepare_final_packet` |
| 14 | `hitl_chairman_decision` |

---

## 5. scheduler / webhook / cron 對照表

### 5.1 cron 任務

| 任務名稱 | 類型 | 建議排程 | 觸發節點 |
|---|---|---|---|
| finance_morning_scan | cron | 每日 07:30 | `role_finance_research` |
| finance_evening_scan | cron | 每日 18:30 | `role_finance_research` |
| market_daily_scan | cron | 每日 10:00 | `role_market_research` |
| ads_daily_check | cron | 每日 09:30 | `role_ads_analysis` |
| data_daily_summary | cron | 每日 20:00 | `role_data_analysis` |
| market_weekly_review | cron | 每週一 09:00 | `role_market_analysis` |
| data_weekly_report | cron | 每週一 10:00 | `role_data_analysis` |
| secretary_daily_compact | cron | 每日 23:00 | `role_secretary_summarize` |

### 5.2 webhook 任務

| 任務名稱 | webhook 來源 | 觸發節點 |
|---|---|---|
| chairman_new_request | 董事長輸入 / UI 表單 | `sys_receive_request` |
| campaign_metrics_updated | 廣告平台資料同步 | `role_ads_analysis` |
| backtest_finished | 回測服務完成 | `role_data_analysis` |
| market_data_ready | 市場資料服務完成 | `role_market_structure` |
| frontend_review_failed | sandbox / review 回報 | `role_frontend_build` |
| backend_review_failed | sandbox / review 回報 | `role_backend_build` |
| final_packet_ready | 系統收斂完成 | `hitl_chairman_decision` |

### 5.3 內部事件觸發

| 上一節點完成後 | 自動觸發下一節點 |
|---|---|
| `role_ceo_dispatch` | `role_finance_research` 或其他專才 |
| `role_finance_research` | `role_market_structure` |
| `role_market_structure` | `role_bullish_case`、`role_bearish_case` |
| `role_bullish_case` + `role_bearish_case` | `role_quant_strategy` |
| `role_quant_strategy` | `role_risk_control` |
| `role_risk_control` | `role_quant_backtest` |
| `role_quant_backtest` | `role_data_analysis` |
| `role_data_analysis` | `role_secretary_summarize` |
| `role_secretary_summarize` | `role_reviewer_audit` |
| `role_reviewer_audit` verdict=revise | 回退到被點名角色 |
| `role_reviewer_audit` verdict=pass | `sys_prepare_final_packet` |
| `sys_prepare_final_packet` | `hitl_chairman_decision` |

### 5.4 HITL 節點表

| 節點 | 人工角色 | 說明 |
|---|---|---|
| `hitl_chairman_decision` | 董事長 | 最終提案批准 / 拒絕 / 修改 |
| `hitl_db_schema_approval` | 董事長 | 正式 DB schema 變更前批准 |
| `hitl_production_deploy_approval` | 董事長 | 正式部署前批准 |
| `hitl_campaign_launch_approval` | 董事長 | 廣告正式發布前批准 |
| `hitl_external_message_approval` | 董事長 | 對外正式訊息前批准 |
| `hitl_quant_execution_approval` | 董事長 | 量化策略正式自動執行前批准 |

---

## 6. 第一梯隊量化優先版

| 梯隊 | 角色 |
|---|---|
| 第一梯隊 | CEO / COO、秘書、審查員、財經情報研究員、市場結構研究員、多方研究員、空方 / 反方研究員、量化策略研究員、風控研究員、回測工程師 / Quant Engineer、資料分析員 |
| 第二梯隊 | 前端工程師、後端工程師 |
| 第三梯隊 | 市場情報研究員、品牌策略總監、成長策略總監、市場研究分析師、投放成效分析師 |
| 第四梯隊 | 廣告文案撰寫員、影片腳本撰寫員、平面視覺設計總監、影片分鏡創意總監 |

### 第一梯隊最小可跑閉環

| 階段 | 節點 |
|---|---|
| 1 | 董事長提出量化任務 |
| 2 | CEO 拆成量化 Task_Spec |
| 3 | 財經情報研究員收集資料 |
| 4 | 市場結構研究員做結構分析 |
| 5 | 多方研究員提出支持論點 |
| 6 | 空方 / 反方研究員提出反對論點 |
| 7 | 量化策略研究員形成正式規則 |
| 8 | 風控研究員補齊風控與 bias check |
| 9 | 回測工程師將規則落地為 Pine / Python 回測 |
| 10 | 資料分析員接回測結果做分析 |
| 11 | 秘書輸出 Summary / State Diff / Todo |
| 12 | 審查員做量化 Review |
| 13 | CEO 組 Final_Decision_Packet |
| 14 | 董事長批准或退回 |