Files
KingClawArmy/docs/spec_v3_schemas.md
Chris 8d97610634 Initial commit: KingClawArmy AI Agent Team spec v4
Pure OpenClaw architecture for 15-17 agent team covering quant research,
marketing, content, and engineering. Includes org structure, role definitions,
collaboration patterns, scheduling, memory architecture, Discord integration,
rollout plan, and JSON schemas.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-09 03:39:29 +08:00

8.8 KiB
Raw Blame History

KingClawArmy - 第八部分JSON Schema

基於 v2 schema 更新,新增會議相關 schema
所有 schema 只保留格式模板,不放假資料


8.1 共用欄位

{
  "task_id": "<string>",
  "project_id": "<string>",
  "agent_id": "<string>",
  "role": "<string>",
  "timestamp": "<ISO-8601 string>",
  "status": "<pending|running|pass|revise|block|done|cancelled>",
  "input_version": "<string>"
}

8.2 管理層 Schema

Task_Spec.jsonCEO/COO 產出)

{
  "task_id": "<string>",
  "project_id": "<string>",
  "agent_id": "ceo_coo",
  "role": "ceo_coo",
  "timestamp": "<ISO-8601>",
  "status": "<pending|running|done>",
  "goal": "<string>",
  "success_criteria": ["<string>"],
  "routes": [
    {
      "agent_id": "<string>",
      "subtask": "<string>",
      "required_output": "<string>",
      "collaboration_mode": "<task_handoff|meeting>"
    }
  ],
  "priority": "<low|medium|high>",
  "meeting_required": "<boolean>",
  "meeting_type": "<meeting_quant_debate|meeting_strategy_review|meeting_cross_team_sync|null>",
  "notes": ["<string>"]
}

Final_Decision_Packet.jsonCEO/COO 產出)

{
  "task_id": "<string>",
  "project_id": "<string>",
  "agent_id": "ceo_coo",
  "timestamp": "<ISO-8601>",
  "status": "done",
  "summary": "<string>",
  "options": [
    {
      "name": "<string>",
      "description": "<string>",
      "pros": ["<string>"],
      "cons": ["<string>"],
      "risk_level": "<low|medium|high>"
    }
  ],
  "recommended_option": "<string>",
  "review_verdict": "<pass|revise|block>",
  "meeting_conclusions": ["<string>"],
  "decision_needed": ["<string>"]
}

Meeting_Summary.json秘書產出

{
  "task_id": "<string>",
  "project_id": "<string>",
  "agent_id": "secretary",
  "timestamp": "<ISO-8601>",
  "meeting_type": "<string>",
  "topic": "<string>",
  "participants": ["<agent_id>"],
  "key_points": ["<string>"],
  "consensus": "<string>",
  "disagreements": ["<string>"],
  "action_items": [
    {
      "owner": "<agent_id>",
      "task": "<string>",
      "deadline": "<ISO-8601|null>"
    }
  ],
  "unresolved": ["<string>"]
}

State_Diff.json秘書產出

{
  "task_id": "<string>",
  "agent_id": "secretary",
  "timestamp": "<ISO-8601>",
  "added": ["<string>"],
  "changed": ["<string>"],
  "removed": ["<string>"]
}

Review_Report.json審查員產出

{
  "task_id": "<string>",
  "agent_id": "reviewer",
  "timestamp": "<ISO-8601>",
  "reviewed_agent_id": "<string>",
  "reviewed_output_type": "<string>",
  "verdict": "<pass|revise|block>",
  "issues": [
    {
      "severity": "<low|medium|high>",
      "category": "<string>",
      "evidence": "<string>",
      "required_fix": "<string>"
    }
  ],
  "revise_count": "<number>",
  "recommend_meeting": "<boolean>",
  "notes": "<string>"
}

8.3 量化研究 Schema

Finance_Research_Brief.json

{
  "task_id": "<string>",
  "agent_id": "finance_researcher",
  "timestamp": "<ISO-8601>",
  "sources": [
    {
      "title": "<string>",
      "url": "<string>",
      "published_at": "<ISO-8601>",
      "source_type": "<news|blog|forum|official>",
      "summary": "<string>",
      "confidence": "<number 0-1>",
      "dedupe_key": "<string>"
    }
  ],
  "macro_summary": "<string>",
  "conflicts": ["<string>"],
  "takeaways": ["<string>"]
}

Market_Structure_Report.json

{
  "task_id": "<string>",
  "agent_id": "market_structure_researcher",
  "timestamp": "<ISO-8601>",
  "timeframes_used": ["<string>"],
  "structure_summary": ["<string>"],
  "liquidity_zones": ["<string>"],
  "poi_candidates": ["<string>"],
  "mss_signals": ["<string>"],
  "bias": "<bullish|bearish|neutral|unclear>",
  "confidence": "<number 0-1>",
  "notes": ["<string>"]
}

Bullish_Research_Report.json

{
  "task_id": "<string>",
  "agent_id": "bullish_researcher",
  "timestamp": "<ISO-8601>",
  "bull_case": ["<string>"],
  "supporting_evidence": ["<string>"],
  "expected_edge": ["<string>"],
  "invalidations": ["<string>"],
  "conviction_level": "<low|medium|high>"
}

Bearish_Research_Report.json

{
  "task_id": "<string>",
  "agent_id": "bearish_researcher",
  "timestamp": "<ISO-8601>",
  "bear_case": ["<string>"],
  "supporting_evidence": ["<string>"],
  "risk_warnings": ["<string>"],
  "trade_rejection_reasons": ["<string>"],
  "conviction_level": "<low|medium|high>"
}

