content-writer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Content Writer

内容写手

Overview

概述

This skill enables writing high-quality content across different platforms and audiences. It dynamically selects the appropriate writing style based on the task, then applies that style consistently. Available styles include deep technical blog posts, social media content (LinkedIn, X/Twitter), tutorials, and more.
该技能支持针对不同平台和受众创作高质量内容。它会根据任务动态选择合适的写作风格,并在内容中始终保持该风格的一致性。可用风格包括深度技术博客文章、社交媒体内容(LinkedIn、X/Twitter)、教程等多种类型。

Style Selection

风格选择

Before writing, determine the appropriate style based on these factors:
FactorConsider
PlatformBlog, LinkedIn, X/Twitter, documentation, newsletter
AudienceEngineers, executives, general tech audience, developers
DepthDeep-dive technical, lightweight explainer, announcement
ToneAuthoritative, conversational, promotional, educational
LengthLong-form (2000+ words), medium (500-1500), short (<500), thread
开始写作前,需根据以下因素确定合适的风格:
因素考量方向
平台博客、LinkedIn、X/Twitter、文档、通讯稿
受众工程师、高管、普通技术受众、开发者
深度深度技术解析、轻量化讲解、公告类
语气权威型、对话型、推广型、教育型
篇幅长篇(2000+词)、中篇(500-1500词)、短篇(<500词)、推文串

Style Decision Tree

风格决策树

Is this for social media?
├─ Yes → LinkedIn or X/Twitter style
│   ├─ Professional/B2B → LinkedIn Style
│   └─ Tech community/casual → X/Twitter Style
└─ No → Is this a technical blog post?
    ├─ Yes → What voice/style?
    │   ├─ Karpathy-style (conversational, personal, pragmatic) → Karpathy Style
    │   ├─ Opinion-forward analysis → Deep Technical Style
    │   ├─ Lightweight explainer → Simplified Technical Style
    │   └─ Tutorial/how-to → Tutorial Style
    └─ No → What type?
        ├─ Announcement → Announcement Style
        ├─ Newsletter → Newsletter Style
        └─ Documentation → Documentation Style
是否用于社交媒体?
├─ 是 → 采用LinkedIn或X/Twitter风格
│   ├─ 专业/B2B场景 → LinkedIn风格
│   └─ 技术社区/非正式场景 → X/Twitter风格
└─ 否 → 是否为技术博客文章?
    ├─ 是 → 采用何种语气/风格?
    │   ├─ Karpathy风格(对话式、个人化、务实型)→ Karpathy风格
    │   ├─ 观点导向型分析 → 深度技术风格
    │   ├─ 轻量化讲解 → 简化技术风格
    │   └─ 教程/操作指南 → 教程风格
    └─ 否 → 内容类型是什么?
        ├─ 公告 → 公告风格
        ├─ 通讯稿 → 通讯稿风格
        └─ 文档 → 文档风格

Available Styles

可用风格

1. Karpathy Style (Conversational Technical)

1. Karpathy风格(对话式技术写作)

Use when: Writing technical content that feels personal and accessible. Best for blog posts about AI/ML, tutorials, or technical essays where you want the voice of an expert friend explaining things over coffee.
Characteristics:
  • First-person, conversational tone ("I've found that...", "Here's what I learned...")
  • Starts with personal experience or intriguing premise
  • Progressive complexity (simple → detailed)
  • Dry wit and occasional humor
  • Honest about limitations and failures
  • Pragmatic ("It only has to be right more often than not")
  • Numbered frameworks and structured approaches
  • Memorable, quotable lines
Load:
references/karpathy-style.md
for comprehensive guidance
Core Philosophy: "Don't be a hero. Start simple. Be patient."
Opening Hooks (choose one):
PatternExample
Personal experience"I still remember when I trained my first recurrent network..."
Intriguing premise"We're going to feed 2 million selfies to a neural network and have it tell us what makes a selfie good."
Leaky abstraction"Neural nets are not 'off-the-shelf' technology the second you deviate slightly from training an ImageNet classifier."
Strong observation"Trees are solidified air."
Example opening:
"I've trained a lot of neural networks over the years and I've come to find that the process isn't nearly as simple as it seems. They are a leaky abstraction. Here's what I've learned."
Tweet/X style (short-form):
  • Pithy observations that compress insight
  • Strong statements (90% true, ignore counterexample police)
  • Unexpected connections between domains
  • Personal candor about struggles and discoveries
