AI技术文章生成工作流

⚠️ 强制检查项（每次执行前必读）

在开始写作前，必须阅读并承诺遵守以下强制要求：

未完成以上检查的文章，不得交付。

环境声明（每次执行前必读）

执行本工作流前，先运行以下命令获取当前真实日期：

date "+%Y年%m月%d日"

后续所有涉及日期的操作必须基于这个日期：联网搜索关键词带上当前年月，文章 date 字段使用当前实际日期，正文时间描述基于当前日期。

概述

自动搜集AI领域热点或根据指定选题，按照二哥的写作风格完成AI技术类文章撰写。定位是AI博主。

目录结构

ai-article/
├── SKILL.md          # 本文件，工作流和写作规范
├── references/       # 历史文章素材，学习写作风格用
│   ├── glm4-7.md
│   └── quest-2.md
├── biaoti.md        # 标题风格参考
└── sucai.md         # 本次写作的参考素材（临时），用户提供的背景资料、数据、截图说明等

工作模式

模式A：指定选题。 如果已经给出选题，跳过搜集步骤，直接进入撰写流程。

模式B：自动搜集热点。 如果没有指定选题，使用联网搜索（如 web_search）搜集最近7天的 AI 热点，生成2个选题供用户选择。

工作流程

步骤1：检查素材

./sucai.md（默认主素材）

你必须精读素材库中的内容，消化吸收。读取后提取关键信息、数据、观点、截图，作为正文素材池，尤其是截图，可以直接搬运到正文中，减少改稿成本。我们要写的内容正是基于素材完成的，不脱离，但有创新。

步骤2：搜集资料

用联网搜索（如 web_search）搜索该选题的相关资料，关键词带上当前日期，确保信息时效性。

搜索关键字参考“AI 最新进展”、“大模型 本周 发布”、“AI应用 最新动态”、“国产大模型 近期 新闻”等关键词，必须带上时间限定。默认只采用最近7天内的信息，超过7天的内容仅可作为背景，不得作为核心结论证据。

补充要求：

• 补充可引用的公开跑分/基准信息（如公开榜单、官方基准、第三方测试）。
• 补充来自 X（原 Twitter）的外界评价，优先真实开发者或有实测记录的账号。
• 外部引用必须保留来源链接和日期，避免“听说”“网友表示”这类模糊归因。

步骤3：整理证据清单（先于写作）

写正文前，先整理“引用证据清单”，至少包含：结论点、来源链接、发布时间/发帖时间、为何可信。

如果未检索到可核验的跑分或 X 外界评价，必须在清单里明确标记“未检索到有效证据”，正文对应段落降级为“经验观察”，禁止伪造数据或伪造引用。

步骤4：撰写文章

文件格式为 Markdown，正文长度强制 4000字左右（低于3000不得交付，高于4000需压缩后再交付）。

撰写时参考 ./references/ 目录下的历史文章学习二哥的写作风格，并结合 ./sucai.md 的素材。

文章头部模板：

---
title: 文章标题
shortTitle: 短标题
description: 文章描述
tag:
  - Agent
category:
  - AI
author: 沉默王二
date: # 使用 date 命令获取的实际日期，格式 YYYY-MM-DD
---

步骤5：落盘输出

文件命名用文章标题关键词，保存到 docs/src/sidebar/itwanger/ai/ 目录（相对仓库根目录）。

步骤6：交付前检查（强制执行）

文章完成后，必须逐项检查以下清单，未完成的必须修改后再交付：

• 标题长度在15-30字之间
• 标题风格符合 biaoti.md 的模式（口语化、有节奏感）
• 正文使用中文标点符号（逗号必须是中文逗号 ，）
• 标点检查仅针对正文，排除代码块、行内代码、URL、YAML frontmatter、命令行
• 开头用”大家好，我是二哥呀。”
• 前言在前3段内完成”冲突-结果-收益”三连
• 二级标题格式为”## 01、标题”、”## 02、标题”
• 每个核心章节（## 01及之后）至少1个截图占位符
• 每个截图占位符包含”截图目标”和”关键词”
• 结尾用## ending，有情绪升华（不低于300字）
• 正文长度4000字左右（低于3000不得交付，高于4000需压缩）
• 外部结论都有来源链接和日期，且在“引用证据清单”中可回溯
• 避免 AI 味词汇（值得注意的是、此外、标志着等）
• 避免互联网黑话（赋能、抓手、闭环、打通等）

写作原则

标题风格（最高优先级，强制执行）

