four-color-cards

name	four-color-cards
description	基于解析后的文档与用户意图，生成四色卡片——事实蓝卡、解释绿卡、风险黄卡、行动红卡，是八官署方法论的核心分析输出。
assign_when	该 Worker 负责把结构化文档转化为可审计的事实-解释-风险-行动卡片，并需与监察院（过度声明检测）和丞相府（行动建议）协同。

四色卡片生成 Skill（通政司 + 监察院 + 丞相府）

使用方式

• 由通政司 Worker 主调用，生成蓝卡（事实）/ 绿卡（解释）。
• 黄卡（风险）交由监察院复核过度声明；红卡（行动）交由丞相府补全策略建议。
• 四卡片统一经太史阁留痕，保证每张卡片可溯源。

输入（Input）

• markdown：密卷房解析产出的结构化文档
• intent：用户意图 / 查询目标
• llm_available：LLM 是否可用（影响黄卡生成路径）

输出（Output）

• blue_card：事实卡——可溯源的陈述，附来源片段
• green_card：解释卡——对事实的机制/背景说明
• yellow_card：风险卡——过度声明、不确定性与潜在偏差（经监察院复核）
• red_card：行动卡——下一步建议（经丞相府补全）

依赖（Dependencies）

• LLM API（生成蓝/绿/红卡）
• 过度声明检测规则集（监察院提供，用于黄卡）
• 解析置信度（来自 doc-parse，低置信度触发人工复核标记）

失败处理（Failure Handling）

• LLM 不可用 → 降级到规则引擎生成卡片，黄卡/红卡显式标注「未启用 LLM」。
• 监察院复核超时 → 黄卡暂以规则引擎结果交付，并标记 pending_review。
• 来源缺失 → 对应事实在蓝卡中标注「无来源」，不直接生成断言。

复用价值（Reuse Value）

• 方法论通用：科研分析、金融研报、法律文档分析均可套用四色卡片框架。
• 可审计性强：每张卡片带来源与生成方式，天然契合 Agent Infra 的可观测/审计评审维度。

复赛代码包执行（runnable package）

• 真实入口：scripts/run_four_color_cards.py --stage {extract|review|propose}
• 三个子任务映射：
  • extract → 通政司 comm.tongzhengsi.TongZhengSiAgent（蓝卡：事实抽取）
  • review → 监察院 audit.jichayuan.JianChaYuanAgent（绿卡：Gap/解释）
  • propose → 丞相府 strategy.chengxiangfu.ChengXiangFuAgent（红卡：行动建议）
• 运行示例：
  • python skills/four-color-cards/scripts/run_four_color_cards.py --stage extract
  • python skills/four-color-cards/scripts/run_four_color_cards.py --stage review
  • python skills/four-color-cards/scripts/run_four_color_cards.py --stage propose
• 产物：examples/snse_survey/skill_outputs/four_color_<stage>.json
• 溯源铁律：绿卡 cite 蓝卡、红卡 cite 绿卡/蓝卡，无来源不得入库（由 card_model 强制）。