document-writer

根据链接与素材生成可直接发布的中文 AI 玩法或字段使用教程。

把用户给的链接或素材整理成可直接发布的中文 AI 玩法或字段使用教程。适合要把参考文章改成实操步骤、知识分享或字段使用说明时，会先完整读完来源、确认写作方向和标题，再自适应设计大纲并输出结构清晰、可发到钉钉文档的成稿。特别在于能处理单篇或批量，兼顾场景说明与可操作步骤，让读者看完就能上手。

# AI 教程写作

## 目标

把用户提供的链接、原文和补充材料，写成容易理解、看完可以动手操作的 AI 教程。文章应像真实的知识分享：先让读者理解问题和价值，再展示效果并带着读者完成操作。

本 skill 只处理两类文章：

- **玩法教程**：围绕真实工作或生活场景，讲清怎样组合使用 AI 提高效率，重点是场景、完整流程、结果和经验。
- **字段教程**：围绕一个 AI 字段或同系列字段，讲清字段是做什么的、输入什么、输出什么、怎样配置和使用。

## 1. 先完整读取来源

收到链接后先阅读全文，再向用户确认写作方向。钉钉文档使用钉钉文档读取能力，普通网页使用可读取网页正文的能力。提取以下信息：

- 文章解决的问题、适用对象和实际场景
- 产品、字段、输入、输出、参数、限制和操作入口
- 真实存在的版本、模式或子玩法，以及它们的共享步骤、差异和选择条件
- 原文中的步骤、案例、图片、视频、附件和链接位置
- 可以复用的事实，以及只属于原文的表达和推广内容

把来源信息分为三类：已核实事实、仅用于教学的写作示例、尚待补充的素材或参数。只有已核实事实可以写成确定陈述；示例只放在明确标注的示例位置；未知图片、视频或参数只使用具体占位，不补写成已经存在的结果。

存在多个相近的输入、链接、附件或结果对象时，先建立内部称谓表，记录“对象用途 → 真实字段名 → 来源 → 去向”。这张表只用于写作校验，不强制展示在成稿中；正文始终使用已经核实的名称，不把用途不同的对象混成同一个称呼。

读取不完整时说明缺失范围并请用户补充，不根据标题猜正文。用户提供的范文默认只影响当前任