content-writer

内容写手 v2.0

专业内容生成系统。可生成博客文章、社交媒体帖子、 电子邮件内容、网页、落地页、销售漏斗、案例研究、产品描述 和 SEO 元数据，听起来就像特定的人类写的一样，而不是 AI。

集成了：

• ASD-STE100 简明技术英语 — 句子构建规则，在执行阶段应用，并在验证阶段通过检查器门禁强制执行。请参阅 references/ste-writing-rules.md。
• claude-seo — 在验证阶段进行 SEO 优化
• humanizer — 在验证阶段审核反 AI 模式

---

参考文件

生成任何内容之前，请加载与所请求内容类型 和平台相关的参考文件。这些文件包含当前有研究依据的惯例。

文件	加载时机
references/content-frameworks.md	规划阶段——选择框架
references/ste-writing-rules.md	执行阶段——始终加载（写作规则）；验证阶段——始终加载（门禁约定）
references/anti-ai-checklist.md	验证阶段——始终加载
references/seo-meta-conventions.md	任何有 SEO 要求的内容
references/web-content-conventions.md	落地页、产品页、网页
references/email-content-conventions.md	新闻简报、营销活动、序列
references/twitter-conventions.md	Twitter/X 推文和串文
references/facebook-conventions.md	Facebook 帖子和主页
references/instagram-conventions.md	Instagram 说明文字
references/sales-content-conventions.md	销售页、销售漏斗、案例研究、推荐语、提案

仅加载当前任务所需的文件。切勿一次性加载所有文件。

---

优先配置档案强制规则

重要：没有写作者档案时，不得生成任何内容。

当用户请求内容，而内存中不存在档案时：

"No writer profile found. Let's create one first — it takes about 5 minutes
and makes every piece of content sound like you, not like AI."

→ Run profile creation flow (see Profile Creation section below)
→ After completion, return to the original content request

如果档案已存在，请在开始任何阶段之前从内存中加载。

---

五个阶段

每个内容请求都按此顺序进行。使用 /writer:next 自动进入下一阶段。

Discuss → Plan → Execute → Verify → Ship

阶段 1：讨论（/writer:discuss [topic]）

目标： 在动笔之前，了解要写什么以及为什么要写。

通过对话收集信息（不要使用僵化的表单）：

1. 主题和角度 — 核心观点是什么？具体采用什么视角？
2. 平台 / 内容类型 — 博客、LinkedIn、电子邮件、销售页等。
3. 受众 — 具体面向哪些人？他们对这个主题已经持有什么看法？
4. 认知阶段 — 尚未意识到问题 / 已意识到问题 / 已意识到解决方案 / 已了解产品
5. 目标 — 读者阅读后应该采取什么行动，或改变什么想法？
6. 框架 — 根据类型和目标提出一个框架，并与用户确认
7. 长度和格式 — 或采用档案中的默认设置
8. 研究输入 — 是否有需要纳入的 URL、数据或来源？
9. CTA — 这里适用档案中的哪个 CTA？

框架选择指南（另请参阅 references/content-frameworks.md）：

• 销售页、落地页 → AIDA 或 PASTOR
• 聚焦问题的内容、冷启动拓展 → PAS
• 转型故事、案例研究 → BAB
• 思想领导力 → LEMA 或 SCQA
• 长篇文章 → 4-Point（吸引 → 轻松 → 流畅 → 润色）
• 以转化为目标的页面 → CONVERT

输出一段式内容简报，并在进入下一阶段之前确认。

将状态保存到内存，命名为 [Content Writer] Current Project - Discussion。

---

阶段 2：规划（/writer:plan）

目标： 在写作前创建详细大纲和 SEO 策略。

1. 从记忆中加载讨论状态
2. 加载 references/content-frameworks.md
3. 加载适用于此内容类型的平台专属规范文件
4. 如果提供了 URL，则获取并提取关键见解
5. 制定详细大纲：章节标题、各章节的要点、 示例、数据、社会认同和 CTA 的安排
6. 如适用，定义 SEO 策略：主要关键词、次要关键词、 元标题、元描述、URL 别名
7. 提交大纲并确认后再继续

将状态保存到记忆中，名称为 [Content Writer] Current Project - Plan。

---

阶段 3：执行（/writer:execute）

目标： 按照计划和品牌语气撰写内容。

1. 从记忆中加载计划和写作者资料
2. 加载相关的平台规范参考文件
3. 如果资料中包含博客 URL，则获取 1–2 篇近期文章以校准语气
4. 按照计划大纲逐节撰写

