SuperAPI AI 工具集

doc-coauthoring

写作与研究

查看项目

更新于 10-16 04:41

技能介绍

用途

doc-coauthoring 是一个协作式文档创作工作流技能,用于引导用户完成文档、文章或长文内容的共同撰写。当用户提到写文章、写文档、co-authoring,或提供素材并要求创作内容时,可以启用该工作流。技能建议在简短说明流程后直接开始,不要过度解释。

主要能力

该技能将协作写作分为三个阶段:

阶段一:上下文收集(Context Gathering)

目标是快速获取足够上下文,包括内容方向和写作风格。

元信息(必问):文档类型(公众号/小红书/技术文档/提案)、目标读者、读完后的预期效果、个人观点或角度、篇幅和风格。

写作风格偏好(必问):是否有参考资料(如有则先分析其风格并遵循)、偏简洁还是详细、有什么写作习惯需要遵守。提前确认风格可避免后续反复修改。

参考资料风格分析:如果用户提供参考资料,先读取并分析其句式特点(短句为主还是长句为主)、结构方式(有无小标题、段落长度)、语气(口语化还是正式)。分析完成后告知用户“参考资料风格已学习,后续写作会遵循”。

常见写作反模式(默认避免):自问自答句式、过度对比(“不是……而是……”连用多次)、小标题分割案例、设问开头、重复总结、过度解释。用户说“太啰嗦”时,立刻精简,不要解释。

素材处理:如果用户提供素材文件,直接读取并提取关键信息,不要过度询问,直接进入下一阶段。如果需要补充信息,可以搜索互联网获取热门观点、案例、数据,主动搜索,不要每次都问“要不要搜索”。

退出条件:用户回答完元信息问题后,直接进入阶段二,不要反复确认。

阶段二:精炼与结构(Refinement & Structure)

目标是逐章节头脑风暴、筛选、撰写、迭代。

确定结构:根据文档类型建议 3-6 个章节,创建 Markdown 文件框架,用 [待撰写] 占位。

每章节流程:

  1. 头脑风暴:列出 8-15 个可能包含的点,编号呈现,询问保留哪些。
  2. 筛选:用户回复选择后,如果用户说“全部”或“1-N”,直接全部采用,不再确认;如果选择部分,只用选中的。不要追问“确定吗”,直接进入撰写。
  3. 撰写:根据筛选结果撰写该章节,直接更新文件。撰写完成后展示该章节内容(引用块格式),简短询问“有想改的吗?没问题就「继续」”。
  4. 迭代:用户说“继续”则进入下一章节;“太啰嗦”则立刻精简,不解释;“不要xxx句式”则记住,后续章节也遵守;具体修改意见则执行修改并展示结果。迭代要快,用户给反馈后立刻改,改完立刻展示,不要长篇解释。

风格学习:在迭代过程中记住用户的风格偏好,用户删掉了什么则后续避免,用户说“太啰嗦”则后续更精简,用户说“不要自问自答”则所有章节都避免。

完成所有章节后:输出全文供用户通读,询问是否需要调整。

阶段三:读者测试(Reader Testing,可选)

目标是用新鲜视角检查文档是否清晰。仅当用户要求时执行,或文档较长/较复杂时建议。执行方式:预测读者可能的问题(5-10 个),用 sub-agent 或建议用户开新对话测试,发现问题则回到阶段二修复。

使用方式

该技能以工作流形式引导用户,通过对话逐步完成文档创作。用户只需回答元信息问题、选择头脑风暴要点、提供修改反馈即可。技能会创建 Markdown 文件框架并逐章节更新内容。

适用场景

适合需要结构化协作写作的场景,包括撰写公众号文章、小红书内容、技术文档、提案等长文内容。尤其适合用户提供素材或参考资料,希望快速产出符合特定风格文档的情况。

限制

该技能为工作流指导,具体写作质量取决于用户提供的上下文和反馈。读者测试阶段为可选,且需要用户主动要求或文档较长/较复杂时才建议执行。技能默认避免某些写作反模式,但用户明确要求时可以调整。