AgentSkillsCN

Ai Article

人工智能文章

SKILL.md

AI技术文章生成工作流

环境声明(每次执行前必读)

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

bash
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等)。

目录结构

code
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/ 目录。

文章头部模板:

yaml
---
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不是来替代我们的。它是来帮我们夺回时间的。」金句要短,要有记忆点。

用对话式收尾。你说呢?、你觉得呢?、不知道你有没有同感?这种收尾邀请读者参与,而不是单向输出。

示例模板

code
有时我也在想,[主题]到底应该是什么模样?

不该是[负面场景A]。不该是[负面场景B]。

[主题]应该是[正面愿景]。应该是让我们[具体的美好状态]。

比如[具体生活场景1]。比如[具体生活场景2]。比如[具体生活场景3]。

「[一句金句,表达核心价值观]」

[简短的总结,两句话以内]

你说呢?

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

标点符号规范

全文使用中文标点符号,包括逗号,、句号。、冒号:、分号;、引号""、括号()、问号?、感叹号!等。只有代码块和行内代码中保持英文标点,因为代码需要英文标点才能正确运行。

人性化表达规范

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

核心原则

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

句式和节奏

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

口语化表达

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

个人视角

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

必须避免的 AI 味词汇

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

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

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

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

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

必须避免的 AI 句式

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

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

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

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

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

必须避免的格式问题

破折号过度使用:不要用破折号(——)来制造戏剧性停顿,用逗号或句号。

粗体过度使用:不要机械地给术语加粗,只在真正需要强调时使用。

表情符号装饰:不要用 emoji 装饰标题或列表项。

避免过度礼貌

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

快速自检

写完后检查:连续三个句子长度相同吗?打断其中一个。段落都以总结句结尾吗?变换方式。用了“此外”“然而”等连接词吗?考虑删除。出现三段式列举吗?改为两项或四项。听起来像可引用的金句吗?重写它。

特色元素

简历包装环节

如果文章涉及实战项目,可以加一个如何写到简历上的模块,给出项目名称和描述、技术栈、核心职责(3-5条,公式:用技术栈解决了什么问题、实现了哪些业务,有哪些量化数据)。这部分可以用列表,因为是结构化的简历信息。

图片和流程图处理

文章中需要配图的地方,可以用占位符标注出来,方便后续插入。

截图/图片占位: 用【此处插入xxx的图片:关键信息:xxx】格式标注。比如段落描述了 Claude Code 的某个功能,紧接着标注【此处插入Claude Code 执行命令的图片:关键信息:显示代码生成过程】。关键信息要写清楚这张图需要展示什么内容,方便后续截图时知道该截哪里。

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

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

互动钩子

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

禁止事项

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