Fabrizio 技术写作博客

RSS: https://passo.uno/index.xml
Passo Uno，近期的想法与笔记。

你可以用“LLM语”写文档，但你不必这么做

实测证明：通过语义重写而非简单删减，可将技术文档压缩近半且不影响模型回答准确率。对比LLMLingua等剪枝方法的缺陷，指出“编译”人类文档比直接为机器写作更有效。对优化Prompt成本和构建Agent通信协议有直接参考价值。
评论点赞收藏34 天前

Feed the machines, then guide the humans

Docs as code used to mean editing docs as if they were code. Today it also means that docs have become executable, either as agentic instructions, skills, or context for large language models. Tech wr...
评论点赞收藏64 天前

何为优美的文档？

用卡尔维诺的文学遗产重新定义技术文档的审美标准。作者是一位经验丰富的技术写作者，借 Italo Calvino 临终前撰写的《未来千年文学备忘录》中六种文学品质——轻、快、精确、可见、多样、一致——逐条映射到技术文档的写作与设计实践中，提出文档不仅应当好用，还应当让用户感到愉悦、信任、愿意反复回来。文章反驳了"文档追求美就是失职"的常见偏见，援引 Tractinsky 等人的学术论文证明感知美学与感知可用性正相关，并给出具体判断：优美的文档不是靠图形设计花哨，而是靠结构清晰、语言精准、节奏轻快、避免模糊、帮助用户在脑中重建知识图景。这不是空泛的趋势论述，而是一篇有个人观察、有学术引用、有行业对话痕迹、有具体可操作讨论入口的原创观点文章，适合对内容设计、产品文档、信息架构感兴趣的人阅读和讨论。
评论点赞收藏71 天前

The Seven-Action Documentation Model

I think all technical writers, at some point or another, feel the urge to base their work on something more systematic than “it’s just the way folks documented stuff since forever”. Toolkits and frame...
评论点赞收藏75 天前

微调大语言模型，像1995年那样写技术文档

在我的2030年预测》中， 我曾写道，科技撰稿人将使用专门的大型语言模型，并在强大的硬件上进行本地化运行。 我在工程领域的专家们当中已经看到了这种“本地优先”趋势的端倪，但目前我们尚未达到这一阶段——部分原因在于连接式前沿模型的性能要强大得多。 不过，这并不意味着我们不能进行实验。 事实上，上周我就正是这么做的：我尝试对一个指令型模型进行微调，让它像上世纪八九十年代的软件技术撰稿人一样写作。
评论点赞收藏76 天前

第一季第八集：评判优美文档、AI疲劳与工具垃圾

AI与文档播客系列第八期已上线！在本期节目中，汤姆和我探讨了何为真正让文档既美观又富有美感， 而非仅仅流于功能；卡利诺的文学原则如何应用于文档领域； 我们的角色为何正从创造转向评判人工智能生成的内容； 无休止的审核工作所带来的心理负担；以及为什么大多数匆忙搭建的工具往往缺乏足以经久不衰的匠心。 您可以在下方观看或收听这一集：
评论点赞收藏76 天前

文档的未来比你想的更人性化

作者在Behind the Docs播客中分享了关于AI与文档写作的独到见解：技术写作者应成为工具与内容系统的架构师，而非被AI取代。核心观点包括AI更适合作为协作伙伴、优秀文档需同时服务人类与机器、本地及自托管模型在文档工作流中独具价值等，触及了技术写作领域正在发生的结构性变化。
评论点赞收藏95 天前

我在为文档设计智能体工作流时学到的事

作者分享从个人使用 AI 辅助写作到为整个技术文档团队设计智能体工作流的真实经验。核心问题：如何规模化落地而不让系统变成干扰？答案正在通过 GitHub Agentic Workflows 实验验证。文章结合了个人实践与同行交流，不是泛泛趋势解读，而是一手踩坑记录——如何在生产环境中让 AI 真正帮到写作者而不是添乱，对技术写作团队和关注 AI 落地的人来说有直接参考价值。
评论点赞收藏96 天前

我把博客打造成了 Windows 3.1 复古风格

