
最近组里同事发现我周报写得越来越快了。以前周五下午要对着Git记录发呆十几分钟,现在五分钟搞定还图文并茂。
有人问我是不是偷偷加班了。其实不是,是工具变了。
我用Claude Code已经三个月。大家提到它第一反应是写代码工具,SWE-bench拿了87.6%的业界最高分确实猛。但我统计了一下自己的使用记录,写代码的时间不到三成,剩下七成全在写东西。
技术博客、项目周报、API文档、复盘报告、会议纪要。每周产出两万字左右。
每周五下午对着Git记录发呆是我最痛苦的时刻。明明干了很多活,坐下来写的时候脑子一片空白。
后来发现了git-reporter这个Claude Code技能插件。一条斜杠命令下去,它自动扫描我这周所有Git提交,读取源代码理解每次提交背后的技术逻辑,然后输出完整周报。
不是干巴巴的commit列表拼接。它会分析模块间的协作关系,提取代表性代码片段配上深度分析。精简版适合日常快速汇报,详细版包含架构图和提交记录适合正式技术汇报。
最让我惊喜的是参考文档学习功能。把团队已有汇报模板放进项目的references目录,它自动学习章节结构和排版风格,生成的报告风格自动对齐团队规范。
以前周五下午最痛苦的十五分钟现在变成了最轻松的五分钟。
写技术博客是另一个高频场景。以前每月一篇还要拖到月底。
用Claude Code之后变成了每周一篇。工作流分四步。
规划。把写作项目分解成可管理的小块,不是从空白页面开始而是从结构化的任务列表开始。Claude会创建包含标题、大纲、研究方向的完整计划。
研究。Claude从多个来源收集上下文,搜索现有内容找相关主题,做网络研究获取最新信息。省了大量翻资料的时间。
写作。真正的协作过程。我提供方向和声音,Claude提供结构和草稿加速。来回迭代直到内容感觉对了。
发布。提交代码推送触发自动部署。
过去需要几天的事情现在几个小时完成。
API文档更新是很多开发者的噩梦。接口改了文档没跟上,新人接手一脸懵。
用Claude Code可以写一个Skill定期扫描代码变更,自动更新对应的API文档。它能从代码中提取参数定义、返回值格式、错误码说明。生成的文档跟代码同步不用担心过时。
项目复盘报告是另一个痛点。每次线上事故事后都要写复盘。用Claude Code可以自动分析Git历史中的hotfix提交和回滚记录,结合监控数据生成复盘初稿。时间线、根因分析、修复方案都帮你理好,你只需要补充业务层面的反思。
跟ChatGPT比最大的差异是上下文。Claude Code住在你的终端里能理解整个代码库。它知道你这周改了哪些文件、修了哪些Bug、重构了哪些模块。写出来的文档跟你的实际工作强关联而不是泛泛而谈。
百万级Token的上下文窗口是它最硬的竞争力。100万Token约等于75万字文本或4万行代码。你可以把一整个项目的代码和文档一次性塞进去,让它在写任何东西的时候都能引用真实数据而不是凭空编造。
写API文档时自动引用实际的函数签名和调用方式,写复盘报告时准确描述每次变更的影响范围。
ChatGPT写出来的东西偏通用适合初稿但缺乏项目特定上下文。Gemini擅长搜索整合但代码理解深度不够。在需要深入理解项目上下文的写作场景里Claude Code的优势很明显。
这些高效场景背后的核心是Claude Skills。
Skills是一组指令打包成文件夹教会Claude处理特定任务。打个比方Claude是全能厨师,Skills就是你给它的专属菜谱。明确告诉它用什么设备按什么步骤做什么口味,它不用反复询问就能做出符合预期的结果。
写好一个Skill只需要15到30分钟。核心是一个Markdown文件不需要写任何代码。这是一个典型的Prompt Engineering as a Product案例,产品价值完全来自于精心设计的提示词。
多个Skills可以同时启用。比如同时用周报生成、博客写作、API文档三个Skill,让Claude一次性完成规划写作发布的全流程。
句子节奏很重要。 短句直击要点、中句解释概念、长句描述复杂关系。混合使用避免单调让文章有呼吸感。
控制阅读难度。 技术文章最常见的问题是术语堆砌。使用短句避免行业黑话,必要时提供通俗类比。
刻意规避AI腔。 一看就是AI写的表达比如套话开头和万能过渡句要主动替换掉。用具体直接的表达替代。
每节不超过300字。 追求信息密度而不是篇幅长度。技术文章不是越长越好。
用Claude Code写文档最大的风险不是写得不好而是写得太快导致你来不及审核。
我有过一次惨痛教训。写了一份技术方案文档直接发给评审会,结果里面有个函数签名引用的是上一版的接口。Claude读的代码是对的但上下文里残留了旧版本的信息。
从此养成一个习惯:Claude输出的文档我一定要用diff命令跟实际代码对比一遍。特别是API文档和接口说明这种对准确性要求极高的内容。
用/clear清空上下文再开始新任务也能大幅降低这类问题。干净会话加好提示词几乎总是优于长会话加反复修正。
2026年AI写作正从帮你写一点走向跟你一起写全流程。
内容创建的未来不是AI取代写作者而是AI让写作更高效更研究驱动。我的声音、专业知识和编辑判断仍然是核心。Claude处理结构调整、研究综合、格式规范这些机械性工作。
Boris Cherny说他们80%到90%的代码都由AI完成。但我认为AI在写作领域的潜力同样巨大甚至更大。因为写作的痛点不是不会写而是没时间和不想写。Claude Code恰好解决了这两个问题。
模型会不断被替代但好的写作流程和Skill配置是更持久的竞争力。如果你每周也被文档和报告压得喘不过气,不妨试试把Claude Code从编程助手升级为写作搭档。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。