diff --git a/backend/package/yuxi/agents/skills/buildin/__init__.py b/backend/package/yuxi/agents/skills/buildin/__init__.py index 1dbc73a0..b32ff90b 100644 --- a/backend/package/yuxi/agents/skills/buildin/__init__.py +++ b/backend/package/yuxi/agents/skills/buildin/__init__.py @@ -21,6 +21,13 @@ class BuiltinSkillSpec: _SKILLS_ROOT = Path(__file__).resolve().parent BUILTIN_SKILLS: list[BuiltinSkillSpec] = [ + BuiltinSkillSpec( + slug="deep-reporter", + source_dir=_SKILLS_ROOT / "deep-reporter", + description="指导生成科研报告、行业调研和其他需要深度分析的结构化长报告。", + version="2026.03.28", + tool_dependencies=["tavily_search"], + ), BuiltinSkillSpec( slug="reporter", source_dir=_SKILLS_ROOT / "reporter", diff --git a/backend/package/yuxi/agents/skills/buildin/deep-reporter/SKILL.md b/backend/package/yuxi/agents/skills/buildin/deep-reporter/SKILL.md new file mode 100644 index 00000000..1c991ee6 --- /dev/null +++ b/backend/package/yuxi/agents/skills/buildin/deep-reporter/SKILL.md @@ -0,0 +1,62 @@ +--- +name: deep-reporter +description: "指导生成科研报告、行业调研、技术分析等需要深度研究的长篇报告。当任务目标是形成结构化、可引用、具有分析深度的正式报告时使用此技能。" +--- + +# 深度报告技能 + +当用户要求产出科研报告、课题综述、行业研究、技术选型分析、竞争对比、专题调研或其他正式长报告时,使用此技能组织研究与写作过程。 + +## 适用场景 + +- 科研论文综述、研究进展梳理、方法比较 +- 技术报告、方案评估、架构选型分析 +- 行业研究、竞品分析、政策与市场调研 +- 基于用户附件、知识库、网页资料整理深度报告 + +## 操作流程 + +1. 明确报告目标、读者对象、范围边界、输出语言与交付形式 +2. 若问题仍然模糊,先向用户补充确认关键范围,再开始研究 +3. 优先从用户提供的材料、知识库、可用工具检索结果中收集证据,必要时再补充外部资料 +4. 先整理报告提纲,再分章节归纳事实、方法、数据、观点与局限 +5. 在正式写作前检查证据是否足够支撑结论,避免只堆砌材料 +6. 输出完整报告,包含清晰章节、分析结论、引用来源,必要时附表格或图片 + +## 报告要求 + +- 报告语言必须与用户提问语言一致 +- 优先使用正式、克制、可复核的书面表达,不要口语化 +- 必须围绕“问题定义 -> 证据整理 -> 分析比较 -> 结论建议”组织内容 +- 章节要完整,避免只有结论没有论证,或只有资料堆积没有分析 +- 当信息不足时,应明确指出证据缺口与不确定性,不要臆断 +- 当用户要求“科研报告”时,应重点覆盖研究背景、问题定义、相关工作/现状、方法或方案比较、实验或案例证据、局限性、结论与后续方向 +- 当用户要求“深度报告”但未限定类型时,应根据主题自适应组织章节,不必强行套科研论文结构 + +## 推荐结构 + +可根据任务类型调整,但通常应包含以下内容中的大部分: + +1. 标题与摘要 +2. 背景与问题定义 +3. 研究范围、对象与评估维度 +4. 关键事实、数据与资料整理 +5. 方法、方案、产品或观点的分项分析 +6. 横向比较与优劣权衡 +7. 风险、限制与不确定性 +8. 结论 +9. 建议或下一步行动 +10. 来源 + +## 引用规范 + +- 报告中的关键结论、数据、图表、观点应绑定来源 +- 使用 `[标题](URL)` 或清晰可追溯的文件路径引用材料 +- 在文末单独列出“来源”章节,汇总所有实际引用过的资料 +- 若引用用户附件或知识库文件,应标明对应文件名或路径 + +## 输出约束 + +- 最终结果应直接是一份可交付的报告,而不是“我准备怎么写” +- 不要暴露中间推理过程,不要把待办列表原样输出成正文 +- 除非用户明确要求,一般不要输出原始检索日志、原始笔记或未经整理的大段摘录 diff --git a/backend/test/test_skill_service.py b/backend/test/test_skill_service.py index fa99160e..164db123 100644 --- a/backend/test/test_skill_service.py +++ b/backend/test/test_skill_service.py @@ -508,6 +508,16 @@ def test_compute_dir_hash_does_not_use_read_bytes(tmp_path: Path, monkeypatch: p assert svc._compute_dir_hash(source_dir) +def test_builtin_skill_specs_include_deep_reporter(): + specs = svc.list_builtin_skill_specs() + deep_reporter = next(item for item in specs if item["slug"] == "deep-reporter") + + assert deep_reporter["name"] == "deep-reporter" + assert "深度" in deep_reporter["description"] + assert deep_reporter["source_dir"].is_dir() + assert (deep_reporter["source_dir"] / "SKILL.md").is_file() + + @pytest.mark.asyncio async def test_install_builtin_skill_ok(tmp_path: Path, monkeypatch: pytest.MonkeyPatch): monkeypatch.setattr(svc.sys_config, "save_dir", str(tmp_path)) diff --git a/docs/develop-guides/roadmap.md b/docs/develop-guides/roadmap.md index 2da47409..f9be5d12 100644 --- a/docs/develop-guides/roadmap.md +++ b/docs/develop-guides/roadmap.md @@ -43,6 +43,7 @@ - 新增 API Key 认证功能,支持外部系统通过 API Key 调用系统服务 - 新增 subagents 的支持,支持在 web 中添加 subagents,以及两个内置的子智能体 - 新增内置Skills reporter,并移除内置 Agent reporter,数据库报表将由 Skills 完成 +- 新增内置 Skills `deep-reporter`,用于指导生成科研报告、行业调研和其他深度分析类长报告 - 重构内置 Skills 安装机制:内置 skill 改为在管理页以“未安装”状态展示,支持按需安装、基于 `version + content_hash` 的更新提示与覆盖确认,并对已安装内置 skill 禁止在线文件编辑 - 新增知识库 PDF、图片的预览功能 - 优化扩展页工具列表筛选区:将“全部分类”筛选收纳为搜索框右侧的紧凑下拉入口,并复用扩展页侧栏工具条样式,避免影响其他管理组件布局