Quant_Strategy_Spec.json含風控

{
  "task_id": "<string>",
  "agent_id": "quant_strategist",
  "timestamp": "<ISO-8601>",
  "strategy_hypothesis": ["<string>"],
  "entry_rules": ["<string>"],
  "exit_rules": ["<string>"],
  "risk_control": {
    "position_sizing": ["<string>"],
    "stop_rules": ["<string>"],
    "take_profit_rules": ["<string>"],
    "max_drawdown": "<string>",
    "max_concurrent_positions": "<number>"
  },
  "bias_checks": ["<string>"],
  "meeting_based": "<boolean>",
  "meeting_id": "<string|null>"
}

Backtest_Delivery.json

{
  "task_id": "<string>",
  "agent_id": "quant_engineer",
  "timestamp": "<ISO-8601>",
  "implementation_type": "<pine|python|both>",
  "rules_implemented": ["<string>"],
  "data_used": ["<string>"],
  "assumptions": ["<string>"],
  "results_summary": {
    "winrate": "<number>",
    "expectancy": "<number>",
    "max_drawdown": "<number>",
    "sharpe_ratio": "<number>",
    "total_trades": "<number>",
    "period": "<string>"
  },
  "artifacts": ["<string>"],
  "bias_warnings": ["<string>"],
  "handoff_notes": ["<string>"]
}

Data_Analysis_Report.json

{
  "task_id": "<string>",
  "agent_id": "data_analyst",
  "timestamp": "<ISO-8601>",
  "report_type": "<daily|weekly|backtest_analysis|ad_hoc>",
  "kpi_summary": ["<string>"],
  "insights": ["<string>"],
  "anomalies": ["<string>"],
  "recommendations": ["<string>"]
}

8.4 行銷 & 內容 Schema

Market_Research_Brief.json / Market_Analysis_Report.json

{
  "task_id": "<string>",
  "agent_id": "market_researcher",
  "timestamp": "<ISO-8601>",
  "report_type": "<brief|analysis>",
  "sources": [
    {
      "title": "<string>",
      "url": "<string>",
      "summary": "<string>",
      "confidence": "<number 0-1>"
    }
  ],
  "pain_points": ["<string>"],
  "competitor_patterns": ["<string>"],
  "trend_signals": ["<string>"],
  "takeaways": ["<string>"]
}

Brand_Strategy_Plan.json / Growth_Strategy_Plan.json

{
  "task_id": "<string>",
  "agent_id": "strategy_director",
  "timestamp": "<ISO-8601>",
  "plan_type": "<brand|growth>",
  "usp": ["<string>"],
  "target_audience": ["<string>"],
  "core_messages": ["<string>"],
  "campaign_direction": ["<string>"],
  "funnel_plan": ["<string>"],
  "test_plan": ["<string>"]
}

Ads_Performance_Report.json

{
  "task_id": "<string>",
  "agent_id": "ads_analyst",
  "timestamp": "<ISO-8601>",
  "performance_summary": ["<string>"],
  "diagnosis": ["<string>"],
  "optimization_suggestions": ["<string>"],
  "alerts": ["<string>"]
}

Copywriting_Pack.json

{
  "task_id": "<string>",
  "agent_id": "copywriter",
  "timestamp": "<ISO-8601>",
  "content_type": "<ad_copy|video_script|both>",
  "hooks": ["<string>"],
  "bodies": ["<string>"],
  "ctas": ["<string>"],
  "video_sections": [
    {
      "scene": "<number>",
      "message": "<string>",
      "duration_seconds": "<number>"
    }
  ]
}

Static_Creative_Brief.json / Storyboard_Brief.json

{
  "task_id": "<string>",
  "agent_id": "creative_director",
  "timestamp": "<ISO-8601>",
  "brief_type": "<static|storyboard>",
  "visual_direction": ["<string>"],
  "must_include": ["<string>"],
  "asset_specs": ["<string>"],
  "shots": [
    {
      "scene": "<number>",
      "visual": "<string>",
      "motion": "<string>",
      "caption": "<string>"
    }
  ],
  "style_notes": ["<string>"]
}

8.5 新增:會議相關 Schema

Meeting_Request.json發起會議

{
  "meeting_id": "<string>",
  "meeting_type": "<meeting_quant_debate|meeting_strategy_review|meeting_cross_team_sync|meeting_daily_premarket|custom>",
  "topic": "<string>",
  "requested_by": "<agent_id>",
  "participants": ["<agent_id>"],
  "moderator": "<agent_id>",
  "input_context": ["<schema_name>"],
  "max_rounds": "<number>",
  "stop_condition": "<string>",
  "discord_channel": "<string>"
}

Meeting_Conclusion.json會議結論

{
  "meeting_id": "<string>",
  "meeting_type": "<string>",
  "topic": "<string>",
  "participants": ["<agent_id>"],
  "moderator": "<agent_id>",
  "total_rounds": "<number>",
  "conclusion": "<string>",
  "consensus_reached": "<boolean>",
  "key_arguments": [
    {
      "agent_id": "<string>",
      "position": "<string>",
      "key_points": ["<string>"]
    }
  ],
  "action_items": [
    {
      "owner": "<agent_id>",
      "task": "<string>"
    }
  ],
  "dissenting_opinions": ["<string>"],
  "next_steps": ["<string>"]
}