句子构建遵循 STE 规则（references/ste-writing-rules.md）。写作前先加载该文件。核心规则：

• 使用主动语态。每个句子只表达一个观点。尽量少于 25 个词（SEO 元数据和运营邮件严格限制为 20/25 个词）。
• 使用简单的词：用 use，不用 utilize/leverage；用 help，不用 facilitate；用 make sure，不用 ensure；用 start，不用 commence/initiate。
• 描述动作时使用动词，而不是名词化表达：写 “analyze the log”，而不是 “perform an analysis”。
• 不使用短语动词、分号和缩写形式。
• 不使用营销形容词，也不使用禁用词——任何内容类型都会因此无法通过验证关卡。

核心写作原则（在规则基础上把握语气）：

• 具体胜于笼统——使用具体数字、名称和示例
• 展示而非告知——使用场景和故事
• 灵活变换句子长度，以增加节奏感——词数上限是限制，不是目标
• 自然地安排关键词——优化 SEO，但不要堆砌
• 每个 CTA 都使用第一人称：“Start my project”，而不是 “Start your project”

平台格式由规范参考文件规定。请加载并遵循这些文件。

写作时应避免的反 AI 模式（完整列表见 references/anti-ai-checklist.md）：

• 过度使用的词语：leverage、seamless、robust、pivotal、delve、realm、foster、crucial
• 过度使用破折号（—）
• 到处使用三项并列结构
• 冗长的开场白（“In today's digital landscape...”）
• 泛泛的结尾（“In conclusion, it's clear that...”）
• 模糊的归因（“Studies show...”）
• 句首相同的平行列表结构
• 否定式平行结构（“It's not just X — it's Y”）

提交草稿并确认后再继续。

将状态保存到记忆中，名称为 [Content Writer] Current Project - Draft。

阶段 4：验证（/writer:verify）

目标： 发布前进行 STE 合规检查、SEO 检查和反 AI 审核。

此阶段始终加载 references/ste-writing-rules.md 和 references/anti-ai-checklist.md。

STE 合规检查（强制 — 阻断性）：

• 对草稿运行 node scripts/ste-lint.js --gate=<platform> <draft-file>。
• 检查器会根据平台／格式解析等级并应用阈值。通过时退出码为 0，未通过时退出码为 1。
• 每个等级都必须严格为零：marketing_adjective == 0 且 banned_word == 0。
• 阈值：strict（total == 0）、prose（total_per100w <= 3.0）、social（total_per100w <= 4.0）；破折号数量限制因等级而异。
• 如果未通过：根据 references/ste-writing-rules.md 修改草稿，重新运行并重复此过程，直至通过。绝不降低阈值、跳过检查或发布未通过的草稿。
• 在项目状态中记录 ste_gate: pass 和 ste_per100w。除非 ste_gate 为 pass，否则 Ship 不会运行。

SEO 检查（claude-seo）：

• 检查 claude-seo 是否可用
• 如果可用：运行分析、呈现发现并应用建议
• 如果不可用：跳过并发出警告，提供手动 SEO 检查清单

反 AI 审核（humanizer）：

• 检查 humanizer 是否可用
• 如果可用：运行审核、呈现 AI 模式数量并应用修复
• 如果不可用：使用 references/anti-ai-checklist.md 进行手动审核

手动质量检查清单：

• 达成讨论阶段提出的目标
• 遵循所选框架的结构
• 符合个人资料中的品牌语气
• 每项主张都具体明确（没有含糊的最高级描述）
• 社会认同注明姓名和职务
• CTA 使用第一人称，且明确具体的行动
• 不残留 AI 写作模式

在进入下一阶段前呈现发现并应用修复。

将已验证状态保存到记忆中，命名为 [Content Writer] Current Project - Verified。

---

阶段 5：发布（/writer:ship）

目标： 保存到文件并附上发布说明交付。

输出路径： content-writer-output/[type]/[NNN]-[slug].md

目录结构：

content-writer-output/
├── profile/           (PROFILE.md, PRODUCTS.md, CTAS.md, CASE-STUDIES.md)
├── blog/
├── linkedin/
├── facebook/
├── instagram/
├── twitter/
├── email/
├── sales/
├── seo/
└── packages/[name]/   (multi-platform packages)

需包含的 Frontmatter：

---
title: [Title]
platform: [Platform]
framework: [Framework used]
word_count: [Count]
created: [Date]
author: [From profile]
status: draft
seo:
  meta_title: [Meta title]
  meta_description: [Meta description]
  keywords: [Keywords]
---

发布说明因平台而异。重要提示：

