Fabrizio 技术写作博客

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

科技更需要人文学者

Fabrizio 认为，在 AI 能高效检索事实和生成平庸文字的时代，技术从业者的竞争优势不再是 Java 样板代码或 Markdown 技巧，而是回到人文基础：哲学、文学、语言学、数学、历史、人类学。 他的核心观点是：能深入思考、有明确立场、并能清晰传达和捍卫这些想法，才是"碳基生命"真正的护城河。文章也提到，学习一门与自身母语截然不同的语言（作者自己学波斯语、正准备学中文）是一种"特洛伊木马"，能带来文化、历史和不同世界观的渗透。 他反对把技术写作和工程能力矮化为纯技能堆叠，主张从业者应成为"文化译者"和"家庭哲学家"。文中还引用了 AI 实验室招聘哲学家的趋势，呼应"科技更需要人文学者"的主题。 整体是一篇立场清晰、带个人经验、有明确讨论入口的人文导向技术评论。
评论点赞收藏5 天前

技术比以往更需要人文主义者

<blockquote> <em>说坏话的人，想得也坏，活得也不好。我们必须找到恰当的措辞：语言至关重要！——</em> </blockquote><p>日前，一位读者联系我，想探讨技术写作这一职业的未来。他们提出了一个很有见地的问题：在这个变化不断、充满不确定性的时代，您会优先培养哪些技能？<br><br>是人工智能吗？抑或编程？其实都不是。</p>
评论点赞收藏22 天前

第一期第十集：Agent流量、llms.txt与孤独问题

<p>AI 与文档播客系列第十期已上线！在本期节目中，我和 Tom 采访了 Mintlify 唯一的技术作家 Ethan Palm，探讨当文档站点近一半的流量不再来自人类时，会发生哪些变化：面向智能体的隐藏目录与内容协商、为何对大语言模型说“如果你是智能体，请阅读这段内容”根本不起作用、llms.txt 是否会成为真正的行业标准、文档取证、那些连 JavaScript 都无法再看到的分析数据，以及在选择调用终端而非请教同事时所付出的隐性社交代价。</p>
评论点赞收藏28 天前

给文档里的AI代理下指令，真的有用吗？

显式推荐能完全改变模型行为，但"For agents"标签没有额外权威。 用Sonnet 4.6做了一系列对照实验：没有推荐时模型选正确路径的概率仅33%，加上推荐后达到100%。 但一旦推荐存在，无论格式是HTML还是Markdown、压缩还是完整、上下文长短， 结果都是100%——推荐本身的力量淹没了其他变量。 标注"For agents"和通用标题在冲突指令场景下效果完全相同，Pinecone文档实验也显示有无agent专属区块无差异。 结论：写清晰、完整、可解析的文档就够了，不需要专门讨好代理，也不该用"For agents"标签降低人类读者的体验。
评论点赞收藏43 天前

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

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

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...
评论点赞收藏109 天前

何为优美的文档？

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

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...
评论点赞收藏121 天前

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

登录芦苇

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

热门话题

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