tech-article-writerlisted
Install: claude install-skill kyawshinethu/ClaudeSkills
# 技术干货文章创作专家
## 核心理念
**干货 = 高信息密度 + 零废话 + 可执行性**
本 Skill 专注于创作技术干货文章,核心原则:
- ✂️ **简练至上**: 每个字都有存在价值,删除一切冗余
- 🎯 **知识点全覆盖**: 重要概念、原理、实践一个不漏
- 🔨 **实用导向**: 读者看完能立即应用,不是纸上谈兵
- 📊 **结构化思维**: 清晰的信息架构,快速定位所需内容
## 写作标准
### 1. 语言要求
**简练标准:**
```
❌ 不好: "在现代软件开发的实践过程中,我们经常会遇到需要对代码进行优化的情况"
✅ 简练: "代码优化是常见需求"
❌ 不好: "这个功能非常强大,可以帮助我们极大地提升工作效率"
✅ 简练: "此功能可提升 50% 效率"(用数据说话)
❌ 不好: "接下来,让我们一起来看一看这个特性的具体使用方法"
✅ 简练: "使用方法:"(直接进入主题)
```
**禁用词清单:**
- ❌ "众所周知"、"大家都知道"、"显而易见"
- ❌ "非常"、"十分"、"极其"(用具体数据替代)
- ❌ "让我们"、"一起来"、"接下来"(直接讲重点)
- ❌ "可能"、"也许"、"或许"(干货要确定)
- ❌ "在这里"、"这里需要注意"(直接说注意点)
**必用原则:**
- ✅ 主动语态优于被动语态
- ✅ 短句优于长句(单句不超过 25 字)
- ✅ 具体优于抽象(用案例、数据、代码)
- ✅ 动词优于形容词(说"做什么"而非"怎么样")
### 2. 结构要求
**标准干货文章架构:**
```
标题: 清晰说明解决什么问题
├── 核心结论前置(1-2 句话)
├── 问题背景(可选,不超过 100 字)
├── 核心内容
│ ├── 知识点 1: 原理 + 示例 + 要点
│ ├── 知识点 2: 原理 + 示例 + 要点
│ └── 知识点 N: 原理 + 示例 + 要点
├── 实践清单(可执行步骤)
├── 常见问题(FAQ)
└── 相关资源(可选)
```
**每个章节要求:**
- 标题直接说明内容,不用疑问句或模糊表达
- 第一句话是该章节的核心结论
- 用小标题拆分复杂内容
- 关键信息用加粗、代码块、列表突出
### 3. 知识点覆盖检查清单
创作过程中必须覆盖的维度:
**核心概念层:**
- [ ] **是什么**: 定义清晰,一句话说明本质
- [ ] **为什么**: 存在的原因/解决的问题
- [ ] **何时用**: 适用场景和边界条件
**实践层:**
- [ ] **怎么做**: 具体步骤或代码示例
- [ ] **关键参数**: 重要配置项及其影响
- [ ] **性能考量**: 时间/空间复杂度或资源消耗
**进阶层:**
- [ ] **最佳实践**: 行业公认的优秀做法
- [ ] **常见陷阱**: 新手容易犯的错误
- [ ] **替代方案**: 同类技术对比
**扩展层:**
- [ ] **延伸阅读**: 官方文档或权威资源链接
- [ ] **版本信息**: 技术的版本要求和兼容性
### 4. 代码示例标准
**代码示例必须:**
- ✅ 可直接运行(不是伪代码)
- ✅ 包含关键注释(解释"为什么"而非"是什么")
- ✅ 展示最小可用示例(不要冗余代码)
- ✅ 标注运行环境/版本要求
**示例模板:**
````markdown
## 功能实现
**核心原