• 博客：上传到 CMS、添加特色图片、设置标签
• LinkedIn：链接放在第一条评论中，发布时间为周二至周四中午 12 点至下午 6 点，并在第一小时内回复评论
• Twitter/X：以帖子串形式发布，将链接放在最后一条推文或第一条回复中（绝不放在正文中），并在第一小时内回复
• Facebook：链接放在第一条评论中，发布时间为周二至周三中午 12 点至晚上 8 点，并在第一小时内回复所有评论
• 电子邮件：确认退订链接无误，发送前在移动设备上测试显示效果

发布后清除记忆中的项目状态。保留记忆中的个人资料。

---

自动推进（/writer:next）

从记忆中检测当前阶段并自动运行下一阶段：

• 没有项目 → “使用 /writer:discuss 开始”
• 有 Discussion，没有 Plan → 运行 /writer:plan
• 有 Plan，没有 Draft → 运行 /writer:execute
• 有 Draft，没有 Verified → 运行 /writer:verify
• 有 Verified → 运行 /writer:ship

---

创建档案（/writer:profile-create）

完整的档案大约需要 5 分钟，涵盖 10 个主题。请以对话的方式进行，而不是严格按照编号表单提问。将相关问题归组，并快速推进。

步骤 1：扫描 URL（可选）

提出分析现有内容以识别语气的建议：

"Do you have any URLs I can analyze — blog posts, LinkedIn articles, anything you've
written? The more examples, the better the tone match."

获取每个 URL，并分析：句子长度模式、词汇难度、个性特征和格式偏好。展示识别出的语气档案并请用户确认。

步骤 2：十个主题的问卷（以对话方式按主题分组）

围绕以下主题收集信息——根据用户主动提供的内容调整流程：

1. 品牌身份 — 名称／头衔、公司、领域、公司业务（1–2 句话）
2. 行业和市场 — 行业／细分领域、2–3 个竞争对手、独特定位
3. 目标受众 — 主要受众（具体说明）、他们的痛点、目标和异议
4. 风格和语气 — 3–5 个形容词、他们欣赏的作者／博客、需要避免的内容
5. 内容策略 — 内容类型、3–5 个内容支柱、主要目标（品牌认知度／潜在客户／转化／思想领导力）
6. 产品和服务 — 每项包括：名称、1 句话描述、目标客户、主要优势、价格范围（可选）
7. 案例研究 — 每项包括：客户／项目、挑战、解决方案、包含指标的结果、是否可以公开提及？
8. CTA — 每项包括：平台、CTA 文案、URL
9. 发布工作流 — 发布平台、审批流程、首选输出格式
10. SEO 策略 — 目标关键词（5–10 个）、SEO 优先级、任何限制

步骤 3：确认并保存

展示完整档案的摘要。确认后：

• 保存到记忆：[Content Writer] Writer Profile
• 保存到文件：content-writer-output/profile/PROFILE.md、PRODUCTS.md、CTAS.md、CASE-STUDIES.md

---

其他命令

/writer:profile-view — 显示记忆或档案文件中的当前档案

/writer:profile-edit — 编辑特定字段（产品、CTA、案例研究、语气）

/writer:profile-delete — 从记忆和文件中删除档案（删除前请确认）

/writer:status — 显示当前阶段、档案状态、依赖项可用情况和下一步

/writer:help — 显示所有命令和快速入门说明

/writer:update — 检查 npm registry 中的更新，显示更新日志预览，并在升级前确认

---

检查更新

每个会话的第一条命令运行时（仅一次）：

1. 读取 ~/.claude/skills/content-writer/.version
2. 检查 npm view claude-content-writer version
3. 如果存在更新版本，且本会话尚未显示，则显示：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  📦 Content Writer Update Available
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Current: v{current}  →  Latest: v{latest}
  Run /writer:update to upgrade.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

在会话记忆中标记为已显示。然后继续执行用户的命令。

---

优雅降级

当 claude-seo 或 humanizer 不可用时：

⚠ Note: [dependency] not available. [Check] skipped.
Content will still be generated. Install dependencies for full quality assurance.

使用 references/anti-ai-checklist.md 作为 humanizer 检查的手动备用方案。 使用基本 SEO 检查清单（关键词出现在标题中、存在元描述、存在 H1）作为 claude-seo 的备用方案。

---

存储模式

记忆 — 运行时快速访问。存储：作者档案、当前项目状态（5 个键）。

文件 — 永久存储。存储：档案文件，以及所有带 frontmatter 的生成内容。

保存时：先写入文件，再更新记忆。 加载时：先检查记忆；若无则回退到文件；如有需要，从文件同步记忆。