用途:把粗糙、无结构的笔记转化为组织良好的可读文档,在保留原意的前提下补充标题、目录,改进表达与排版。触发场景包括用户想清理草稿、优化既有语雀文档排版,或把要点、碎片整理成完整文档。
依赖工具:全部来自 yuque-mcp 服务器,使用 yuque_get_doc 读取原文档,yuque_update_doc 写回优化后内容。
流程:先获取源笔记。若为语雀文档链接,从 URL 提取 repo_id 和 doc_id 后读取,参数为 repo_id、doc_id;若用户直接粘贴文本,则直接以文本为源,无需工具调用。遇到 404 或 403 应告知用户并停止。随后从结构、完整性、格式、可读性、组织五方面评估笔记,判断为轻度润色、中度整理还是重度重构。优化时补充标题与层级标题、重排内容、补引言,补全句子、修正语法、替换模糊表达,并用列表、代码块、表格、加粗、引用块统一格式。不得新增原文没有的信息或观点,不得删除作者内容,不得改动技术术语与专有名词,不得改变结论观点,未经要求不得过度正式化。完成后向用户展示优化概览、主要改动及完整文档。最后询问是否更新原文档;确认且来源为语雀文档时调用 yuque_update_doc,参数为 repo_id、doc_id、body,保存后确认结果。若来源为粘贴文本,则仅在对话中展示,用户想保存时询问知识库并使用 yuque_create_doc。应使用与原文一致的语言,保留 TODO 和未完成想法。
限制:文档不存在或无权访问时需停止;内容为空或过短(少于 50 字符)无法有效优化;更新失败时建议用户手动复制;文档结构已清晰时只做少量调整,不强改。语雀会自动保留历史版本。