套用 ./biaoti.md 中的标题风格。标题生成时必须先仔细阅读 biaoti.md 的每一行标题，模仿其语气、长度和结构。

参考标题特点：

• 长度控制在15-30字之间
• 口语化表达：”真香”、”神级”、”有点东西”、”太猛了”
• 用感叹号！或冒号：制造节奏感
• 直接、不绕弯，一句话讲清核心卖点
• 避免学术化、正式化表达
• 可以用括号补充细节，如”（国产版）”

标题生成步骤：

1. 先读 biaoti.md 中所有标题
2. 提取标题模式（语气词、标点用法、长度）
3. 结合本次主题，生成符合该模式的标题
4. 检查标题长度在15-30字之间

语气和称呼

开头固定用”大家好，我是二哥呀。”，用”大家”、”我们”和读者拉进关系，保持对话感。语气像老朋友聊技术，不是教科书，要有温度、有态度。

标点符号（最高优先级，强制执行）

正文必须使用中文标点符号，这是硬性要求。

具体要求：

• 中文逗号：， （英文逗号 , 禁止使用）
• 中文句号：。
• 中文冒号：
• 中文分号；
• 中文引号：””
• 中文括号：（）
• 中文问号：？
• 中文感叹号：！

例外场景：代码块、行内代码、URL、YAML frontmatter、命令行、外文原文引用中的标点保持原样。

生成后检查步骤：文章生成完成后，只检查正文中的逗号是否为中文逗号（全角 ，）；例外场景不做替换。

历史文章参考风格（重要）

仔细阅读 ./references/ 目录下的历史文章，学习二哥的真实写作风格，不要只看 SKILL.md 的规则，要看实际例子。

• 标题长度控制在15-30字之间，太短没信息量，太长读不完。
• 避免纯标题党，标题承诺的内容，正文必须能兑现。
• 避免过度营销，有新意，有人文情怀，能引发共鸣的标题更有吸引力。

文章开头套路

开头要能抓住读者注意力，但不要标题党。

前言冲击力（强制）

前言必须在前3段内完成“冲突-结果-收益”三连：

• 冲突：明确一个真实痛点或争议点。
• 结果：提前给出一句高价值结论（但不剧透全部细节）。
• 收益：告诉读者继续读下去能拿到什么（方法、结论、避坑点）。

推荐句式：

• 我原本以为 X，结果实测后发现 Y。
• 真正拉开差距的不是 A，而是 B。
• 如果你正在做 C，这一段会帮你少踩 D 这个坑。

正文结构

用二级标题分块，格式为“## 01、标题”、“## 02、标题”。

二级标题下可以用三级标题细分。三级标题格式为“### 三级xxx”。

Case 创意

要尽可能有趣，能让读者眼前一亮的案例。可以是实测数据、对比分析、独特的使用场景、开发者的真实反馈等。越具体越好，抽象的道理不如具体的故事。

如果涉及到coding，可以尝试和PaiAgent结合，这是一个Vibe Coding项目，源码在：https://github.com/itwanger/PaiAgent

也可以尝试和paicoding.com 技术派结合，看看能不能开发一些新的功能，实现一些新的业务，最好是和AI紧密结合，能写到简历上最好。

段落优先原则（重要）

正文内容优先使用段落式写法，用完整的句子和自然的过渡来表达观点。能用一段话说清楚的事情，就不要拆成列表。

只有在以下情况才使用列表：并列的技术栈或工具名称（比如技术栈包括 Spring Boot、MyBatis、Redis）、明确的操作步骤且步骤之间相互独立、需要强调的3个以上要点且确实是并列关系。

常用表达

自然融入这些口语化表达：“说真的”、“讲真”、“真心话”、“这一点至关重要”、“这个细节特别加分”、“好，我们直接来看效果”、“怎么样，是不是xxx？”，“啧啧啧”、“爽歪歪”（适度使用）。

文章结尾套路（重要）

用## ending作为结尾标题，一句话总结核心观点。结尾要给读者提供情绪价值，表达更深层的价值观和人生思考。这种段落能让读者从获取信息变成产生共鸣（不低于300个字）。

用短句和换行制造节奏感。不要写长段落，每句话单独一行或两三句一段。短促的节奏更有力量感。

用具体的生活场景代替抽象的道理。具体的画面比抽象的道理更打动人。

可以用对比制造张力，但避免连续二元排比和模板化口号。重点是具体场景里的真实反差，而不是套句式。

金句用加粗框【】起来。一段情绪升华最多一句金句，金句要短，要有记忆点。

