content-forge/.claude/skills/write-article/references/writing-styles.md

Writing Styles Reference

本文档定义 write-article skill 的 4 类写作风格。每种风格都包含固定的语气、结构、禁忌。

1) 技术博客（tech_blog）

语气

• 专业、克制、解释导向。
• 对术语给出必要定义，不炫技。
• 结论可验证，避免绝对化表达。

结构

1. 问题背景：问题是什么，为什么值得解决。
2. 核心方案：关键设计与取舍。
3. 实现细节：步骤、代码片段、配置或流程。
4. 验证结果：如何验证有效性，边界在哪里。
5. 总结与扩展：适用场景、下一步优化。

禁忌

• 只贴代码不解释设计意图。
• 用“黑魔法”式技巧替代可维护方案。
• 夸大性能收益但不给验证条件。

2) 观点文（opinion）

语气

• 立场鲜明，但论证必须有证据链。
• 可批判、可反驳，不做人身攻击。
• 允许价值判断，但要明确前提条件。

结构

1. 核心论点：开篇直接给结论。
2. 论据展开：2-3 个关键论据，逐条论证。
3. 反方视角：承认反例或限制条件。
4. 立场收束：重申结论并给出行动建议。

禁忌

• 情绪输出替代推理。
• 稻草人论证（曲解对方观点再反驳）。
• 断言“唯一正确答案”却不说明边界。

3) 教程（tutorial）

语气

• 教练式表达，步骤清晰、可执行。
• 默认读者不知道上下文，减少跳步。
• 重点是“让读者做出来”，不是展示作者懂多少。

结构

1. 目标与前置条件：完成后能得到什么，需要什么环境。
2. Step-by-step：按顺序执行，每步只有一个主要动作。
3. 结果验证：每步的预期输出或检查点。
4. 常见错误：高频坑位与修复方法。
5. 收尾：复盘关键点与可选进阶路线。

禁忌

• 跳过关键前置条件。
• 把多个动作塞进同一步，导致不可复现。
• 只给“成功路径”，不提供失败排查。

4) 社交短文（social_short）

语气

• 短促、有画面感、观点集中。
• 首句抓人，结尾可互动。
• 避免过度术语化，优先可传播表达。

结构

1. Hook：首句提出冲突、反差或问题。
2. 核心信息：1-2 个关键观点或故事片段。
3. 行动结尾：提问、CTA 或一句可转发结论。

禁忌

• 铺垫过长，前 3 句还没进主题。
• 一条短文塞入过多观点。
• 使用标题党或误导性陈述。

风格选择建议

• 需要解释技术方案与实践细节：选 tech_blog
• 需要表达立场并说服读者：选 opinion
• 需要让读者可复现地完成任务：选 tutorial
• 需要快速传播观点或洞察：选 social_short