适用场景: 创作兼具个人感与易读性的技术内容。最适合AI/ML相关博客文章、教程或技术随笔,希望以“专家好友边喝咖啡边讲解”的口吻呈现内容时使用。
特点:
  • 第一人称、对话式语气(如“我发现……”、“这是我的经验……”)
  • 以个人经历或引人入胜的前提开篇
  • 复杂度逐步提升(从简单到详细)
  • 带有冷幽默或偶尔的趣味表达
  • 坦诚提及局限性和失败案例
  • 务实导向(“只要大多数时候正确就够了”)
  • 采用编号框架和结构化方法
  • 包含令人印象深刻、值得引用的语句
参考资源: 加载
references/karpathy-style.md
获取全面指导
核心理念: “别逞能。从简单入手。保持耐心。”
开篇钩子(任选其一):
模式示例
个人经历“我至今还记得第一次训练循环神经网络时的场景……”
引人入胜的前提“我们将把200万张自拍照输入神经网络,让它分析出好照片的特质。”
抽象概念拆解当你略微偏离ImageNet分类器训练场景时,神经网络就不再是‘开箱即用’的技术了。”
犀利观察“树木是固化的空气。”
开篇示例:
“这些年来我训练过很多神经网络,发现这个过程远没有看起来那么简单。它们是一种‘有漏洞的抽象概念’。以下是我的经验总结。”
X/Twitter短格式风格:
  • 凝练的观察总结,浓缩核心见解
  • 明确的观点(90%准确即可,无需纠结反例)
  • 不同领域间的意外关联
  • 坦诚分享个人的挣扎与发现

2. Deep Technical Style (Opinion-Forward Analysis)

2. 深度技术风格(观点导向型分析)

Use when: Writing opinion-forward technical analysis about AI, LLMs, agents, or engineering topics. Best for content targeting senior engineers who want bold takes backed by evidence.
Characteristics:
  • Contrarian, opinion-forward opening hooks
  • "Do the simple thing first" philosophy
  • Concrete examples with specific numbers
  • Takes clear positions and makes predictions
  • Varied sentence length, active voice
Load:
references/deep-technical-style.md
for comprehensive guidance
Core Philosophy: "Do the simple thing first."
  • Embrace the black box: Focus on inputs/outputs, not internal mechanisms
  • Domain expertise over technical knowledge
  • Simplicity as virtue: Start simple, add complexity only when necessary
  • Opinion-forward: Take clear positions and make predictions boldly
Opening Hooks (choose one):
PatternExample
Contrarian position"The death of prompt engineering has been greatly exaggerated."
Practical pain point"So you need to hire someone to build your LLM multi-agent system..."
Challenge assumptions"If you've been stuffing thousands of tokens thinking 'more context = better'..."
Surprising simplicity"Claude Code isn't built on a complex multi-agent swarm. It's a single-threaded loop."
Example opening:
"Most AI architectures are overengineered. A single-threaded loop often outperforms elaborate multi-agent orchestrations."
适用场景: 创作关于AI、大语言模型(LLM)、Agent或工程主题的观点导向型技术分析。最适合面向资深工程师的内容,希望呈现有论据支撑的大胆观点时使用。
特点:
  • 采用反主流或观点鲜明的开篇钩子
  • “先做简单的事”的核心理念
  • 包含具体数字的实例
  • 立场明确并作出预测
  • 句子长度多变,使用主动语态
参考资源: 加载
references/deep-technical-style.md
获取全面指导
核心理念: “先做简单的事。”
  • 接受黑箱特性:关注输入/输出,而非内部机制
  • 领域专业知识优先于技术细节
  • 以简洁为美德:从简单入手,仅在必要时增加复杂度
  • 观点导向:明确表达立场并大胆作出预测
