writing-guide

name	writing-guide
description	论文写作引导工作流，负责将当前会话中的分析结果桥接为可写作的素材包、 章节结构与分节撰写提示。适用于论文初稿、实验报告和结果章节整理。
category	workflow
research-domain	general
difficulty-level	advanced
typical-use-cases	["将统计分析结果整理为论文写作素材","先规划章节再逐节撰写结果与讨论","在无分析结果时切换为纯引导式写作"]
allowed-tools	["collect_artifacts","workspace_session","task_state","analysis_memory"]
user-invocable	true
disable-model-invocation	false
contract	{"version":"1","trust_ceiling":"t1","steps":[{"id":"collect_materials","name":"素材收集","description":"调用 collect_artifacts 收集统计结果、图表、方法记录和数据集概要","tool_hint":"collect_artifacts","depends_on":"[Truncated]","trust_level":"t1","review_gate":false,"retry_policy":"skip"},{"id":"plan_structure","name":"结构规划","description":"基于素材包确定论文结构、章节重点与证据分布","tool_hint":null,"depends_on":"[Truncated]","trust_level":"t1","review_gate":false,"retry_policy":"skip"},{"id":"write_sections","name":"分节撰写","description":"逐节生成写作提示，嵌入统计结果模板与图表引用占位","tool_hint":null,"depends_on":"[Truncated]","trust_level":"t1","review_gate":false,"retry_policy":"skip"},{"id":"review_revise","name":"修订复核","description":"检查数据与结论一致性，输出修订建议与缺口清单","tool_hint":null,"depends_on":"[Truncated]","trust_level":"t1","review_gate":false,"retry_policy":"skip"}],"input_schema":{"type":"object","properties":{"writing_goal":"[Truncated]","target_sections":"[Truncated]"}},"output_schema":{"type":"object","properties":{"materials_bundle":"[Truncated]","writing_outline":"[Truncated]","revision_notes":"[Truncated]"}}}

论文写作引导工作流

输出等级声明：本 Skill 的所有输出均为 O2 草稿级，仅用于协助作者整理写作思路，最终内容必须由作者审阅、改写并承担学术责任。

本 Skill 采用四步线性流程：素材收集 → 结构规划 → 分节撰写 → 修订建议。如果当前会话已有分析结果，优先复用真实统计值与图表；如果没有，则退化为纯引导模式，不得捏造结果。

第一步：素材收集（collect_materials）

1. 调用 collect_artifacts 获取结构化素材包，重点检查以下字段：
   • statistical_results
   • charts
   • methods
   • datasets
   • summary
2. 若 summary.mode == "pure_guidance"，必须明确说明：
   • 当前会话暂无可引用的统计结果或图表
   • 后续只能提供结构规划与写作提示，不能生成带真实数值的结果描述
3. 若已有分析产物，先整理成写作证据清单：
   • 哪些统计结果适合进入 Results
   • 哪些方法记录适合进入 Methods
   • 哪些图表适合在 Results / Appendix 中引用

第二步：结构规划（plan_structure）

根据素材包和用户目标，推荐论文结构。最小结构建议为：

1. 摘要
2. 引言
3. 方法
4. 结果
5. 讨论
6. 结论

规划时必须输出每章的输入来源：

• 方法章节：优先引用 methods
• 结果章节：优先引用 statistical_results 与 charts
• 讨论章节：基于结果做解释，但不得超出已有证据

如果用户只想写局部章节，应改写为章节级规划，例如只输出 Results + Discussion 的分节框架。

第三步：分节撰写（write_sections）

逐节引导作者撰写时，必须显式区分「可直接引用的真实结果」与「待作者补写内容」。

Results 章节模板

当 statistical_results 非空时，可使用如下模板：

### 主要结果
在 {dataset_name} 中，采用 {method_name} 得到 {test_statistic_label} = {test_statistic}，
p = {p_value}，效应量 {effect_type} = {effect_size}。

### 图表引用
如图 1 所示，{图表核心趋势或差异的文字描述}。

如果只有部分字段存在，缺失项必须改成占位提示，例如 [效应量待补充]，不得编造。

图表嵌入模板

![图1：{图表标题}]({download_url})

若图表为 HTML 或交互文件，则改为链接形式：

[查看图1：{图表标题}]({download_url})