研究报告撰写

这个技能做什么

基于用户指定的知识库素材，按用户临时指定的报告框架，撰写面向人工智能、机器人、国内外前沿科技等领域的高质量研究报告。报告采用学术书面风格，逻辑严谨、语言通顺，仅在关键处做少量引用标注，文末附参考文献，成品可直接使用。

核心原则（为什么这样做）

• 框架由用户指定：框架是报告的结构骨架。每次动笔前必须先确认框架——用户指定什么就用什么，不擅自替换；用户未指定时，展示框架要素清单（见 references/frameworks.md）引导其选择或组合。
• 篇幅随框架确认：框架确定后，与用户确认字数范围（如 3000~5000 字），将其作为本次任务的硬约束，撰写时严格遵守。
• 知识库为素材主源：报告的事实、数据、观点优先来自用户知识库，保证有据可依。知识库不足以支撑某章节时，才提议联网搜索补充，且必须先征得用户同意。
• 两道确认门：① 框架与篇幅确认（取材前定稿）；② 大纲确认（撰写前定稿）。已确认的内容不中途变更，变更需回到确认门。
• 引用克制：只对关键论断、具体数据、重要观点标注出处，不逐句标注，避免干扰阅读。

你的工作方式

研究报告撰写按以下顺序执行：

1. 需求理解与框架确认
2. 定位知识库与深度取材
3. 大纲规划（确认门）
4. 分章撰写
5. 整合与交付

Phase 1：需求理解与框架确认

明确五项基本信息：

框架处理逻辑：
- 用户已给出框架 → 完整记录章节层级与每节要点，与用户复述确认。
- 用户未给出框架 → 读取 references/frameworks.md，向用户展示常见章节要素与领域示例框架，请其选择、组合或自行提出；不替用户默认一套框架。
- 用户仅给出"大致方向"（如"按技术、应用、趋势来写"）→ 基于其描述细化成完整框架，回读确认。

篇幅确认： 框架确定后，主动询问用户期望的字数范围（若用户已说明则跳过），记入本次任务约束。

联网搜索确认入口： 在需求确认阶段即询问用户"是否需要联网搜索补充素材"（是/否）。用户允许 → 取材不足时自动执行 web 搜索补充；用户不允许 → 严格基于知识库撰写，缺口章节如实注明资料局限。该选项一旦确认，作为本次任务约束，取材阶段不再重复询问。

产出： 确认后的框架 + 字数范围 + 联网搜索选项，作为后续所有步骤的依据。

Phase 2：定位知识库与深度取材

定位知识库：
- 用户指定了知识库名称 → 通过 ima-knowledge 技能获取 kb_id。
- 用户未指定 → 询问用户要基于哪个知识库；若当前场景明确（如用户在某个知识库内），使用当前场景知识库。

深度取材：
- 用 search(source="kb", kb_id=...) 检索主题相关内容，覆盖框架各章节所需关键词。
- 用 fetch 读取高相关条目的全文，提取：核心事实、数据、观点、关键表述。
- 边读边记来源：为每条可用素材记录来源标识（条目标题/文件名），供引用标注与参考文献列表使用。
- 素材在多个条目中重复时，保留最权威、最完整的来源。

联网补充（条件分支）：
- 取材后检查：框架中各章节是否有足够素材支撑。
- 若某章节素材明显不足 → 向用户列出缺口清单，询问："知识库中 XX 方面的资料不足，是否需要我联网搜索补充？"
- 用户同意 → 执行 search(source="web")，将网页来源与知识库来源统一记录，标注时区分。
- 用户拒绝 → 以知识库现有内容为准撰写，在报告相应章节如实注明资料局限（如"受公开资料所限，本章仅基于现有知识库内容"）。

产出： 组织好的素材清单（要点 + 来源标识），按框架章节归类。

Phase 3：大纲规划（确认门）

• 按已确认框架，结合素材清单生成详细大纲：章节 → 小节 → 每节写作要点与拟用素材、引用来源。
• 大纲中标注哪些章节素材充足、哪些较薄弱（便于用户决定是否补充）。
• 将大纲提交用户确认：用户确认后进入撰写；用户提出调整则修改大纲后重新确认。

产出： 经用户确认的详细大纲。

Phase 4：分章撰写

• 按确认后的大纲逐章撰写，遵守下文《写作规范》。
• 建议撰写顺序：先写主体分析章节（素材最充分的章节），再写引言/背景，最后写摘要与结论——摘要和结论需覆盖全文，最后写能保证准确。
• 撰写时素材与论点一一对应：每个关键论断找到支撑素材；素材中没有的内容不凭空发挥。
• 引用标注随写随标，编号按出现顺序递增。

Phase 5：整合与交付

• 整合全文，做整体检查：
• 章节逻辑连贯，过渡自然，无断裂或重复
• 每章论点有素材支撑，无无据断言
• 引用编号连续无跳号，参考文献与文内标注一一对应
• 语言风格全文统一（学术书面）
• 补充"参考文献"章节（按编号排序）。
• 交付形式：默认直接在对话中输出完整报告正文（Markdown）；用户要求文件时，保存为 研究报告-主题-YYYY-MM-DD.md 至 /sandbox/workspace/，用 provide_file 提供下载。

写作规范

学术书面风格

• 语言：书面化、严谨、平实；避免口语、情绪化表达与夸张修辞（如"震惊""颠覆"）。
• 逻辑：每节有明确论点，论证分层展开，多用总—分—总结构；段落间用过渡句衔接；章节间保持递进或并列关系清晰。
• 用词：专业术语规范统一，首次出现给出简明定义（如"智能体""大语言模型"）；避免中英混杂。
• 数据：涉及数据、比例、年份等信息必须来自素材并有来源；严禁编造数据。
• 客观性：呈现观点时区分"事实"与"判断"；对国内外情况的描述保持中立表述。

引用标注规范

• 标注位置：仅对关键论断、具体数据、引述观点标注出处。
• 格式：文内以上标编号 [1]、[2] 标注，按出现顺序连续编号；文末"参考文献"章节列出对应来源（知识库条目标题，或网页标题 + 链接）。
• 数量控制：全文标注 5~15 处为宜，宁少勿滥；无明确来源的内容不强行标注。
• 来源区分：知识库素材与联网素材在参考文献中一并列出，格式统一，不伪造来源信息。

报告整体结构

• 默认包含：标题 → 摘要（浓缩背景、核心发现、结论）→ 正文（按用户框架）→ 参考文献。
• 摘要控制在 200~300 字，独立成段，不出现引用标注。

示例场景

示例 1：用户指定完整框架
用户："基于'机器人实战'知识库写一份人形机器人产业发展报告，框架：1.发展背景 2.关键技术现状 3.国内外产业格局 4.挑战与趋势 5.结论建议，4000 字左右"
→ 复述确认框架与篇幅 → 获取"机器人实战"kb_id → 知识库取材 → 生成大纲并确认 → 按 5 章撰写 → 引用标注 → 交付全文。

示例 2：用户只有主题，需要引导
用户："帮我写一份人工智能发展方向的分析报告"
→ 询问报告类型与目标读者 → 展示框架要素清单请用户选框架（或提出自己的）→ 确认篇幅与联网搜索选项 → 取材 → 大纲确认 → 撰写 → 交付。

示例 3：知识库素材不足
取材后发现"国内外前沿科技对比"章节素材稀缺 → 向用户列出缺口并询问是否联网补充 → 用户同意 → web 搜索补充 → 素材合并 → 继续流程；用户拒绝 → 以知识库内容为准撰写，在章节注明资料局限。

常见问题处理