开篇钩子(任选其一):
模式示例
反主流立场“提示词工程已死的说法被严重夸大了。”
实际痛点“所以你需要雇人搭建LLM多Agent系统……”
挑战固有假设“如果你还在往模型里塞数千个tokens,认为‘上下文越多越好’……”
出人意料的简洁性“Claude Code并非基于复杂的多Agent集群,它只是一个单线程循环。”
开篇示例:
“大多数AI架构都过度设计了。一个单线程循环的性能往往优于复杂的多Agent编排。”

3. LinkedIn Style

3. LinkedIn风格

Use when: Writing professional content for LinkedIn—thought leadership, announcements, industry insights.
Characteristics:
  • Hook in first line (appears before "see more")
  • Short paragraphs (1-2 sentences each)
  • Line breaks between paragraphs for mobile readability
  • Personal angle or story
  • Call-to-action or question at the end
  • Strategic use of emojis (sparingly, professionally)
  • 1300 characters ideal, 3000 max
Structure:
[Hook line that creates curiosity]

[Personal context or story - 2-3 short paragraphs]

[Key insight or lesson - bulleted if multiple points]

[Call-to-action or engaging question]

#relevanthashtags (3-5 max)
Example:
Most AI features never make it to production.
Not because the models aren't good enough.
Because teams build for demos, not for users.
After shipping 50+ AI features, here's what actually matters:
→ Start with the simplest possible implementation → Measure what users do, not what they say → Treat AI like any other code: test it, monitor it, iterate
What's the biggest lesson you've learned shipping AI?
适用场景: 为LinkedIn创作专业内容——思想领导力文章、公告、行业见解等。
特点:
  • 第一句即为钩子(显示在“查看更多”之前)
  • 短段落(每段1-2句话)
  • 段落间添加换行,适配移动端阅读
  • 包含个人视角或故事
  • 结尾加入行动号召或互动问题
  • 战略性使用表情符号(少量、专业)
  • 理想长度为1300字符,最多不超过3000字符
结构:
[引发好奇心的钩子句]

[个人背景或故事 - 2-3个短段落]

[核心见解或经验 - 若有多条可使用项目符号]

[行动号召或互动问题]

#相关话题标签(最多3-5个)
示例:
大多数AI功能从未真正落地到生产环境。
不是因为模型不够好。
而是因为团队是为演示而建,而非为用户而建。
在交付50多个AI功能后,我发现真正重要的是这些:
→ 从最简单的实现方式入手 → 关注用户的实际行为,而非他们的口头反馈 → 像对待其他代码一样对待AI:测试、监控、迭代
你在交付AI功能时学到的最重要经验是什么?

4. X/Twitter Style

4. X/Twitter风格

Use when: Writing for X/Twitter—quick insights, hot takes, thread explainers, engagement posts.
Characteristics:
  • Punchy, high-signal first tweet
  • No filler words
  • Threads: numbered, each tweet standalone valuable
  • Contrarian takes perform well
  • Code snippets or visuals boost engagement
  • 280 characters per tweet, threads typically 5-15 tweets
Thread structure:
1/ [Bold claim or hook]

2/ [Context or "here's why"]

3-N/ [Key points, one per tweet]

N+1/ [Takeaway or call-to-action]

[Optional: link to longer content]
Example:
Unpopular opinion: RAG is overengineered for most use cases.
A well-crafted system prompt often outperforms a poorly designed RAG pipeline.
Thread on when to use (and skip) RAG 🧵
适用场景: 为X/Twitter创作内容——快速见解、热门观点、推文串讲解、互动帖子等。
特点:
  • 第一句推文简洁有力、信息密度高
  • 无冗余词汇
  • 推文串:编号呈现,每条推文独立有价值
  • 反主流观点表现更佳
  • 代码片段或视觉内容可提升互动率
  • 单条推文280字符以内,推文串通常包含5-15条推文
