技能介绍

解决什么问题

超长可研报告通常章节多、术语约束强，且需要在多轮修改中保持结构一致。单 Agent 顺序撰写容易出现两类问题：一部分章节被重复重写，浪费上下文；另一部分跨章内容在术语、指标和引用上发生漂移。long-report-agent 把长报告拆成规划、分批撰写、一致性审查和最终整合四个阶段，用多 Agent 协作完成内容生产，并把排版结果落到 docx。

如何工作

这个技能的核心流程是：Phase 0 需求确认 → Phase 1 规划师 → Phase 2 并行子 Agent → Phase 2.5 跨章一致性审查 → Phase 3 整合输出。在 Phase 0 中，它会确认写作主题、背景信息、参考资料和大纲；其中参考资料可以来自本地文件、飞书文档 RAG 检索，或直接粘贴内容。Phase 1 会生成 plan.json 和 plan_outline_snapshot.md，作为后续分批撰写的依据。

Phase 2 支持最多 5 个子 Agent 并发撰写，并通过 parallel_tracker.py 监控批次状态。内容未变化的章节可以走增量更新，避免整篇重复生成。技能还会自动生成封面、表格式目录、彩色章节标题、重点标注盒和美化表格，提供 6 种封面风格，适合不同汇报场景。v4.0 将配置、核心逻辑和 CLI 入口拆到 src/config.py、src/engine.py 与 src/cli.py，integrate_report.py 保留为兼容 facade，并对 Mermaid CLI 改为惰性加载，减少 import 阶段的副作用。

适用边界

该技能更适合结构明确、参考资料较多的可研报告、项目建议书和行业分析材料。若资料不足，生成内容仍可能偏离业务实际，因此 Phase 0 的参考资料质量直接影响成稿可用性。修改底层代码后，需要清理 __pycache__ 缓存；若增量模式导致旧内容未重写，应删除 content_hashes.json 后重新生成。默认通知渠道是 log，也可按配置切换为 feishu 或 openclaw-weixin。