让 AI 帮你写专栏：把工作流封装成可分享的能力

我经常搞一些小工具、小脚本，想写成文章分享出去。但每次写的时候都很痛苦：

• 开头怎么写？直接上代码太干，铺垫太多又啰嗦
• 代码贴多少？全贴没人看，只贴关键的又怕别人跑不起来
• 格式怎么统一？这篇用 <details> 折叠，那篇又没用

后来我把写作规范整理成了一个 Claude Code Skill。现在写专栏就一句话："帮我写一篇专栏介绍 xxx"，AI 自动按规范生成、落盘 Obsidian、发布上线。

这篇文章就是用这个 Skill 写的。

---

这是什么

workflow-article 是一个 Claude Code Skill，用来把技术方案写成"普通读者可复现"的专栏文章。

核心理念：我们分享的不只是代码，而是可以用自然语言触发的能力。

每篇专栏的终极目标：读者复制一个 SKILL.md 到 .claude/skills/xxx/，然后就能用自然语言让 AI 帮他干活。代码怎么写、命令怎么敲，都封装在 Skill 里了。

---

效果展示

我说：

"帮我写一篇专栏介绍链接抓取工作流"

AI 自动：

1. 读取相关知识文件和代码
2. 按规范结构生成文章（痛点开头 → 效果展示 → 快速开始 → 踩坑经验...）
3. 附上可复制的 Skill 配置
4. 保存到 Obsidian
5. 发布到 https://s.chen.rs/xxx

输出：

发布: ~/Documents/RS/.../链接抓取工作流.md
  标题: 链接抓取工作流：一键保存网页到 Obsidian
  Slug: link-capture-workflow
  脱敏完成: 规则 0 处, AI 11 处
  发布成功: <REDACTED_TOKEN>

从"我想写篇文章"到"链接在剪贴板里了"，30 秒。

---

快速开始

1. 创建 Skill 文件

mkdir -p <REDACTED_TOKEN>

2. 复制 SKILL.md（见文章末尾附录）

把附录里的 Skill 配置复制到 <REDACTED_TOKEN>。

3. 用自然语言触发

在 Claude Code 里直接说：

• "帮我写一篇专栏介绍 xxx"
• "把这个脚本写成教程"
• "写个文章讲讲怎么配置 yyy"

AI 会自动识别意图，按规范生成文章。

---

核心设计

文风定位

朋友在咖啡馆给你讲他最近搞的小玩意

• 有动机、有体感、有槽点
• 不啰嗦，讲完就完
• 代码照搬能跑

文章结构

1. 开头：痛点共鸣（2-3 句，不煽情）
2. 一句话说清楚这是什么
3. 效果展示
4. 快速开始（5 分钟跑通）
5. 技术架构 / 核心思路
6. 我踩过的坑
7. 下一步
8. 附录：Claude Code Skill 配置
9. 附录：给 AI 的复现指令

最重要的交付物

每篇文章必须输出一个可用的 SKILL.md。

读者不需要记命令、不需要看代码，只要有这个 Skill，用自然语言就能触发整个工作流。

这才是 AI 时代的工作流分享方式。

---

我踩过的坑

1. AI 总想贴"完整代码"

一开始 AI 生成的文章总有这种章节：

## 附录：完整代码

核心模块位于 tools/lib/xxx.ts，约 300 行...

这是代码文档的写法，不是文章的写法。

解决方案：在 SKILL.md 里明确禁止——"不要有'附录：完整代码'这种章节，我们是写文章，不是写代码文档"。

2. 忘记写 title 导致列表显示难看

frontmatter 里忘了加 title 字段，结果文章列表显示的是 slug（比如 <REDACTED_TOKEN>）而不是友好标题。

解决方案：在 SKILL.md 里强调——"title 必须填写，不填会用 slug 代替，很丑"。

3. 代码片段太长

一个代码块 50 行，读者根本不想看。

解决方案：规范里写清楚——"每个代码块 5-15 行为宜，超过就拆分讲解"。代码融入叙述，边讲边贴。

---

对比其他方案

---

下一步

如果你也想让 AI 帮你写专栏：

1. 复制附录里的 SKILL.md 到你的 .claude/skills/ 目录
2. 根据你的发布流程修改"输出与发布"部分
3. 开始用自然语言写文章

写完一篇后，你会发现：真正的价值不是这篇文章，而是附录里那个 Skill 配置。读者复制过去就能用，不用看懂你的代码。

---

附录：Claude Code Skill 配置

复制下面的内容到 <REDACTED_TOKEN>：

---
name: workflow-article
description: "把方案写成普通读者可复现的专栏文章。触发词：写教程、写文章、复现工作流、专栏、怎么配置、怎么实现"
---

# 工作流专栏写作

## 功能
把技术方案、脚本、工具写成"普通读者可复现"的专栏文章。自动按规范结构生成，包含效果展示、快速开始、踩坑经验等章节。

## 使用方式
直接用自然语言触发：
- "帮我写一篇专栏介绍 xxx"
- "把这个脚本写成教程"
- "写个文章讲讲怎么配置 yyy"

## 核心原则

**文风定位：朋友在咖啡馆给你讲他最近搞的小玩意**

- 有动机、有体感、有槽点
- 不啰嗦，讲完就完
- 代码照搬能跑

**绝对禁止：**
- 写成说明书/产品文档
- 纯参数表或命令堆砌
- "附录：完整代码"这种代码文档章节

## 文章结构

1. 开头：痛点共鸣（2-3 句，不煽情）
2. 一句话说清楚这是什么
3. 效果展示
4. 快速开始（5 分钟跑通）
5. 技术架构 / 核心思路
6. 我踩过的坑（2-3 个真实问题 + 解法）
7. 下一步
8. 附录：Claude Code Skill 配置（如果有对应 Skill）
9. 附录：给 AI 的复现指令

## 代码处理

- 代码片段融入正文，边讲边贴
- 每个代码块 5-15 行为宜，超过就拆分讲解
- 不要用 <details> 折叠代码

## 最重要的交付物

每篇文章必须输出一个可用的 SKILL.md，让读者可以直接复制使用。这是文章的核心价值：读者不需要看代码，只要有 Skill，用自然语言就能触发整个工作流。

## 示例
输入："帮我写一篇专栏介绍链接抓取工作流"

输出：
- 生成符合规范的专栏文章
- 包含可复制的 link-capture Skill 配置
- 保存到 Obsidian
- 发布到网页

---

附录：给 AI 的复现指令

帮我创建一个"写专栏"的 Claude Code Skill。

目标：用自然语言触发，让 AI 按统一规范生成技术专栏文章。

Skill 文件：<REDACTED_TOKEN>

核心规范：
1. 文风：朋友聊天式，有动机有槽点
2. 结构：痛点开头 → 效果展示 → 快速开始 → 核心思路 → 踩坑经验 → Skill 配置附录
3. 代码：融入正文讲解，5-15 行为宜，不要"附录：完整代码"
4. 最重要：每篇文章必须输出可用的 SKILL.md

触发词：写教程、写文章、专栏、怎么配置、怎么实现

成功标志：用户说"帮我写一篇专栏介绍 xxx"，AI 自动按规范生成文章