推文串结构:
1/ [大胆断言或钩子]

2/ [背景说明或“原因如下”]

3-N/ [核心要点,每条推文一个]

N+1/ [结论或行动号召]

[可选:指向长内容的链接]
示例:
非主流观点:对于大多数场景来说,RAG被过度设计了。
一个精心编写的系统提示词,往往性能优于设计糟糕的RAG流水线。
关于何时使用(及跳过)RAG的推文串 🧵

5. Simplified Technical Style

5. 简化技术风格

Use when: Writing accessible technical content for broader audiences—explainers, introductions, "what is X" posts.
Characteristics:
  • Start with the "why it matters" not the "what it is"
  • Analogies to familiar concepts
  • Avoid jargon or define it immediately
  • Progressive complexity (simple → detailed)
  • Concrete examples before abstract explanations
Example opening:
Every time you ask ChatGPT a question, something interesting happens behind the scenes. The AI doesn't just "know" the answer—it builds one, word by word, based on patterns it learned from millions of conversations.
适用场景: 为广泛受众创作易理解的技术内容——讲解文、入门介绍、“什么是X”类帖子。
特点:
  • 从“为什么重要”而非“是什么”开篇
  • 用熟悉的概念做类比
  • 避免行话,若使用需立即定义
  • 复杂度逐步提升(从简单到详细)
  • 先给出具体示例,再进行抽象解释
开篇示例:
每次你向ChatGPT提问时,后台都在发生有趣的事情。AI并非“知道”答案——它会根据从数百万对话中学到的模式,逐词构建答案。

6. Tutorial Style

6. 教程风格

Use when: Writing step-by-step guides, how-tos, implementation walkthroughs.
Characteristics:
  • Clear prerequisites upfront
  • Numbered steps
  • Code blocks with comments
  • "What you'll learn" summary
  • Troubleshooting section
  • Working example at the end
Structure:
undefined
适用场景: 创作分步指南、操作手册、实现流程讲解。
特点:
  • 开篇明确列出前置要求
  • 采用编号步骤
  • 包含带注释的代码块
  • 有“你将学到什么”的摘要
  • 包含故障排除部分
  • 结尾提供可运行的示例
结构:
undefined

What You'll Build

你将构建什么

[One sentence + screenshot/diagram]
[一句话说明 + 截图/示意图]

Prerequisites

前置要求

[Bulleted list]
[项目符号列表]

Steps

步骤

Step 1: [Action verb]

步骤1:[动作动词]

[Explanation + code]
[说明 + 代码]

Step 2: ...

步骤2:...

Troubleshooting

故障排除

[Common issues + solutions]
[常见问题 + 解决方案]

Next Steps

下一步

[Where to go from here]
undefined
[后续学习方向]
undefined

7. Announcement Style

7. 公告风格

Use when: Announcing features, releases, milestones, company news.
Characteristics:
  • Lead with the news, not the backstory
  • What it is → Why it matters → How to use it
  • Keep it concise
  • Clear call-to-action
  • Links to more detailed content
Example:
We just shipped streaming support for Deep Agent.
Now you can see your agent's thinking in real-time—tool calls, responses, everything—as it happens.
Why it matters: Debugging agent loops is 10x easier when you can watch them run.
Try it:
createDeepAgent({ model, onEvent: console.log })
适用场景: 发布功能更新、版本迭代、里程碑、公司新闻等。
特点:
  • 直接以新闻点开篇,而非背景故事
  • 结构:是什么 → 为什么重要 → 如何使用
  • 内容简洁
  • 明确的行动号召
  • 指向详细内容的链接
示例:
我们刚刚为Deep Agent推出了流式支持功能。
现在你可以实时看到Agent的思考过程——工具调用、响应内容等所有细节,同步呈现。
重要性:当你能实时观察Agent循环运行时,调试工作会轻松10倍。
立即试用:
createDeepAgent({ model, onEvent: console.log })

Writing Workflow

写作工作流

Step 1: Identify the Style

步骤1:确定风格

