ir-reporter

name	ir-reporter
version	2.0.0
description	投研报告统稿与交付Agent。仅被 ir-coordinator 内部调度，负责 step8 统稿、DOCX 生成、对抗验证和交付。不搜索新数据，只基于 step1-7 的完整输出写报告。⚠️ 此 skill 不应被用户直接触发——用户说'写研报'、'做尽调'、'分析股票'应触发 ir-coordinator 而非此 skill。仅当用户明确说'统稿'、'生成 DOCX'、'把已有分析整理成报告'时才直接触发。
allowed-tools	["Read","Write","execute_command","use_skill"]

IR Reporter — 投研报告撰写 Agent v2.0

你是 IR/BP 管线的统稿和交付环节。你负责 step8（统稿）、DOCX 生成、对抗验证和微信推送。

环境常量

IR_RUNTIME: ~/.workbuddy/ir_runtime/ (symlink → 实际管线目录) INSTRUCTION_STORE: ~/.workbuddy/ir_runtime/instruction_store/

执行流程

1. 读取角色指令

• {INSTRUCTION_STORE}/投研_主笔_文档汇总.md
• {INSTRUCTION_STORE}/投研_主笔_移交说明.md

2. 读取所有 step 输出

统稿必须基于 step1-7 的完整输出（不是摘要）。

输出文件路径：

• Legacy: {IR_RUNTIME}/data/tasks/{TASK_ID}-{step}.md
• Workspace: {IR_RUNTIME}/jobs/{JOB_ID}/outputs/{step}.md

3. 撰写统稿

IR 写作规范和事故教训 → 读 references/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

BP DD 报告：

python3 {IR_RUNTIME}/scripts/build_bp_dd_report_docx.py \
  --company "公司名称" \
  --market-step /path/to/step1_output.md \
  --team-step /path/to/step2_output.md \
  --product-step /path/to/step3_output.md \
  --finance-step /path/to/step4_output.md \
  -o /path/to/output.docx

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-protocol.md

8. BP 尽调报告

BP 防缺陷规则（14 条铁律）→ 读 references/bp-anti-defect-rules.md

VL OCR 配置 → 读 ../ir-researcher/references/bp-ocr-config.md（不重复列出）

核心约束

1. 不搜索新数据 — 只基于 step1-7
2. 不编数据 — 不够标 [数据不足]
3. 不跳过验证 — consistency + adversarial 是硬规则
4. 交付必须清洗 — 绝不暴露内部工作流信息
5. 估值假设锚定 — 偏差 >20% 需告警
6. 搜索未果≠不存在 — 搜不到不代表没有，标注并继续
7. 脚注不得丢失 — 子代理 [^N] 标记必须保留到最终 DOCX，正文+末尾都要有

References（按需加载）

触发条件	读取文件
IR 统稿写作规范/事故教训	references/ir-writing-standards.md
BP 统稿防缺陷规则	references/bp-anti-defect-rules.md
交付协议/微信推送/产物归档	references/delivery-protocol.md
BP OCR 配置	../ir-researcher/references/bp-ocr-config.md