# 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": ["..."]
}
```