# 技术文档工程师 / 技术写作

> 把一套系统做的事,变成一个陌生人能照着做的东西 —— 而在这个过程里,通常是第一个发现「这套系统说不通」的人。

网页: https://flyvolo.ai/zh/careers/technical-writer
影响指数: 63/100 · 置信度 低置信度 · 评估于 2026-09-14
这不是失业概率。

## 适用范围

覆盖产品与开发者文档 —— 指南、参考、API 文档、发布说明。受监管的技术写作(医疗器械、航空、药品申报)是另一份工作、暴露度不同,因为那里的文档是合规交付物,形式是被规定的。市场内容与一般文案在本站是另外的职业。

## 任务

### 起草参考文档

- 方向: 正在自动化
- 依据: 有证据(附已核实记录)
- 为什么: 这是本站暴露度最高的一项写作任务 —— 因为事实来源是机器可读的,而输出格式是固定的。从函数签名生成参数表,在模型出现很久以前就已经被文档生成器部分自动化了;模型加上的是「读起来像人写的」散文,而那拿掉了「让人来写」的最后一个理由。
- 这还不能说明什么: 被生成的参考文档,是一份发布前没人读过的参考文档;而它的失效方式不是「错」,是「看起来对」—— 它描述的是代码声明了什么,不是代码做了什么。这个缝隙只有真的去用它的人才会发现,而那正是下面那项任务 —— 所以把这一项自动化,抬高的是那一项的价值,不是拿掉这份工作。
- 记录:
  - 2026-07-21 · 政策推动 · 韩国人工智能基本法要求高影响人工智能的经营者撰写并留存能证明其安全措施的文档,并建立与实施对系统判断标准与训练数据的说明方案 — https://flyvolo.ai/zh/changes/ev-20260721-technical-writer-2 (来源: https://www.law.go.kr/법령/인공지능발전과신뢰기반조성등에관한기본법/제34조)
  - 2026-04-01 · 使用者采用 · 美国人口普查局 BTOS 专项:写作是美国企业内部报告最多的生成式 AI 任务,而 65% 的企业只把 AI 用在三项或更少的任务上 — https://flyvolo.ai/zh/changes/ev-20260401-technical-writer-1 (来源: https://www2.census.gov/library/working-papers/2026/adrm/ces/CES-WP-26-25.pdf#worker-tasks)

### 真的去用你要写的那个东西

- 方向: 仍由人主导
- 依据: 有证据(附已核实记录)
- 为什么: 这项任务的输入不存在于任何代码库里:它是「在某个具体位置被卡住」的那份体验。一个在这套代码上训练过的模型,继承的正是工程师的知识 —— 而这份知识恰恰必须缺席,这个测试才成立。这里的价值来自「不知道」。资深写作者说,他们会请没参与写作的人从头到尾照着文档操作;而对医疗器械的使用说明,美国监管机构只看有代表性的用户实际使用器械的表现来判断。
- 这还不能说明什么: 这项任务是这个职业最强的论据,也是在预算会上最弱的一个 —— 因为它的产出是一种缺席:那些没有发生的支持工单。在文档团队被裁的地方,最先走的就是这一项,而这件事完全不需要技术来促成。
- 记录:
  - 2026-08-26 · 使用者采用 · 对 31 位技术写作者的访谈发现,文档质量依赖工程师的技术审阅和局外人的端到端试用;25 人认为大模型给出的审阅意见不可靠 — https://flyvolo.ai/zh/changes/ev-20260826-technical-writer-3 (来源: https://arxiv.org/abs/2608.26232v1)
  - 2026-08-03 · 限制或撤回 · FDA 指南说,使用说明是否合格要看有代表性的用户实际使用器械的表现;靠改写说明来解决使用问题,必须提供新的测试数据 — https://flyvolo.ai/zh/changes/ev-20260803-technical-writer-4 (来源: https://www.fda.gov/media/80481/download)

### 决定什么不写

- 方向: 仍由人主导
- 依据: 有证据(附已核实记录)
- 为什么: 生成变便宜让这一项从最不值钱变成最值钱的一项,因为瓶颈挪了:当「把所有东西都写出来」变得可能时,「选」就成了这份工作的全部。决定省略什么,取决于知道有哪些用户、他们想做成什么 —— 而那不在代码里。
- 这还不能说明什么: 更值钱不等于被认可:文档通常按覆盖率考核,而覆盖率恰恰是「生成变便宜」让它失去意义的那个指标。一个按「发布了多少页」被考核的团队,会在这项任务刚变成最要紧的那一刻,因为放弃它而被奖励。
- 记录:
  - 2026-07-21 · 政策推动 · 韩国人工智能基本法要求高影响人工智能的经营者撰写并留存能证明其安全措施的文档,并建立与实施对系统判断标准与训练数据的说明方案 — https://flyvolo.ai/zh/changes/ev-20260721-technical-writer-2 (来源: https://www.law.go.kr/법령/인공지능발전과신뢰기반조성등에관한기본법/제34조)
  - 2026-04-01 · 使用者采用 · 美国人口普查局 BTOS 专项:写作是美国企业内部报告最多的生成式 AI 任务,而 65% 的企业只把 AI 用在三项或更少的任务上 — https://flyvolo.ai/zh/changes/ev-20260401-technical-writer-1 (来源: https://www2.census.gov/library/working-papers/2026/adrm/ces/CES-WP-26-25.pdf#worker-tasks)

### 把答案从工程师嘴里挖出来

- 方向: 仍由人主导
- 依据: 推断(VOLO 的推理,未附来源)
- 为什么: 需要的信息按定义就是没有文档的 —— 如果它被写下来了,这项任务就不存在。把它挖出来是一个社会行为,对抗的是别人的日程表;而这里的本事是知道「问哪一个问题会得到真实的答案、而不是官方的答案」。
- 这还不能说明什么: 正是这项任务让这份工作很难远程、兼职或由外包来做 —— 而那恰恰是成本压力推着它去的方向。这里的威胁不是自动化,是这份工作被重组成一种「容不下这项任务」的形态;在那之后文档会变差,而没有人会把原因归对。
- 记录:
  - 2026-08-26 · 使用者采用 · 对 31 位技术写作者的访谈发现,文档质量依赖工程师的技术审阅和局外人的端到端试用;25 人认为大模型给出的审阅意见不可靠 — https://flyvolo.ai/zh/changes/ev-20260826-technical-writer-3 (来源: https://arxiv.org/abs/2608.26232v1)

## 怎么引用

- 单位是任务,不是职位名:说哪些任务在变、哪些不变。
- 每项任务的依据与限制要一起带上;推断不是结论。
- 本页不给年份。不要从中推出一个。
- 更多: https://flyvolo.ai/llms.txt