| name | article_draft |
| description | 根据会话中已完成的数据分析结果，逐章生成结构完整的科研论文初稿（含摘要、引言、方法、结果、讨论、结论），并将各章节保存为工作区文件 |
| category | report |
| research-domain | general |
| difficulty-level | advanced |
| typical-use-cases | ["基于实验数据自动生成论文初稿","将统计分析结果整理为标准学术论文格式","生成可供人工润色的结构化论文草稿"] |
| allowed-tools | ["ask_user_question","data_summary","dataset_catalog","list_workspace_files","stat_test","stat_model","stat_interpret","chart_session","edit_file","workspace_session","report_session","code_session","task_state","analysis_memory","export_document","export_report"] |
科研文章初稿生成工作流
本技能指导 Agent 基于当前会话中已完成的数据分析，逐步生成完整的科研论文初稿。
执行前提
在调用本技能前，用户应已完成：
- 兼容旧工作流时，
data_summary 可视为 dataset_catalog 的等价入口
- 数据加载（
dataset_catalog）
- 至少一项统计分析（如
stat_test、stat_model、code_session、chart_session 等）
- 可选：图表生成（
chart_session 或复杂场景下的 code_session）
工作流步骤
第一步：收集数据与分析概况
调用 dataset_catalog 获取已加载数据集的基本统计信息（样本量、变量列表、缺失值等）。
若用户已描述分析目标，结合会话历史中已生成的统计结果（t 值、p 值、回归系数、相关系数等）作为写作素材。
第二步：解读统计结果（如需要）
若会话中有统计分析结果但尚未进行文字解读，调用 stat_interpret 生成结果的自然语言描述，作为「结果」章节的写作依据。
第三步：生成配图（如需要）
根据分析类型补充必要图表：
- 回归分析 → 散点图 + 回归线（
chart_session 或 code_session）
- 差异分析 → 箱线图（
chart_session）
- 相关分析 → 热力图（
chart_session 或 code_session）
第四步：确定文件名并创建文章
4.1 智能生成文件名
基于以下信息生成语义化文件名：
- 数据集名称（如
blood_pressure_data → 提取 "blood_pressure"）
- 研究主题/分析目标（如 "心率与血压相关性研究"）
- 主要分析变量（如 "t_test_group_comparison"）
文件名格式：{主题关键词}_{日期}.md
示例：
heart_rate_blood_pressure_correlation_20250302.mdgroup_comparison_analysis_20250302.mddiabetes_clinical_study_20250302.md
4.2 向用户确认文件名（推荐）
生成文件名后，先向用户展示建议的文件名，询问是否需要修改：
"我将为您生成科研论文初稿，建议保存为：heart_rate_blood_pressure_correlation_20250302.md。您确认使用此文件名，或希望修改为其他名称？"
如用户指定了文件名，使用用户提供的名称（自动添加 .md 扩展名）。
4.3 创建初始文件
使用 workspace_session（operation=write）创建文件，写入文章标题和结构大纲：
兼容旧工作流描述时，可将 edit_file 视为 workspace_session 的文件写入/追加能力封装。
然后使用 workspace_session（operation=append）依次追加各章节内容：
摘要（Abstract）
- 约 250 字
- 包含：研究背景、目的、方法、主要结果、结论
- 格式：单段落，不分小节
引言（Introduction）
- 约 400-600 字
- 包含：研究背景与意义、现有研究局限、本研究目的与假设
方法（Methods）
- 约 300-500 字
- 包含：研究设计、数据来源与样本描述、统计分析方法（明确说明所用检验方法及软件）
结果（Results）
- 约 400-600 字
- 包含：描述性统计（引用
dataset_catalog 结果）、推断性统计（引用 stat_interpret 结果，汇报统计量、p 值、效应量）
- 图表嵌入：使用 Markdown 图片引用语法直接嵌入图表，格式如下：
## 图表
### 图 1：{图表描述标题}
### 图 2：{图表描述标题}
- 图表 URL 获取方式：调用
workspace_session(operation="list") 获取图表的 download_url
- 若沿用旧提示词，
list_workspace_files 对应当前 workspace_session(operation="list")
- 优先使用工具返回的实际
download_url；不要通过 code_session 枚举工作区目录
- 支持的图表格式：PNG、JPEG、SVG 等图片格式可直接渲染；HTML 格式使用链接
[查看交互图表](url)
- 正文中引用图表时使用「如图 1 所示」格式
讨论（Discussion）
- 约 500-700 字
- 包含：主要发现解释、与已有研究的比较、局限性分析、未来研究方向
结论（Conclusion）
- 约 100-200 字
- 简明概括研究贡献与主要发现
参考文献（References）
- 使用 APA 7th 格式（如用户未指定）
- 仅列出文中实际引用的文献；若无具体文献信息，标注「[待补充]」占位
第五步：导出文档（可选）
若用户需要 DOCX 或 PDF 格式：
- 若工作区中已经存在文章草稿 Markdown 文件，优先调用
export_document
- 仅当用户明确要求重新生成标准结构化分析报告时，再调用
report_session
export_report 仅在明确需要 PDF/DOCX 导出且已有报告资源时使用
输出规范
- 文件名：基于研究主题智能生成语义化文件名，格式
{主题关键词}_{日期}.md（如 heart_rate_analysis_20250302.md），保存前向用户确认
- 文件位置：保存于工作区根目录
- 语言：默认与用户对话语言一致；学术惯例需英文时使用英文
- 统计结果格式：
t(df) = x.xx, p = .xxx, d = x.xx（APA 风格）
- 图表嵌入：使用 Markdown 图片语法
 直接嵌入，便于直接预览