一位技术写作者的博客主页，采用 Windows 3.1 复古界面设计。博主 Fabrizio Ferri Benedetti 以真实个人经验切入，讨论微调 LLM 生成复古风格文档、设计 GitHub Agentic 工作流、AI 工具泛滥现象、文档美学、技术写手在 AI 时代的新技能等话题。文章有明确个人立场、一手实践和鲜活写作风格，文字有温度。但页面本质是博客文章列表而非单篇深度内容，各篇仅展示摘要，缺少完整信息量。
评论点赞收藏111 天前

第一阶段第七集：技能、智能体工作流与修补者的负担

这是一期 AI & Docs 播客的推介短文，核心看点在于抛出了一个让技术文档从业者很难绕开的问题：当 AI 能直接调用工具、本地模型摆脱 API 依赖、技能（skills）比塞满 MCP 服务器更节省 token 时，技术写手到底是在把自己架构进更高阶的角色，还是在把自己架构出局？文中还讨论了“AI 输出默认是坏的”这一前提、LLM 的记忆缺陷等具体观察。虽只是播客简介而非完整转录，但话题密度高、立场清晰，短而有物，适合对 LLM 落地与技术写手角色演进感兴趣的读者点开播客继续挖。
评论点赞收藏125 天前

技术写作的奇幻地图（AI版）

作者三年前曾发布一幅"技术写作的奇幻地图"，如今AI时代来临，他重新绘制了新版。他将AI比作从北方入侵的黑暗势力，吞噬着技术写作者的日常悲观情绪。文章以创意地图形式呈现技术写作领域的"争议领土"，邀请读者在其中找到自己的位置。这是一篇充满个人风格和隐喻的短文，适合对技术写作现状与AI影响感兴趣的人一探。
评论点赞收藏126 天前

未来团队中，角色是动词而非名词

核心看点：作者提出未来团队的角色设计应把职位视为"动词"（灵活行动）而非"名词"（固定头衔），并给出了一套可复用的四象限框架。以软件文档团队为例，四个极点分别是产品愿景、知识设计、工程深度和交付策略。他认为传统按知识桶划分的固定岗位（如"技术文档工程师"）正在萎缩甚至消失，真正需要的是能在四个象限间自由流动、组合多种技能的成员。这不是空洞的管理口号，而是一个具体的团队构建思维模型——把角色看作动态行为而非静态标签，让组织更适应快速变化的需求。
评论点赞收藏146 天前

第一阶段第六集：文档测试、技能文件与知识守护者

作者和两位嘉宾在播客中聊了四个技术写作核心议题：文档确定性测试、技能文件的必要性、将专业知识外化时的伦理张力，以及技术写作者作为内容策展人乃至"知识守护者"的角色演变。本文是这期播客的简介入口，列出了讨论框架但未展开具体内容。适合对技术写作行业趋势、文档方法论有持续关注的读者作为线索快速了解，再决定是否深入听播客。
评论点赞收藏158 天前

技能即文档，而文档离不开技术写作者

核心看点：当"CodeWiki"和"Claude Skills"接连被宣称将杀死技术写作时，作者从个人视角给出了犀利反驳——文档比人们想象的更顽强，因为它在信息噪音中提供了最强信号，而且遍布各处，甚至包括那些所谓替代品本身。作者讽刺CodeWiki只是"文档剧场"，批评Claude Skills把Markdown指令包装成可执行代码的做法，指出这些新工具本质上仍然是文档，依然需要技术写作者的功底。这是一篇捍卫技术写作价值的立场短文，观点鲜明、带有个人语气和行业观察，适合对AI与知识工作关系感兴趣的技术写作从业者阅读讨论。
评论点赞收藏160 天前

LLM时代技术写作者的新习惯

核心看点：当LLM能凭简单提示生成像样的文档时，技术写作者的核心价值在哪？作者延续前文论点，直接抛出这个行业紧迫问题，并承诺给出可操作的方向。文章短但有观点密度——先点明"写作从来不是便宜的部分"，再指出LLM已能完成基础文档写作，最后提出真正的技能转向是什么。没有空泛趋势描述，而是从一线实践者视角切入，适合对AI冲击下写作者角色转型感兴趣的人阅读。来自个人独立博客，有人味、有立论、有讨论入口。
评论点赞收藏168 天前

