| name | long_document_workflow |
| description | Use when user requests to generate a long document with specific topic and format. This skill provides a structured workflow for creating well-organized, multi-section documents with consistent formatting. |
长文档生成工作流技能
概述
本技能提供了一个系统化的长文档生成工作流，允许用户指定主题、格式和结构，生成结构清晰、内容连贯的长文档。
触发条件
当用户需要生成以下类型的长文档时使用：
- 技术文档、报告、白皮书
- 项目计划书、提案
- 学术论文、研究报告
- 用户手册、教程
- 商业计划书
- 任何需要结构化格式的长篇内容
触发关键词：生成文档、创建报告、写论文、制作计划书、长文档工作流
执行步骤
第1步：需求收集
-
询问用户文档的以下信息：
- 主题：文档的核心主题是什么？
- 目的：文档的主要用途是什么？（如：汇报、指导、分析、提案等）
- 目标读者：文档面向谁？（如：技术人员、管理层、普通用户、学术同行等）
- 长度要求：大致需要多少字或多少页？
- 格式偏好：是否有特定的格式要求？（如：Markdown、HTML、纯文本、特定模板）
-
如果用户没有明确说明，提供建议选项。
第2步：结构设计
-
基于收集的信息，设计文档大纲：
- 创建层次化的章节结构（通常3-5级）
- 确保逻辑连贯性（引言→主体→结论）
- 考虑读者的阅读路径
-
向用户展示建议的大纲，获取反馈和修改意见。
第3步：内容生成
-
按照批准的大纲，逐章节生成内容：
- 从引言开始，明确文档目的和范围
- 主体部分按逻辑顺序展开
- 确保各部分之间有平滑的过渡
- 保持一致的术语和风格
-
对于技术性内容，可以：
- 使用代码块展示示例
- 添加图表说明（用文字描述图表内容）
- 引用相关概念时提供简要解释
第4步：格式化和增强
-
根据用户选择的格式进行格式化：
- Markdown格式：使用适当的标题级别、列表、代码块、表格等
- HTML格式：生成结构良好的HTML文档，包含基本样式
- 纯文本格式：保持清晰的分段和缩进
-
添加文档元素：
- 标题页（包含标题、作者、日期）
- 目录（如果文档较长）
- 章节编号
- 必要的脚注或尾注
第5步：质量检查
-
检查文档的：
- 结构完整性（所有章节是否完整）
- 内容一致性（术语、风格是否统一）
- 逻辑连贯性（论证是否合理）
- 格式正确性（格式是否符合要求）
-
提供摘要报告，说明文档的特点和注意事项。
输出格式
文档应以清晰的结构化格式输出，包含：
- 元信息：主题、生成日期、估计字数
- 文档结构：显示大纲层次
- 完整内容：格式化的文档正文
- 质量摘要：简要说明文档的特点和建议
示例对话
示例1：技术报告生成
用户：帮我生成一份关于"人工智能在医疗诊断中的应用"的技术报告
Agent：好的，我将使用长文档工作流为您生成这份报告。首先，请告诉我：
- 这份报告的主要目的是什么？（如：技术综述、应用分析、趋势展望）
- 目标读者是谁？（如：医疗专业人员、技术人员、管理人员）
- 大致需要多少字？
- 您希望用什么格式？（Markdown、HTML或其他）
用户：目的是技术综述，面向医疗技术人员，大约3000字，用Markdown格式
Agent：收到。基于您的需求，我建议以下结构：
- 引言（AI在医疗诊断的发展背景）
- 核心技术方法（机器学习、深度学习、图像识别等）
- 主要应用领域（医学影像、病理分析、辅助诊断等）
- 技术挑战与限制
- 未来发展趋势
- 结论
您对这个结构有什么修改意见吗？
用户：很好，请开始生成
Agent：（生成完整的Markdown格式报告...）
示例2：项目计划书
用户：我需要一个"智能家居系统开发"的项目计划书
Agent：我将为您创建项目计划书。请说明：
- 计划书的详细程度？（概要版还是详细版）
- 包含哪些部分？（如：项目概述、目标、时间线、预算、风险评估等）
- 格式要求？
- 是否有特定的模板需要遵循？
常见错误处理
- 主题不明确：通过提问帮助用户明确具体方向
- 结构过于复杂：建议简化结构，确保可读性
- 内容重复：检查并合并重复的部分
- 格式问题：根据目标格式调整样式
最佳实践
- 渐进式生成：先确认大纲，再生成内容
- 保持一致性：使用统一的术语和风格
- 考虑可读性：避免过长的段落，适当使用列表和标题
- 提供灵活性：允许用户在生成过程中调整需求
- 质量优先：宁可内容精简但质量高，不要冗长但质量低
注意事项
- 对于非常长的文档（超过5000字），建议分阶段生成
- 技术性文档需要确保术语准确
- 商业文档需要突出关键信息和价值主张
- 学术文档需要严谨的论证和引用
