Doc Generation

当需要将视频、音频、文章等内容转化为结构化 Markdown 文档时使用。 规范输出的格式、结构和内容密度。

iAmMccc Updated

File contents

文档生成规范

所有通过 AI 总结生成的文档,遵循以下结构和规范。

输出结构

# 标题

## 来源
- 链接:原始内容的 URL
- 作者:作者名(粉丝数,获赞数)
- 生成依据:仅原始内容 / 原始内容 + 评论区 + 用户补充信息

## 摘要
(2-3 句话,不超过 100 字)

## 要点
- 要点 1
- 要点 2
- ...

## 正文
(结构化的完整内容)

## 评论
(有价值的评论和讨论)

各部分要求

标题

  • 用内容本身的主题命名,不要用原始视频标题中的 hashtag
  • 简洁,不超过 30 字

来源

  • 必须标注原始链接
  • 有作者信息时必须标注
  • 标注生成依据

摘要

  • 2-3 句话,不超过 100 字
  • 用笔记的语气写,直接陈述核心观点,像是自己记的要点
  • 不要用「该内容」「该视频」「本文」等第三方视角的表述
  • 不要和要点重复

要点

  • 3-8 条,紧跟摘要之后
  • 每条一句话,不超过 30 字
  • 提炼关键信息,不是对正文的缩写
  • 不要编号描述(如「第一点是...」),直接写内容

正文

  • 用笔记的语气写,像是自己学习后的整理,而不是对别人内容的转述
  • 不要用「该方法」「该内容」「作者指出」等第三方报道的语气
  • 将口语化内容整理为书面表达,去掉语气词、重复、口误
  • 保留专业术语和关键信息
  • 用小标题分段,层次清晰
  • 评论区中有价值的信息(如注意事项、补充知识)融入正文
  • 不要在正文中重复摘要和要点的内容

评论

  • 保留有实质内容的评论和讨论
  • 作者的回复保留对话关系
  • 忽略纯求资源、纯表情、无实质内容的评论

禁止行为

  • 不要用第三方视角(「该视频讲解了」「作者分享了」),用笔记视角(直接陈述知识点)
  • 不要在摘要中写「本视频...」「本文...」「该内容...」
  • 不要在正文末尾加「补充信息」段落
  • 不要重复同一个观点(摘要、要点、正文三处只讲一次)
  • 不要添加原始内容中没有的信息(除非用户补充了或评论区有价值的补充)

iAmMccc/ai-essentials commit c72d586044

Frequently asked questions

npx skillmds@latest add iammccc/doc-generation