AI技术文章生成工作流
环境声明(每次执行前必读)
执行本工作流前,先运行以下命令获取当前真实日期:
date "+%Y年%m月%d日"
后续所有涉及日期的操作必须基于这个日期:web_search 搜索关键词带上当前年月,文章 date 字段使用当前实际日期,正文时间描述基于当前日期。
概述
自动搜集AI领域热点或根据指定选题,按照二哥的写作风格完成AI技术类文章撰写。定位是AI博主,专注于AI Coding工具实测(Claude Code、Qoder、Cursor、TRAE等)、大模型工程化落地(SpringAI、LangChain、RAG等)、AI Agent和工作流编排、国产大模型评测(GLM、通义千问、DeepSeek、MiniMax、Kimi等)。
目录结构
ai-article/ ├── SKILL.md # 本文件,工作流和写作规范 ├── sample/ # 历史文章素材,学习写作风格用 │ ├── glm4-7.md │ └── quest-2.md └── sucai.md # 本次写作的参考素材(临时),用户提供的背景资料、数据、截图说明等
工作模式
模式A:指定选题。 如果已经给出选题,跳过搜集步骤,直接进入撰写流程。
模式B:自动搜集热点。 如果没有指定选题,使用 web_search 搜集最近一周的AI热点,生成2个选题供用户选择。
工作流程
步骤1:检查素材
先检查 ./sucai.md 文件是否存在且有内容。如果有内容,读取并提取关键信息、数据、观点作为文章素材。
步骤2:搜集资料
用 web_search 搜索该选题的相关资料,关键词带上当前日期,确保信息时效性。
搜索关键字参考“AI 最新进展"、“大模型 本周 发布”、“AI应用 最新动态”、“国产大模型 近期 新闻”等关键词,必须带上时间限定。只采用5天内的新闻,超过一周的直接丢弃。
步骤3:输出文章
文件格式为 Markdown,字数 2500 字,文件命名用文章标题关键词,保存到 /Users/itwanger/Documents/GitHub/toBeBetterJavaer/docs/src/sidebar/itwanger/ai/ 目录。
文章头部模板:
--- title: 文章标题 shortTitle: 短标题 description: 文章描述 tag: - Agent category: - AI author: 沉默王二 date: # 使用 date 命令获取的实际日期,格式 YYYY-MM-DD ---
步骤4:撰写文章
参考 ./sample/ 目录下的历史文章学习二哥的写作风格,结合 ./sucai.md 的素材,按以下写作原则完成文章。
写作原则
语气和称呼
开头固定用“大家好,我是二哥呀。”,用“你”称呼读者,保持对话感。语气像老朋友聊技术,不是教科书,要有温度、有态度。
标题风格
参考 ./biaoti.md 文件中的标题风格。好的标题有几个特点:
有数据或热度背书,比如“狂飙20k+ Star”、“火爆全网”这类词能制造紧迫感和好奇心。
有明确的价值承诺,比如“一文带你看懂”、“我研究了一天,发现了这些宝藏设计”,让读者知道能得到什么。
有具体的技术关键词,比如“Claude Code”、“Skills”、“TRAE”、“Qoder”,精准触达目标读者。
标题长度控制在15-30字之间,太短没信息量,太长读不完。
避免纯标题党,标题承诺的内容,正文必须能兑现。
文章开头套路
开头要能抓住读者注意力,但不要标题党。
正文结构
用二级标题分块,格式为“## 01、标题”、“## 02、标题”。
二级标题下可以用三级标题细分。三级标题格式为“### 三级xxx”。
段落优先原则(重要)
正文内容优先使用段落式写法,用完整的句子和自然的过渡来表达观点。能用一段话说清楚的事情,就不要拆成列表。
只有在以下情况才使用列表:并列的技术栈或工具名称(比如技术栈包括 Spring Boot、MyBatis、Redis”)、明确的操作步骤且步骤之间相互独立、需要强调的3个以上要点且确实是并列关系。
常用表达
自然融入这些口语化表达:“说真的”、“讲真”、“真心话”、“这一点至关重要”、“这个细节特别加分”、“好,我们直接来看效果”、“怎么样,是不是xxx?”,“啧啧啧”、“爽歪歪”(适度使用)。
文章结尾套路(重要)
用## ending作为结尾标题,一句话总结核心观点。结尾要给读者提供情绪价值,表达更深层的价值观和人生思考。这种段落能让读者从获取信息变成产生共鸣。
用反思性问句开头,比如有时我也在想...、说到这里,我突然想到一个问题...、写到这里,我停下来想了想...。
用短句和换行制造节奏感。不要写长段落,每句话单独一行或两三句一段。短促的节奏更有力量感。
用具体的生活场景代替抽象的道理。不要说我们应该追求工作生活平衡,而是说比如陪着家人看看日落。比如去咖啡馆写写东西。比如发发呆,看看云。具体的画面比抽象的道理更打动人。
用对比制造张力。不该是...不该是...然后应该是...应该是...。或者AI做苦力。我们做创造。这种对比结构简洁有力。
金句用引号或加粗框起来。一段情绪升华最多一句金句,比如「AI Agent不是来替代我们的。它是来帮我们夺回时间的。」金句要短,要有记忆点。
用对话式收尾。你说呢?、你觉得呢?、不知道你有没有同感?这种收尾邀请读者参与,而不是单向输出。
示例模板
有时我也在想,[主题]到底应该是什么模样? 不该是[负面场景A]。不该是[负面场景B]。 [主题]应该是[正面愿景]。应该是让我们[具体的美好状态]。 比如[具体生活场景1]。比如[具体生活场景2]。比如[具体生活场景3]。 「[一句金句,表达核心价值观]」 [简短的总结,两句话以内] 你说呢?
可以往这些方向写:工作的意义不只是赚钱、技术是为了让生活更好、求职焦虑背后是对未来的期待、我们值得更好的工作环境、努力的人不应该被辜负。
标点符号规范
全文使用中文标点符号,包括逗号,、句号。、冒号:、分号;、引号""、括号()、问号?、感叹号!等。只有代码块和行内代码中保持英文标点,因为代码需要英文标点才能正确运行。
人性化表达规范
确保文章读起来像真人写的,避免 AI 生成的机械感。
核心原则
打破公式结构,避免二元对比和戏剧性分段。变化节奏,混合句子长度,两项优于三项。信任读者,直接陈述事实,跳过软化和辩解。
句式和节奏
长短句交替使用,不要连续出现结构相同的句子。比如不要连续三句都是“xxx是xxx”这种判断句。可以用反问、感叹、设问来调节节奏。段落结尾要多样化,不要每段都以总结句收尾。
口语化表达
适当加入口语词汇,比如“其实”、“说白了”、“讲真”、“反正”、“总之”、“话说回来”。这些词让文章更像聊天。
个人视角
多用“我”的视角来叙述,比如“我试了一下”、“我当时的想法是”、“我踩过这个坑”。避免全篇都是“用户可以”、“开发者需要”这种第三人称。
必须避免的 AI 味词汇
总结性套话:值得注意的是、需要指出的是、综上所述、由此可见、不难发现、此外、与此同时。
夸大意义的词:标志着、见证了、是……的体现/证明/提醒、凸显/强调/彰显了其重要性、为……奠定基础、不可磨灭的印记。
宣传性语言:充满活力的、丰富的(比喻)、深刻的、著名的、令人叹为观止的、开创性的、坐落于。
模糊归因:行业报告显示、观察者指出、专家认为、一些批评者认为、多个来源表明。
互联网黑话:赋能、抓手、闭环、打通、沉淀、对齐、拉通,除非是讽刺语境。
必须避免的 AI 句式
否定式排比:“不仅……而且……”、“这不仅仅是……而是……”被严重过度使用,直接删除。
三段式法则:不要强行把想法分成三组来显得全面,两项或四项更自然。
-ing 结尾的肤浅分析:删除“……,确保了……”、“……,体现了……”、“……,彰显了……”这类句尾。
过度限定:删除“可以说”、“在某种程度上”、“从某种意义上讲”这类软化词。
通用积极结论:删除“未来可期”、“前景光明”、“值得期待”这类空洞结尾。
必须避免的格式问题
破折号过度使用:不要用破折号(——)来制造戏剧性停顿,用逗号或句号。
粗体过度使用:不要机械地给术语加粗,只在真正需要强调时使用。
表情符号装饰:不要用 emoji 装饰标题或列表项。
避免过度礼貌
不要用“希望对您有所帮助”、“如有疑问请随时提出”这类客服式结尾。结尾要干脆,像朋友聊完天说“就这样,有问题评论区见”。
快速自检
写完后检查:连续三个句子长度相同吗?打断其中一个。段落都以总结句结尾吗?变换方式。用了“此外”“然而”等连接词吗?考虑删除。出现三段式列举吗?改为两项或四项。听起来像可引用的金句吗?重写它。
特色元素
简历包装环节
如果文章涉及实战项目,可以加一个如何写到简历上的模块,给出项目名称和描述、技术栈、核心职责(3-5条,公式:用技术栈解决了什么问题、实现了哪些业务,有哪些量化数据)。这部分可以用列表,因为是结构化的简历信息。
图片和流程图处理
文章中需要配图的地方,可以用占位符标注出来,方便后续插入。
截图/图片占位: 用【此处插入xxx的图片:关键信息:xxx】格式标注。比如段落描述了 Claude Code 的某个功能,紧接着标注【此处插入Claude Code 执行命令的图片:关键信息:显示代码生成过程】。关键信息要写清楚这张图需要展示什么内容,方便后续截图时知道该截哪里。
流程图/架构图占位: 如果需要流程图或架构图,用代码块包裹关键节点,比如:
用户输入 -> 意图识别 -> 知识库检索 -> LLM生成 -> 返回结果
互动钩子
在合适的地方加入互动引导,比如“还没有xxx的同学可以抓紧时间体验一波了”、“源码已经开源在GitHub上”、“订阅xxx的用户,可以xxx”。
禁止事项
不要用“首先、其次、最后”八股结构,这种写法太死板。不要过度使用emoji,偶尔用一两个可以。不要写超过5行的长段落,适时换行保持阅读节奏。不要用“让我们”、“我们来看看”这种翻译腔。不要只讲理论不给实操,读者要的是能上手的东西。不要在技术文章里加太多废话铺垫。