写作从来都是最便宜的部分

作者曾发誓一年不再写AI，如今却打破誓言——因为"文档的真实成本"这个话题值得再说。本文以亲身经历提出一个反直觉的观点：写作本身从来不是成本最高的环节，真正昂贵的是理解领域知识、梳理上下文、积累经验和人肉调研。作者批评AI评测圈沉迷于"让LLM画一只骑自行车的鹈鹕"这类琐碎指标，反而掩盖了写作者最核心的不可替代技艺。不是趋势空谈，不是SEO任务文，而是一篇有个人困惑、有明确立场、有打破自己誓言的真实纠结的随笔，适合关心技术写作、文档工程和AI对创作者实际影响的读者一读并参与讨论。
评论点赞收藏172 天前

《AI与文档》播客第一阶段第五集：2026年技术传播趋势预测

本篇为一期技术传播播客的节目预告与内容索引。核心看点：Tom与作者在第五集中讨论了2026年技术传播行业的三大预测——写作者向自动化工程师的转型、"反向半人马"（Reverse Centaur）动态的风险，以及真实人际连接的价值持续上升。内容直接指向具体播客链接，适合对技术传播、AI对写作职业影响、自动化趋势感兴趣的读者。帖子简短，没有展开具体论点或论据，价值主要在于引出播客中的深入讨论。
评论点赞收藏202 天前

AI辅助技术写作的四种模式

用烹饪食谱里工具出场的节奏来类比技术写作中AI工具的介入时机——作者以个人观察出发，提出了一个区分AI辅助技术写作四种模式的框架，帮助同行判断何时、如何让LLM从工具箱中出场。不是泛泛的趋势罗列，而是有分类逻辑和实战视角的思考，对技术文档从业者具有可复用的参考价值。
评论点赞收藏202 天前

致那些因AI而解雇或不招聘技术写作人员的人

一封以第二人称"你"直接喊话的公开信，火力对准那些因迷信AI而裁撤或停止招聘技术写作者的公司决策者。作者逐一反驳三个典型错误认知：认为LLM无需专家把关就能写出合格文档、把文档负担甩给开发者、低估技术写作在知识传递中的专业门槛。这不是一篇四平八稳的趋势分析，而是带着行业一线经验和切身立场的对抗性表达，语气激烈但论据清晰，精准踩中AI替代知识工作者这个当下最热的争议话题。适合引发讨论和转发。
评论点赞收藏215 天前

AI 与文档播客第四集：AI 工具、自动化与有意的离线生活

播客第四集邀请嘉宾 CT Smith，聊了 AI 工作流、构建不依赖 AI 的工具、技能退化的恐惧、主动选择离线生活方式，以及开发者和写作者之间的角色边界为何开始模糊。这集话题覆盖面广，从实操到生活方式都有涉及，适合对 AI 与文档交叉领域感兴趣的读者先听为快。
评论点赞收藏223 天前

【实验】我让 Claude 和 Gemini 点评了我的 2025 年博客文章

作者没有自己分析2025年的博客写作数据，而是别出心裁地让Claude Opus 4.5和Gemini Pro 3来评价自己的全年文章，还拿到了它们对明年的预测（附神秘嘉宾）。AI没有一味附和"你说得完全对"，反而偶尔展现出幽默感，令人惊喜。这是一篇作者与AI"合写"的实验记录，既有个人视角的真实困惑与好奇心，也有与AI对话过程中的意外碰撞，适合对AI创造力、博客写作、年度复盘和自我反思感兴趣的读者。
评论点赞收藏237 天前

登录芦苇

登录后关注作者、收藏内容和参与讨论。

热门话题

人工智能12,865 人关注AI 会怎样改变日常工作？产品思考8,243 人关注怎样判断一个产品值得长期做？独立开发5,917 人关注一个人如何持续完成作品？
关于芦苇 · 联系我们 · 下载 App · © 2026 芦苇