125 lines
4.2 KiB
Markdown
125 lines
4.2 KiB
Markdown
# Writing Styles Reference
|
||
|
||
本文档定义 `write-article` skill 的 5 类写作风格。每种风格都包含固定的语气、结构、禁忌。
|
||
|
||
## 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 句还没进主题。
|
||
- 一条短文塞入过多观点。
|
||
- 使用标题党或误导性陈述。
|
||
|
||
## 5) 栗子KK风格（`lizi_kk`）
|
||
|
||
> 基于 `personal-context/` 目录 5 篇已发表文章提炼，详见 `templates/author-style-lizi-kk.md`
|
||
|
||
### 语气
|
||
- 直接、有冲击力，口语化但不失深度
|
||
- 敢下判断（"99%"、"90%"），但必有数据支撑
|
||
- 自信但不傲慢，技术细节 + 类比解释
|
||
|
||
### 结构
|
||
1. **冲击式开头**：直接、有钩子，常用"说实话"、"先说结论"
|
||
2. **数字编号**：01, 02, 03... 分段清晰
|
||
3. **短段落**：每段 2-5 句话，单段不超过 150 字
|
||
4. **必备元素**：个人经历、具体案例、代码示例、数据支撑
|
||
5. **金句收尾**：名人引用 + CTA
|
||
|
||
### 语言特征
|
||
| 书面语 | 栗子KK风格 |
|
||
|--------|-----------|
|
||
| 我发现 | 说实话，我发现 |
|
||
| 这个问题很重要 | 这个问题我觉得特别典型 |
|
||
| 效果很好 | 效果立竿见影 |
|
||
| 很多人不知道 | 99%的教程都不提这个 |
|
||
| 成功了 | 这招真的管用 |
|
||
|
||
### 禁忌
|
||
- "赋能"、"生态"等空话
|
||
- 纯理论无案例
|
||
- 过长的代码块（影响阅读节奏）
|
||
- 没有个人观点
|
||
- 完美主义收尾（信奉"Done is better than perfect"）
|
||
- 聚合式"我的N个思考/感悟"编号列表（洞察必须散布到正文段落中）
|
||
- 连续 3 段以上长度均匀（每 3 段至少 1 个 ≤2 句话的短段）
|
||
- 抽象观点无具体场景跟随（每个判断后必须有时间/数字/工具名等细节）
|
||
|
||
### 适用场景
|
||
- 技术深度文章
|
||
- 产品发布/介绍
|
||
- 踩坑经验分享
|
||
- 行业趋势分析
|
||
|
||
## 风格选择建议
|
||
- 需要解释技术方案与实践细节：选 `tech_blog`
|
||
- 需要表达立场并说服读者：选 `opinion`
|
||
- 需要让读者可复现地完成任务：选 `tutorial`
|
||
- 需要快速传播观点或洞察：选 `social_short`
|
||
- **需要个人品牌风格、技术+实战**：选 `lizi_kk`
|