AI技术文章生成工作流
⚠️ 强制检查项（每次执行前必读）
在开始写作前，必须阅读并承诺遵守以下强制要求：
| 检查项 | 要求 | 检查方法 |
|---|---|---|
| 标点符号 | 正文使用中文标点 | 生成后只检查正文，排除代码、URL、YAML、命令 |
| 标题风格 | 60字内，口语化，参考 biaoti.md 的模式 | 正文写完后读 biaoti.md，生成5个候选标题 |
| 开头 | 固定使用"大家好，我是二哥呀。" | 检查文章开头 |
| 前言结构 | 前3段内完成"冲突-结果-收益"三连 | 检查前三段内容 |
| 二级标题 | 格式为"## 01、标题" | 检查所有二级标题 |
| 截图占位符 | 每个核心章节至少1个，包含截图目标和关键词 | 检查各章节 |
| ending | 结尾标题 ## ending，不低于200字的情绪升华 | 检查结尾 |
| AI味词汇 | 避免使用"值得注意的是""此外""标志着""链路""你想啊"等 | 检查全文 |
| 黑话 | 避免使用"赋能""抓手""闭环""打通"等 | 检查全文 |
未完成以上检查的文章，不得交付。
环境声明（每次执行前必读）
执行本工作流前，先运行以下命令获取当前真实日期：
date "+%Y年%m月%d日"后续所有涉及日期的操作必须基于这个日期：联网搜索关键词带上当前年月，文章 date 字段使用当前实际日期，正文时间描述基于当前日期。
概述
自动搜集AI领域热点或根据指定选题，按照二哥的写作风格完成AI技术类文章撰写。定位是AI博主。
目录结构
ai-article/
├── SKILL.md # 本文件，工作流和写作规范
├── biaoti.md # 标题风格参考，高打开率标题合集
├── sucai.md # 本次写作的参考素材（临时），用户提供的背景资料、数据、截图说明等
├── references/ # 历史文章素材，学习写作风格用
│ ├── OpenClaw-install.md # 安装教程类风格参考
│ ├── OpenClaw-unstall.md # 面试对话类风格参考
│ ├── glm4-7.md # 产品评测类风格参考
│ └── quest-2.md # 产品评测类风格参考
└── scripts/
└── check_body_length.py # 正文字数检查脚本工作模式
用户通过提示词或 sucai.md 指定选题，直接进入撰写流程。
工作流程
步骤1：检查素材
./sucai.md（默认主素材）
你必须精读素材库中的内容，消化吸收。读取后提取关键信息、数据、观点、截图，作为正文素材池，尤其是截图，可以直接搬运到正文中，减少改稿成本。我们要写的内容正是基于素材完成的，不脱离，但有创新。
步骤2：搜集资料
用联网搜索（如 web_search）搜索该选题的相关资料，关键词带上当前日期，确保信息时效性。
搜索关键字参考“AI 最新进展"、“大模型 本周 发布”、“AI应用 最新动态”、“国产大模型 近期 新闻”等关键词，必须带上时间限定。默认只采用最近7天内的信息，超过7天的内容仅可作为背景，不得作为核心结论证据。
补充要求：
- 补充可引用的公开跑分/基准信息（如公开榜单、官方基准、第三方测试）。
- 补充来自 X（原 Twitter）的外界评价，优先真实开发者或有实测记录的账号。
- 外部引用必须保留来源链接和日期，避免“听说”“网友表示”这类模糊归因。
步骤3：整理证据清单（先于写作）
写正文前，先整理“引用证据清单”，至少包含：结论点、来源链接、发布时间/发帖时间、为何可信。
如果未检索到可核验的跑分或 X 外界评价，必须在清单里明确标记”未检索到有效证据”，正文对应段落降级为”经验观察”，禁止伪造数据或伪造引用。
步骤3.5：文章风格选择
使用 AskUserQuestion 工具询问用户选择 ./references/ 目录中的风格类型：
- 安装教程类：手把手教学，步骤详细，注重实操指导（参考：
references/OpenClaw-install.md） - 面试对话类：对话形式，深入理解，风格自然亲切（参考：
references/OpenClaw-unstall.md） - 产品评测类：实测体验，有观点有数据，情绪化表达（参考：
references/glm4-7.md、references/quest-2.md）
重要说明：
- 风格参考 ≠ 内容照搬：参考选定的文章学习二哥的语气、节奏、表达方式，但内容必须大胆创新，不能照搬参考文章的结构或素材
- 内容可以大胆假设：可以虚构场景、假设使用体验、创造新的案例，不局限于sucai.md的素材
- 开头和结尾要创新：不要老生常谈，不要每次都写类似的套路，根据内容特点设计有新意的开头和结尾
- 保持二哥的特色：口语化、有温度、像朋友聊天，避免AI味词汇和黑话
步骤4：撰写文章
文件格式为 Markdown，正文目标字数 4500 字（允许范围 4000-5500）。
撰写时按照步骤3.5用户选择的风格类型，参考对应文章学习二哥的写作风格，并结合 ./sucai.md 的素材。
重要：初稿写作时直接瞄准 4500 字，留出余量，避免反复检查补字。
字数检查与调整流程：
- 初稿完成后，使用
./scripts/check_body_length.py检查字数 - 如果字数在 4000-5500 之间：达标，直接进入步骤5落盘输出
- 如果字数 < 4000：不得交付，必须一次性扩展到 4500 字以上（不是刚好补到 4000 字卡线）。使用
AskUserQuestion工具提供2-3个扩展方向让用户选择，然后一次性补充完整段落或新章节，扩展后再检查一次字数。禁止每次只加几十个字反复检查 - 如果字数 > 5500：内容过长，需要精简。删减重复论述、合并相似段落、砍掉价值不高的章节，直到回落到合理区间
文章头部模板：
---
title: # 步骤5.5生成标题后回填
shortTitle: # 步骤5.5生成标题后回填
description: 文章描述
tag:
- Agent
category:
- AI
author: 沉默王二
date: # 使用 date 命令获取的实际日期，格式 YYYY-MM-DD
---步骤5：落盘输出
文件命名用文章主题关键词，保存到 docs/src/sidebar/itwanger/ai/ 目录（相对仓库根目录）。此时 frontmatter 的 title/shortTitle 可先留空。
步骤5.5：生成标题
正文定稿后，读取 ./biaoti.md，分析其中高打开率标题的共同特点（口语化、有数据、有情绪、60字以内），结合本次文章主题生成5个候选标题，让用户选择。选定后回填 frontmatter 的 title 和 shortTitle 字段。
步骤6：交付前检查（强制执行）
文章完成后，必须逐项检查以下清单，未完成的必须修改后再交付：
- 正文使用中文标点符号（少用双引号，除非必要）
- 标点检查仅针对正文，排除代码块、行内代码、URL、YAML frontmatter、命令行
- 前言在前3段内完成"冲突-结果-收益"三连
- 二级标题格式为"## 01、标题"、"## 02、标题"
- 每个核心章节（## 01及之后）至少1个截图占位符
- 每个截图占位符包含"截图目标"和"关键词"
- 结尾用## ending，有情绪升华（不低于200字）
- 正文长度4000-5500字，不包括代码（使用
./scripts/check_body_length.py检查字数） - 外部结论都有来源链接和日期，且在“引用证据清单”中可回溯
- 避免 AI 味词汇（值得注意的是、此外、标志、链路、收敛着等）
- 避免互联网黑话（赋能、抓手、闭环、打通等）
写作原则
标题风格
详见 ./biaoti.md。文章正文写完后，读取该文件，参考其中的高打开率标题风格，生成5个候选标题供用户选择。
语气和称呼
开头固定用"大家好，我是二哥呀。"，用"大家"、"我们"、“小伙伴”和读者拉进关系，保持对话感。语气像老朋友聊技术，不是教科书，要有温度、有态度。
文章开头套路
开头要能抓住读者注意力，但不要标题党。
前言冲击力（强制）
前言必须在前3段内完成“冲突-结果-收益”三连：
- 冲突：明确一个真实痛点或争议点。
- 结果：提前给出一句高价值结论（但不剧透全部细节）。
- 收益：告诉读者继续读下去能拿到什么（方法、结论、避坑点）。
正文结构
用二级标题分块，格式为“## 01、标题”、“## 02、标题”。
二级标题下可以用三级标题细分。三级标题格式为“### 三级xxx”。三级标题下可以有四级标题，但不强制，视内容需要而定。
Case 创意
要尽可能有趣，能让读者眼前一亮的案例。可以是实测数据、对比分析、独特的使用场景、开发者的真实反馈等。越具体越好，抽象的道理不如具体的故事。
如果涉及到coding，可以尝试和PaiAgent结合，这是一个Vibe Coding项目，源码在：https://github.com/itwanger/PaiAgent
也可以尝试和paicoding.com 技术派结合，看看能不能开发一些新的功能，实现一些新的业务，最好是和AI紧密结合，能写到简历上最好。
段落优先原则（强制）
正文内容优先使用段落式写法，用完整的句子和自然的过渡来表达观点。能用一段话说清楚的事情，就不要拆成列表。
核心要求：
- 段落式写法是默认选择，列表是例外情况
- 用自然的句子连接观点，而不是用列表强行分段
- 保持阅读的连贯性，让文章像聊天一样流畅
仅限以下情况使用列表：
- 并列的技术栈或工具名称（比如：Spring Boot、MyBatis、Redis）
- 明确的操作步骤且步骤之间相互独立
- 需要强调的3个以上要点且确实是并列关系
反面示例（禁止）：
错误：
这个工具的特点如下：
- 速度快
- 操作简单
- 功能强大正确：
这个工具最大的特点是速度快，操作也简单，功能还特别强大。用了之后你就知道有多香了。检查方法：
- 生成文章后，检查是否存在"仅用列表分段"的情况
- 如果列表项之间能用"，"或"、"连接成一句通顺的话，说明应该用段落
- 去掉无意义列表，改用段落式表达
常用表达
自然融入这些口语化表达：“说真的”、“讲真”、“真心话”、“这一点至关重要”、“这个细节特别加分”、“好，我们直接来看效果”、“怎么样，是不是xxx？”，“啧啧啧”、“爽歪歪”（适度使用）。
文章结尾套路（重要）
用## ending作为结尾标题，一句话总结核心观点。结尾要给读者提供情绪价值，表达更深层的价值观和人生思考。这种段落能让读者从获取信息变成产生共鸣。
用短句和换行制造节奏感。不要写长段落，每句话单独一行或两三句一段。短促的节奏更有力量感。
用具体的生活场景代替抽象的道理。具体的画面比抽象的道理更打动人。
可以用对比制造张力，但避免连续二元排比和模板化口号。重点是具体场景里的真实反差，而不是套句式。
金句用加粗框【xxx】起来。一段情绪升华最多一句金句，金句要短，要有记忆点。
可以往这些方向写：工作的意义不只是赚钱、技术是为了让生活更好、求职焦虑背后是对未来的期待、我们值得更好的工作环境、努力的人不应该被辜负、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生成 -> 返回结果禁止事项
不要用”首先、其次、最后”八股结构，这种写法太死板。不要过度使用emoji，偶尔用一两个可以。不要写超过5行的长段落，适时换行保持阅读节奏。不要用”让我们”、”我们来看看”这种翻译腔。不要只讲理论不给实操，读者要的是能上手的东西。不要在技术文章里加太多废话铺垫。严禁滥用列表，具体规则见”写作原则 > 段落优先原则”。