docs: 移除 OpenClaw 文檔,重建為 Paperclip 正式方案
- 刪除所有 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>
This commit is contained in:
254
docs/schemas.md
Normal file
254
docs/schemas.md
Normal file
@@ -0,0 +1,254 @@
|
||||
# KingClawArmy - 輸出 Schema 定義
|
||||
|
||||
> 平台:Paperclip
|
||||
> 日期:2026-04-10
|
||||
|
||||
每個 agent 的產出必須遵循定義好的 JSON schema,確保一次交齊,減少追問。
|
||||
|
||||
---
|
||||
|
||||
## Finance_Research_Brief.json
|
||||
|
||||
產出者:finance-researcher
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"market": "BTC/USDT",
|
||||
"macro_summary": "...",
|
||||
"key_events": [
|
||||
{ "event": "...", "impact": "bullish|bearish|neutral", "source": "..." }
|
||||
],
|
||||
"sentiment": { "overall": "bullish|bearish|neutral", "score": 0.0 },
|
||||
"data_sources": ["..."]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Market_Structure_Report.json
|
||||
|
||||
產出者:market-structure-researcher
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"market": "BTC/USDT",
|
||||
"timeframes_analyzed": ["H4", "H1"],
|
||||
"structure": {
|
||||
"trend": "bullish|bearish|ranging",
|
||||
"mss_detected": true,
|
||||
"key_levels": [
|
||||
{ "type": "OB|FVG|POI|support|resistance", "price": 0, "timeframe": "H4", "tested": false }
|
||||
]
|
||||
},
|
||||
"liquidity_zones": [
|
||||
{ "type": "buy_side|sell_side", "range": [0, 0], "significance": "high|medium|low" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Bullish_Brief.json
|
||||
|
||||
產出者:bullish-researcher
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"market": "BTC/USDT",
|
||||
"thesis": "核心論點(一句話)",
|
||||
"arguments": [
|
||||
{ "point": "...", "evidence": "...", "confidence": 0.0 }
|
||||
],
|
||||
"key_levels": [
|
||||
{ "type": "support|resistance", "price": 0, "timeframe": "H4", "evidence": "..." }
|
||||
],
|
||||
"catalysts": ["..."],
|
||||
"invalidation": "什麼條件下論點失效",
|
||||
"confidence": 0.0,
|
||||
"data_sources": ["..."]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Bearish_Brief.json
|
||||
|
||||
產出者:bearish-researcher
|
||||
|
||||
格式同 Bullish_Brief.json,立場相反。
|
||||
|
||||
---
|
||||
|
||||
## Strategy_Thesis.json
|
||||
|
||||
產出者:quant-strategist
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"market": "BTC/USDT",
|
||||
"direction": "long|short|neutral",
|
||||
"thesis": "收斂後的策略論點",
|
||||
"entry_zone": [0, 0],
|
||||
"stop_loss": 0,
|
||||
"take_profit": [0, 0],
|
||||
"risk_reward": 0.0,
|
||||
"position_size_pct": 0.0,
|
||||
"risk_assessment": {
|
||||
"max_drawdown_pct": 0.0,
|
||||
"bias_check": "confirmed|conflicting",
|
||||
"bull_confidence": 0.0,
|
||||
"bear_confidence": 0.0
|
||||
},
|
||||
"invalidation": "...",
|
||||
"requires_backtest": true
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Review_Report.json
|
||||
|
||||
產出者:reviewer
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"reviewed_artifact": "Strategy_Thesis.json",
|
||||
"verdict": "pass|revise|block",
|
||||
"score": 0.0,
|
||||
"issues": [
|
||||
{ "severity": "critical|major|minor", "field": "...", "description": "...", "suggestion": "..." }
|
||||
],
|
||||
"revise_target": "quant-strategist|bullish-researcher|...",
|
||||
"summary": "..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Backtest_Report.json
|
||||
|
||||
產出者:quant-engineer
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"strategy_ref": "Strategy_Thesis.json",
|
||||
"platform": "pine_script|python",
|
||||
"results": {
|
||||
"total_trades": 0,
|
||||
"win_rate": 0.0,
|
||||
"profit_factor": 0.0,
|
||||
"max_drawdown_pct": 0.0,
|
||||
"sharpe_ratio": 0.0,
|
||||
"avg_rr": 0.0
|
||||
},
|
||||
"code_artifact": "...",
|
||||
"notes": "..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Data_Analysis_Report.json
|
||||
|
||||
產出者:data-analyst
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"analyzed_artifact": "Backtest_Report.json",
|
||||
"metrics": {
|
||||
"total_trades": 0,
|
||||
"win_rate": 0.0,
|
||||
"profit_factor": 0.0,
|
||||
"max_drawdown_pct": 0.0,
|
||||
"sharpe_ratio": 0.0,
|
||||
"avg_rr": 0.0
|
||||
},
|
||||
"insights": ["..."],
|
||||
"recommendation": "proceed|adjust|reject",
|
||||
"summary": "..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task_Spec.json
|
||||
|
||||
產出者:ceo
|
||||
|
||||
```json
|
||||
{
|
||||
"task_id": "...",
|
||||
"title": "...",
|
||||
"assignee": "agent-slug",
|
||||
"priority": "high|medium|low",
|
||||
"description": "...",
|
||||
"expected_output": "Schema 名稱",
|
||||
"deadline": "2026-04-10T18:00:00+08:00"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Meeting_Summary.json
|
||||
|
||||
產出者:secretary
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"participants": ["agent-slug", "..."],
|
||||
"key_decisions": ["..."],
|
||||
"action_items": [
|
||||
{ "assignee": "agent-slug", "task": "...", "deadline": "..." }
|
||||
],
|
||||
"notes": "..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Brand_Strategy_Plan.json
|
||||
|
||||
產出者:strategy-director
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"usp": "...",
|
||||
"brand_narrative": "...",
|
||||
"target_audience": ["..."],
|
||||
"campaigns": [
|
||||
{ "name": "...", "channel": "...", "objective": "...", "kpi": "..." }
|
||||
],
|
||||
"funnel_strategy": "..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Ads_Performance_Report.json
|
||||
|
||||
產出者:ads-analyst
|
||||
|
||||
```json
|
||||
{
|
||||
"date": "2026-04-10",
|
||||
"platform": "...",
|
||||
"metrics": {
|
||||
"ctr": 0.0,
|
||||
"cvr": 0.0,
|
||||
"cpl": 0.0,
|
||||
"roas": 0.0,
|
||||
"spend": 0.0
|
||||
},
|
||||
"top_creatives": ["..."],
|
||||
"recommendations": ["..."]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user