| name | ir-reporter |
| version | 2.1.0 |
| description | 投研报告统稿与交付Agent。仅被 ir-coordinator 内部调度，负责统稿、DOCX 生成、对抗验证和交付。不搜索新数据，只基于所有 step 的完整输出写报告。⚠️ 此 skill 不应被用户直接触发——用户说'写研报'、'做尽调'、'分析股票'应触发 ir-coordinator 而非此 skill。仅当用户明确说'统稿'、'生成 DOCX'、'把已有分析整理成报告'时才直接触发。 |
| allowed-tools | ["Read","Write","execute_command","use_skill"] |
IR Reporter — 投研报告撰写 Agent（架构文档，非运行时指令）
⚠️ 本文件是项目架构文档，供维护者理解管线用。运行时子代理的 system_prompt 从 instruction_store_ir/*.md 加载，不从本文件加载。
你是 IR/BP 管线的统稿和交付环节。你负责 step8（统稿）、DOCX 生成、对抗验证和交付。
环境常量
IR_RUNTIME: ~/.workbuddy/ir_runtime/ (symlink → 实际管线目录)
INSTRUCTION_STORE: ~/.workbuddy/ir_runtime/instruction_store_ir/
执行流程
1. 读取质量生产型产物和所有 step 输出
IR 新管线优先使用质量生产型产物：Research Plan、Fact Store、Section Packages、Debate Review、Final Assembly。统稿是组装和交付，不是新增事实。
统稿必须基于所有前序 step 的完整输出（不是摘要）。
输出文件路径（二选一，取决于管线入口）：
- WorkBuddy 直调模式：
{IR_RUNTIME}/data/tasks/{TASK_ID}-{step}.md（ir_subagent_launcher_wb.py 使用，当前活跃）
- PipelineOrchestrator 模式：
{IR_RUNTIME}/jobs/{JOB_ID}/outputs/{step}.md
判断方法：先检查 data/tasks/ 目录是否存在 step 输出；若不存在再检查 jobs/ 目录。
完整 step 列表（5-Wave 11-Agent）：
- step0_tech（技术分析）、step1_data（数据收集）、step2_industry（行业分析）、step3_biz（商业模式）
- step4_finance（财务分析）、step5_mgmt（管理层）、step_macro（宏观分析）
- step6b_valuation（预测与估值）、step6_insight（差异化洞察）、step7_risk（风险催化）
预计算数据（由 Phase 1.2 预计算引擎提供，统稿时可交叉验证）：
{IR_RUNTIME}/data/tasks/{TASK_ID}_precompute_financial_metrics.json — 财务五大维度指标{IR_RUNTIME}/data/tasks/{TASK_ID}_precompute_technical_indicators.json — 11项技术指标{IR_RUNTIME}/data/tasks/{TASK_ID}_precompute_sector_benchmarks.json — 行业对标数据
3. 撰写统稿
IR 写作规范和事故教训 → 读 ../../references/quality/ir-writing-standards.md
4. 交叉验证
统稿前必须运行：
python3 {IR_RUNTIME}/scripts/verify_cross_step_consistency.py --task-id TASK-XXXXX
FAIL 级必须修正。
5. 生成 DOCX
IR 研报：
python3 {IR_RUNTIME}/scripts/build_ir_broker_report_docx.py TASK-XXXXX
IC 行业研报：
python3 {IR_RUNTIME}/scripts/build_ic_industry_report_docx.py TASK-XXXXX
BP DD 报告（v4.4+ — 从 bp_synthesis.md 生成）：
python3 {IR_RUNTIME}/scripts/build_bp_dd_report_docx.py \
--task-id TASK-XXXXX \
--entity "公司名称" \
--output /path/to/output.docx \
--dimensions-dir /path/to/dimensions_dir
⚠️ BP 管线 v4.4+ 变更：最终交付物是 DOCX（从 bp_synthesis.md 生成），fallback 到 bp_final_report.md。字体动态检测（macOS 优先 PingFang SC），来源渲染保留所有有名称的来源。python-docx 不可用时走 subprocess fallback。
6. 对抗验证
python3 {IR_RUNTIME}/scripts/verification_agent.py --task-id TASK-XXXXX --pipeline ir
FAIL → 修复 → 重验（最多 1 次）。
验证结果写入：{IR_RUNTIME}/jobs/{JOB_ID}/verification/
7. 交付
交付协议、产物归档 → 读 ../../references/delivery/delivery-protocol.md
8. BP 尽调报告
BP 防缺陷规则（17 条铁律）→ 读 ../../references/quality/bp-anti-defect-rules.md
VL OCR 配置 → 读 ../../references/operations/bp-ocr-config.md（不重复列出）
9. BP Phase33 交付详细流程（2026-06-29 更新）
Phase33 由 heavy_phase_bg 子进程执行（不复用缓存，确保最新 gate 结果）。
Step 1: 对抗验证（AdversarialVerifier）
- 对 synthesis 统稿跑对抗检查，结果写入
bp_verification_result.json
- 优先级：
bp_synthesis.md > bp_final_report.md > 无可用文本时 FAIL
Step 2: Delivery Gate（bp_delivery_gate.py，8 项检查）
| 检查项 | 阻断规则 |
|---|
| final_assembly | 不存在或 ok=False → 硬阻断 |
| readability | 非 PASS → deferred_fixes，不阻断 |
| claim_coverage | PASS_WITH_DISCLOSURE → deferred；repair_exhausted → 降级 WARN；未 repair 的 FAIL → 硬阻断 |
| wave evidence gates (1-4) | repair_exhausted / blocking_claims_degraded → deferred，不阻断 |
| debate_review | FAIL_BLOCKING → 硬阻断；WARN → deferred，不阻断 |
| cross_dimension | FAIL 或非 PASS → 硬阻断 |
| verification | T1/T2 FAIL → deferred；T3+ FAIL → 硬阻断 |
| sidecar JSON | 损坏 → 记录但不阻断 |
checks 有 FAIL → ok=False，管线终止deferred_fixes → 写入 delivery_deferred_fixes.json，允许交付
Step 3: 产物生成（gate 通过后）
- 主报告 DOCX：
build_bp_dd_report() 用 synthesis 统稿（fallback 到 final_report）→ delivery/{entity}BP投资备忘录.docx
- 8 维度独立 DOCX：
build_bp_dimension_docx() → delivery/维度分析/{维度标题}.docx
- 双模式 MD：
{entity}BP投资备忘录.md（synthesis 叙事版）+ {entity}BP审计底稿.md（assembler 骨架）
- 维度分析文件夹副本：统稿 DOCX + 统稿 MD + 审计底稿 MD 复制到
delivery/维度分析/00.*
- 附件收集：xlsx 等文件复制到 delivery/
- StateStore 注册：所有产物注册 artifact
- 审计日志：
bp_delivery_audit.json
Step 4: 交付链路（管线外）
- 管线只写文件 + 返回路径，不做"推送到用户"
- kernel → orchestrator → 主 AI 拿到 result dict → 主 AI 用
present_files 呈现给用户
deliver_to_user: True 只是标记"可以交付"，实际交付动作在主 AI 层
交付产物清单（delivery/ 目录）：
delivery/
├── {entity}BP投资备忘录.docx ← 主报告 (build_bp_dd_report)
├── {entity}BP投资备忘录.md ← 叙事版 (给决策者)
├── {entity}BP审计底稿.md ← assembler 骨架 (给尽调团队)
├── bp_delivery_audit.json ← 交付审计
├── delivery_deferred_fixes.json ← 降级放行项 (如有)
├── {job_id}_*.xlsx ← Excel 附件 (数量不定)
└── 维度分析/
├── 00. 统稿投资备忘录.docx ← 主报告副本
├── 00. 统稿投资备忘录.md ← 统稿 MD 副本
├── 00. 审计底稿.md ← 审计底稿副本
└── 1-8. {维度标题}.docx ← 8 个维度独立 DOCX
Gate 硬阻断时：deliver_to_user: False + block_reason + bp_delivery_audit.json（mode: delivery_blocked_by_gate）
核心约束
- 不搜索新数据 — 只基于 step0_tech~step7_risk + 预计算数据
- 不编数据 — 不够标
[数据不足]
- 不跳过验证 — consistency + adversarial 是硬规则
- 交付必须清洗 — 绝不暴露内部工作流信息
- 估值假设锚定 — 偏差 >20% 需告警
- 搜索未果≠不存在 — 搜不到不代表没有，标注并继续
- 脚注不得丢失 — 子代理 [^N] 标记必须保留到最终 DOCX，正文+末尾都要有
References（按需加载）
| 触发条件 | 读取文件 |
|---|
| IR 统稿写作规范/事故教训 | ../../references/quality/ir-writing-standards.md |
| BP 统稿防缺陷规则 | ../../references/quality/bp-anti-defect-rules.md |
| 交付协议/微信推送/产物归档 | ../../references/delivery/delivery-protocol.md |
| BP OCR 配置 | ../../references/operations/bp-ocr-config.md |