Ask these questions:
  1. Where will this be published?
  2. Who is the primary audience?
  3. What action should readers take after reading?
  4. How much time will readers spend on this?
思考以下问题:
  1. 内容将发布在哪个平台?
  2. 主要受众是谁?
  3. 读者阅读后应采取什么行动?
  4. 读者会花多少时间阅读?

Step 2: Load Style Reference

步骤2:加载风格参考

For Deep Technical style, load
references/deep-technical-style.md
for detailed guidance including:
  • 7 opening hook patterns with examples
  • 5 argumentative structures
  • 10+ rhetorical techniques
  • 8 recurring themes to weave throughout
  • Sentence-level craft patterns
  • Pre-publication checklist
For other styles, refer to the characteristics above.
对于深度技术风格,加载
references/deep-technical-style.md
获取详细指导,包括:
  • 7种开篇钩子模式及示例
  • 5种论证结构
  • 10+种修辞技巧
  • 8+种可贯穿内容的常见主题
  • 句子层面的写作模式
  • 发布前检查清单
对于其他风格,参考上述的风格特点部分。

Step 3: Draft with Style Constraints

步骤3:遵循风格约束进行草稿创作

Apply the chosen style's characteristics from the start. Don't write generically then "style" it later—the style should inform structure, not just tone.
从一开始就应用所选风格的特点。不要先写通用内容再“套风格”——风格应指导结构,而非仅调整语气。

Step 4: Review Against Style Checklist

步骤4:对照风格检查清单审核

Each style has implicit requirements. Before finalizing:
Karpathy Style:
  • First-person, conversational voice?
  • Opens with personal experience or intriguing premise?
  • Honest about limitations ("This might be wrong, but...")?
  • Progressive complexity (simple → detailed)?
  • Contains dry wit or memorable lines?
  • Pragmatic advice, not theoretical?
Deep Technical Style:
  • Contrarian or surprising opening?
  • Specific numbers/examples?
  • Clear position taken?
  • Explains "why" not just "what"?
  • Subheadings as mini-arguments?
  • Active voice throughout?
LinkedIn Style:
  • Hook visible before "see more"?
  • Mobile-friendly spacing?
  • Personal angle included?
  • Ends with engagement prompt?
X/Twitter Style:
  • First tweet standalone compelling?
  • Each tweet <280 chars?
  • No filler words?
  • Thread numbered clearly?
每种风格都有隐含要求。定稿前需检查:
Karpathy风格:
  • 是否采用第一人称、对话式语气?
  • 是否以个人经历或引人入胜的前提开篇?
  • 是否坦诚提及局限性(如“这可能不对,但……”)?
  • 复杂度是否逐步提升(从简单到详细)?
  • 是否包含冷幽默或令人印象深刻的语句?
  • 是否为务实建议而非理论内容?
深度技术风格:
  • 是否采用反主流或令人惊讶的开篇?
  • 是否包含具体数字/实例?
  • 是否立场明确?
  • 是否解释了“为什么”而非仅“是什么”?
  • 子标题是否作为小型论点?
  • 是否全程使用主动语态?
LinkedIn风格:
  • 钩子是否显示在“查看更多”之前?
  • 是否适配移动端阅读的排版?
  • 是否包含个人视角?
  • 结尾是否有互动引导?
X/Twitter风格:
  • 第一条推文是否独立有吸引力?
  • 每条推文是否在280字符以内?
  • 无冗余词汇?
  • 推文串是否编号清晰?

AI Slop Avoidance

规避AI腔

Critical: All content must avoid patterns that signal AI-generated text. Load
references/ai-slop-avoidance.md
for comprehensive guidance.
关键要求: 所有内容必须避免暴露AI生成痕迹的模式。加载
references/ai-slop-avoidance.md
获取全面指导。

Quick Reference: Words to Ban

快速参考:禁用词汇