可以往这些方向写：工作的意义不只是赚钱、技术是为了让生活更好、求职焦虑背后是对未来的期待、我们值得更好的工作环境、努力的人不应该被辜负、AI不是为了取代我们。

人性化表达规范

确保文章读起来像真人写的，避免 AI 生成的机械感。

核心原则

打破公式结构，避免二元对比和戏剧性分段。变化节奏，混合句子长度，两项优于三项。信任读者，直接陈述事实，跳过软化和辩解。

句式和节奏

长短句交替使用，不要连续出现结构相同的句子。比如不要连续三句都是“xxx是xxx”这种判断句。可以用反问、感叹、设问来调节节奏。段落结尾要多样化，不要每段都以总结句收尾。

口语化表达

适当加入口语词汇，比如“其实”、“说白了”、“讲真”、“反正”、“总之”、“话说回来”。这些词让文章更像聊天。

个人视角

多用“我”的视角来叙述，比如“我试了一下”、“我当时的想法是”、“我踩过这个坑”。避免全篇都是“用户可以”、“开发者需要”这种第三人称。

必须避免的 AI 味词汇

总结性套话：值得注意的是、需要指出的是、综上所述、由此可见、不难发现、此外、与此同时。

夸大意义的词：标志着、见证了、是……的体现/证明/提醒、凸显/强调/彰显了其重要性、为……奠定基础、不可磨灭的印记。

宣传性语言：充满活力的、丰富的（比喻）、深刻的、著名的、令人叹为观止的、开创性的、坐落于。

模糊归因：行业报告显示、观察者指出、专家认为、一些批评者认为、多个来源表明。

互联网黑话：赋能、抓手、闭环、打通、沉淀、对齐、拉通，除非是讽刺语境。

必须避免的 AI 句式

否定式排比：“不仅……而且……”、“这不仅仅是……而是……”被严重过度使用，直接删除。

三段式法则：不要强行把想法分成三组来显得全面，两项或四项更自然。

-ing 结尾的肤浅分析：删除“……，确保了……”、“……，体现了……”、“……，彰显了……”这类句尾。

过度限定：删除“可以说”、“在某种程度上”、“从某种意义上讲”这类软化词。

通用积极结论：删除“未来可期”、“前景光明”、“值得期待”这类空洞结尾。

避免过度礼貌

不要用“希望对您有所帮助”、“如有疑问请随时提出”这类客服式结尾。结尾要干脆，像朋友聊完天说“就这样，有问题评论区见”。

特色元素

简历包装环节

如果文章涉及实战项目，可以加一个如何写到简历上的模块。

项目名称 项目简介：xxx 技术栈：xxx 核心职责（5条）

• xxxx 公式：用技术栈解决了什么问题、实现了哪些业务，有哪些量化数据

图片和流程图处理

文章中需要配图的地方，必须用占位符标注出来，方便后续插入。如果 ./sucai.md 中有相关截图，直接搬运过来即可。

截图占位符（强制）

终稿必须包含“截图占位符 + 关键信息关键词”，并满足：

• 每个核心章节（## 01 及之后）至少1个截图占位符。
• 每个占位符必须写清“截图目标”和“关键词”，方便后续检索与取证。
• 没有截图占位符的章节视为未完成，不允许交付。
• 如存在可核验的“跑分与外界评价”，该章节至少包含 1 个跑分截图占位符和 1 个 X 帖子截图占位符；如不存在，必须在文中明确说明缺失原因，不得杜撰。

截图/图片占位格式（固定模板）：

【此处插入<截图名称>：截图目标：<这张图要证明什么>；关键词：<关键词1>、<关键词2>、<关键词3>；建议位置：<命令行/网页/日志/IDE>】

示例：

【此处插入Claude Code 执行截图：截图目标：证明模型先拆解再执行；关键词：任务拆解、执行计划、变更说明；建议位置：终端会话窗口】

流程图/架构图占位： 如果需要流程图或架构图，用代码块包裹关键节点，比如：

用户输入 -> 意图识别 -> 知识库检索 -> LLM生成 -> 返回结果

互动钩子

在合适的地方加入互动引导，比如“还没有xxx的同学可以抓紧时间体验一波了”、“源码已经开源在GitHub上”、“订阅xxx的用户，可以xxx”。

禁止事项

不要用“首先、其次、最后”八股结构，这种写法太死板。不要过度使用emoji，偶尔用一两个可以。不要写超过5行的长段落，适时换行保持阅读节奏。不要用“让我们”、“我们来看看”这种翻译腔。不要只讲理论不给实操，读者要的是能上手的东西。不要在技术文章里加太多废话铺垫。