# Doc Generation

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

- Skill: `iammccc/doc-generation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add iammccc/doc-generation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iammccc/doc-generation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: iAmMccc (https://skillmd.com/u/iammccc)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/iammccc/doc-generation

---


# 文档生成规范

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

## 输出结构

```markdown
# 标题

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

## 摘要
（2-3 句话，不超过 100 字）

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

## 正文
（结构化的完整内容）

## 评论
（有价值的评论和讨论）
```

## 各部分要求

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

### 来源
- 必须标注原始链接
- 有作者信息时必须标注
- 标注生成依据

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

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

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

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

## 禁止行为

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