Never use these overused AI words:
CategoryBanned Words
Verbsdelve, embark, unleash, harness, unlock, navigate, revolutionize, foster, elevate
Adjectivesvibrant, bustling, intricate, pivotal, crucial, cutting-edge, robust, seamless, meticulous
Nounstapestry, realm, landscape, paradigm, synergy, beacon, testament, game-changer
Phrases"it's important to note", "in today's digital age", "dive into", "at its core", "a myriad of"
绝不使用以下被AI过度滥用的词汇:
类别禁用词汇
动词delve, embark, unleash, harness, unlock, navigate, revolutionize, foster, elevate
形容词vibrant, bustling, intricate, pivotal, crucial, cutting-edge, robust, seamless, meticulous
名词tapestry, realm, landscape, paradigm, synergy, beacon, testament, game-changer
短语"it's important to note", "in today's digital age", "dive into", "at its core", "a myriad of"

Quick Reference: Patterns to Avoid

快速参考:需避免的模式

PatternProblemFix
Em-dashes (—)Strong AI signal, ban entirelyUse commas, parentheses, periods (hyphens/en-dashes OK)
Uniform sentencesAll ~25-30 wordsMix 5-word punches with 40-word explanations
Excessive hedging"might", "arguably", "perhaps"Take clear positions
Immediate listsJump to bullets without narrativeBuild tension first
Perfect grammarZero typos feels roboticOccasional imperfection is human
Balanced both-sidesArtificial neutralityTake a stance
模式问题修正方法
长破折号(—)强烈的AI生成信号,完全禁用使用逗号、括号、句号(短横线/半长破折号允许使用)
句子长度统一所有句子约25-30词混合使用5词短句和40词长句
过度模糊使用“可能”、“可以说”、“或许”等词明确表达立场
直接跳转至列表未做铺垫就使用项目符号先构建叙事张力
完美语法零拼写错误显得不真实偶尔出现小瑕疵更具人情味
中立平衡刻意保持中立显得虚假明确表达立场

AI Slop Checklist (Apply to All Content)

AI腔检查清单(适用于所有内容)

  • Zero banned words from the list above?
  • Zero em-dashes (—) in the entire piece?
  • Sentence lengths vary dramatically (some <10 words, some >35)?
  • Contains specific names, numbers, dates?
  • Has personal voice or anecdotes?
  • Takes clear positions without excessive hedging?
  • Avoids "In conclusion" / "To summarize" closings?
  • 完全未使用上述禁用词汇?
  • 整篇内容中完全没有长破折号(—)?
  • 句子长度差异显著(部分少于10词,部分超过35词)?
  • 包含具体名称、数字、日期?
  • 带有个人语气或轶事?
  • 立场明确,无过度模糊表达?
  • 避免使用“总结来说”/“综上所述”这类结尾?

Resources

资源

references/

references/目录

  • karpathy-style.md
    - Guide for writing in Andrej Karpathy's conversational, pragmatic technical style with blog post patterns, tweet patterns, and recurring themes
  • deep-technical-style.md
    - Comprehensive guide for opinion-forward technical blog posts with detailed examples, rhetorical techniques, and pre-publication checklist
  • ai-slop-avoidance.md
    - Detailed guide to avoiding AI-generated content patterns
  • karpathy-style.md
    - Andrej Karpathy对话式务实技术写作风格指南,包含博客文章模式、推文模式和常见主题
  • deep-technical-style.md
    - 观点导向型技术博客文章全面指南,包含详细示例、修辞技巧和发布前检查清单
  • ai-slop-avoidance.md
    - 规避AI生成内容痕迹的详细指南

Extending This Skill

扩展该技能

To add new writing styles:
  1. Analyze 5-10 examples of the target style
  2. Extract patterns: opening hooks, structure, tone, length constraints
  3. Create a reference file in
    references/[style-name]-style.md
  4. Add the style to the decision tree and Available Styles section
  5. Include a checklist for that style in the Review step
如需添加新写作风格:
  1. 分析5-10个目标风格的示例
  2. 提取模式:开篇钩子、结构、语气、篇幅限制
  3. references/[style-name]-style.md
    创建参考文件
  4. 将该风格添加至决策树和“可用风格”部分
  5. 在“审核步骤”中添加该风格的检查清单