- 写入方式：每次 append 调用写入一个完整章节，避免超长单次写入
注意事项
- 不捏造数据：所有统计量必须来自会话中实际执行的分析结果
- 数据缺失处理：若某项分析数据缺失，在对应章节标注「[数据待补充]」
- 参考文献：若用户已提供参考文献，优先使用；否则标注占位符
- 文件名确认：生成文件前，建议先向用户展示建议的文件名并确认，提升用户体验
- 图表嵌入技巧：
- 优先使用 Markdown 图片语法
 嵌入，可在文档中直接预览
- 使用
workspace_session(operation="list") 获取工作区中图表结果文件的实际 download_url
- 如有多张图表，按顺序编号并添加描述性标题
- 完成提示：生成完毕后，主动告知用户文件位置、文件名，并询问是否需要进一步修改
示例：完整执行流程
假设用户已完成心率与血压的相关性分析，会话中有数据集 heart_data.csv 和相关性图表。
Step 1: 生成并确认文件名
Agent: 我将为您生成科研论文初稿。
根据分析内容（心率与血压相关性研究），建议文件名为：
`heart_rate_blood_pressure_correlation_20250302.md`
您确认使用此文件名，或希望修改？
Step 2: 创建文件并写入标题和大纲
workspace_session(
file_path="heart_rate_blood_pressure_correlation_20250302.md",
operation="write",
content="# 心率与血压相关性研究\n\n## 摘要\n\n[待补充]\n\n## 引言\n\n[待补充]\n..."
)
Step 3: 逐章追加内容
每章使用 workspace_session(operation="append") 追加。
Step 4: 嵌入图表
在「结果」章节中嵌入图表：
## 结果
### 描述性统计
心率均值 = 75.2 ± 8.5 bpm，血压均值 = 125.3 ± 15.2 mmHg...
### 相关性分析
如图 1 所示，心率与收缩压呈显著正相关（r = 0.62, p < 0.001）...
## 图表
### 图 1：心率与血压散点图
### 图 2：相关性热力图
Step 5: 告知用户完成
Agent: 论文初稿已生成并保存为 `heart_rate_blood_pressure_correlation_20250302.md`。
文件包含摘要、引言、方法、结果（含图表）、讨论、结论和参考文献共 7 个章节。
您可以直接在文档中查看嵌入的图表，或告诉我需要修改哪些内容。
