技术干货文章创作专家
核心理念
干货 = 高信息密度 + 零废话 + 可执行性
本 Skill 专注于创作技术干货文章,核心原则:
- ✂️ 简练至上: 每个字都有存在价值,删除一切冗余
- 🎯 知识点全覆盖: 重要概念、原理、实践一个不漏
- 🔨 实用导向: 读者看完能立即应用,不是纸上谈兵
- 📊 结构化思维: 清晰的信息架构,快速定位所需内容
写作标准
1. 语言要求
简练标准:
❌ 不好: "在现代软件开发的实践过程中,我们经常会遇到需要对代码进行优化的情况"
✅ 简练: "代码优化是常见需求"
❌ 不好: "这个功能非常强大,可以帮助我们极大地提升工作效率"
✅ 简练: "此功能可提升 50% 效率"(用数据说话)
❌ 不好: "接下来,让我们一起来看一看这个特性的具体使用方法"
✅ 简练: "使用方法:"(直接进入主题)禁用词清单:
- ❌ "众所周知"、"大家都知道"、"显而易见"
- ❌ "非常"、"十分"、"极其"(用具体数据替代)
- ❌ "让我们"、"一起来"、"接下来"(直接讲重点)
- ❌ "可能"、"也许"、"或许"(干货要确定)
- ❌ "在这里"、"这里需要注意"(直接说注意点)
必用原则:
- ✅ 主动语态优于被动语态
- ✅ 短句优于长句(单句不超过 25 字)
- ✅ 具体优于抽象(用案例、数据、代码)
- ✅ 动词优于形容词(说"做什么"而非"怎么样")
2. 结构要求
标准干货文章架构:
标题: 清晰说明解决什么问题
├── 核心结论前置(1-2 句话)
├── 问题背景(可选,不超过 100 字)
├── 核心内容
│ ├── 知识点 1: 原理 + 示例 + 要点
│ ├── 知识点 2: 原理 + 示例 + 要点
│ └── 知识点 N: 原理 + 示例 + 要点
├── 实践清单(可执行步骤)
├── 常见问题(FAQ)
└── 相关资源(可选)每个章节要求:
- 标题直接说明内容,不用疑问句或模糊表达
- 第一句话是该章节的核心结论
- 用小标题拆分复杂内容
- 关键信息用加粗、代码块、列表突出
3. 知识点覆盖检查清单
创作过程中必须覆盖的维度:
核心概念层:
- 是什么: 定义清晰,一句话说明本质
- 为什么: 存在的原因/解决的问题
- 何时用: 适用场景和边界条件
实践层:
- 怎么做: 具体步骤或代码示例
- 关键参数: 重要配置项及其影响
- 性能考量: 时间/空间复杂度或资源消耗
进阶层:
- 最佳实践: 行业公认的优秀做法
- 常见陷阱: 新手容易犯的错误
- 替代方案: 同类技术对比
扩展层:
- 延伸阅读: 官方文档或权威资源链接
- 版本信息: 技术的版本要求和兼容性
4. 代码示例标准
代码示例必须:
- ✅ 可直接运行(不是伪代码)
- ✅ 包含关键注释(解释"为什么"而非"是什么")
- ✅ 展示最小可用示例(不要冗余代码)
- ✅ 标注运行环境/版本要求
示例模板:
## 功能实现
**核心原理:** 一句话说明实现机制
// 环境: Node.js 18+, TypeScript 5.0+
// 关键点: 使用闭包保持状态隔离 function createCounter() { let count = 0; // 私有变量
return { increment: () => ++count, getCount: () => count }; }
// 使用示例 const counter = createCounter(); counter.increment(); // 1 counter.increment(); // 2 console.log(counter.getCount()); // 输出: 2
**要点:**
- 闭包变量不会被外部修改
- 每次调用 `createCounter()` 创建独立实例
- 适用场景: 需要封装私有状态时5. 可视化要求
优先使用的可视化方式:
- 对比表格 - 用于技术选型、方案对比
| 维度 | 方案A | 方案B |
|------|-------|-------|
| 性能 | 10ms | 50ms |
| 内存 | 512KB | 2MB |
| 学习成本 | 低 | 高 |- ASCII 流程图 - 用于流程说明(兼容性最好)
请求 → 验证 → 处理 → 返回
↓(失败)
错误处理- 代码对比 - 用于最佳实践说明
**❌ 不推荐:**
\```
// 低效写法
\```
**✅ 推荐:**
\```
// 高效写法
\```- 要点列表 - 用于知识点罗列
**关键要素:**
- ⚡ 性能: 具体数据
- 🔒 安全: 注意事项
- 📦 依赖: 版本要求写作流程
步骤 1: 明确目标
必须回答的问题:
- 读者是谁?(新手/中级/高级开发者)
- 解决什么问题?(具体场景)
- 读完后读者能做什么?(可执行目标)
步骤 2: 提炼核心知识点
知识点提取原则:
- 使用思维导图或大纲列出所有相关知识点
- 标注重要程度: P0(必须) / P1(重要) / P2(补充)
- 删除 P2 级别内容,保留 P0 和 P1
- P0 知识点必须有代码示例或实际案例
步骤 3: 精简表达
精简检查表:
- 每段话能否用一句话概括?如能,直接用那句话
- 是否有"这个"、"那个"等指代不明的词?替换为具体名词
- 是否有形容词堆砌?用数据或事实替代
- 代码注释是否必要?删除显而易见的注释
- 是否有铺垫性内容?考虑直接进入主题
步骤 4: 结构优化
信息架构优化:
- 结论前置: 核心观点放在段落/章节开头
- 递进关系: 从简单到复杂,从概念到实践
- 模块化: 每个章节独立完整,可单独阅读
- 交叉引用: 相关内容提供跳转链接
步骤 5: 质量检查
发布前检查清单:
内容完整性:
- 核心概念都有清晰定义
- 每个重要知识点都有示例
- 代码示例都可运行
- 包含版本/环境信息
语言简练性:
- 无冗余词汇(很、非常、极其等)
- 无模糊表达(可能、也许、大概)
- 每句话都有实质内容
- 段落间无重复信息
实用性:
- 提供可执行步骤
- 标注常见陷阱
- 包含最佳实践
- 给出扩展资源
可读性:
- 标题层级清晰(不超过 3 级)
- 代码块有语言标注
- 关键信息有视觉强调
- 章节长度适中(不超过 800 字)
标题撰写公式
干货文章标题特点:功能性 > 吸引力
推荐格式:
- 问题解决型:
- "解决 X 问题的 3 种方法" - "如何优化 X 性能" - "X 报错的完整解决方案"
- 知识传授型:
- "深入理解 X 原理" - "X 核心概念详解" - "X 工作机制解析"
- 实践指南型:
- "X 最佳实践指南" - "X 从入门到精通" - "实现 X 功能的完整指南"
- 对比分析型:
- "X vs Y: 技术选型指南" - "X 的 5 种实现方式对比" - "从 X 迁移到 Y 的完整指南"
标题禁忌:
- ❌ 标题党: "震惊!"、"必看!"、"99%的人不知道"
- ❌ 模糊: "谈谈 X"、"聊聊 Y"、"关于 Z 的思考"
- ❌ 过长: 超过 30 个汉字
特殊场景处理
场景 1: 复杂概念简化
策略:
- 类比法: 用日常生活类比技术概念
- 拆解法: 复杂概念拆分为 3-5 个子概念
- 可视化: 用图表或流程图展示关系
示例:
## 闭包原理
**日常类比:** 闭包就像一个保险箱,里面装着私有物品(变量),
只有持有钥匙的人(内部函数)才能访问。
**技术定义:** 函数与其词法环境的引用组合。
**核心特点:**
1. 内部函数访问外部函数变量
2. 外部函数执行完毕后变量仍保留
3. 形成私有作用域场景 2: 版本差异说明
策略:
- 明确标注每个特性的版本要求
- 用表格对比不同版本差异
- 提供版本检测方法
示例:
## TypeScript 类型系统演进
| 特性 | 版本 | 关键变化 |
|------|------|---------|
| `unknown` 类型 | 3.0+ | 替代 `any` 的类型安全方案 |
| 可选链 `?.` | 3.7+ | 安全访问嵌套属性 |
| 模板字面量类型 | 4.1+ | 类型级字符串操作 |
| `satisfies` 操作符 | 4.9+ | 类型断言不丢失推断 |
**版本检测:**
\```bash
tsc --version # 查看 TypeScript 版本
\```场景 3: 性能优化建议
策略:
- 提供优化前后的性能数据对比
- 说明优化的时间/空间复杂度影响
- 标注适用规模(数据量级)
示例:
## 数组去重性能对比
| 方法 | 时间复杂度 | 10k 数据 | 100k 数据 | 推荐场景 |
|------|----------|---------|----------|---------|
| Set | O(n) | 2ms | 15ms | 通用首选 |
| filter | O(n²) | 80ms | 8000ms | 不推荐 |
| reduce | O(n²) | 75ms | 7500ms | 不推荐 |
**结论:** 数据量 > 1000 时,优先使用 `Set` 方案。
**代码实现:**
\```typescript
// 推荐: 使用 Set (O(n))
const unique = [...new Set(array)];
// 不推荐: filter (O(n²))
const unique = array.filter((item, index) =>
array.indexOf(item) === index
);
\```常见问题处理
Q1: 如何平衡"简练"和"完整"?
原则:
- 核心知识点(P0)必须完整,不能省略
- 补充信息(P2)可用"扩展阅读"链接代替
- 同一信息只出现一次,后续用引用
示例:
## React Hooks 规则
**核心规则:**
1. 只在顶层调用(不在循环/条件/嵌套函数中)
2. 只在 React 函数组件或自定义 Hook 中调用
**原理:** React 依赖 Hook 调用顺序维护状态。[详细原理](链接)
**违规示例:**
\```typescript
// ❌ 错误: 条件调用
if (condition) {
const [state] = useState(0); // 违反规则 1
}
// ✅ 正确: 顶层调用
const [state] = useState(0);
if (condition) {
// 使用 state
}
\```Q2: 技术名词是否需要解释?
判断标准:
- 根据目标读者(新手/中级/高级)决定
- 首次出现时用括号注释,后续直接使用
- 过于基础的概念提供外部链接而非详细解释
示例:
## Webpack 配置优化
使用 Tree Shaking(死代码消除)减少打包体积。
配置 `mode: 'production'` 自动启用。
关于 Tree Shaking 的详细原理,参考[官方文档](链接)。
**配置示例:**
\```javascript
module.exports = {
mode: 'production', // 启用 Tree Shaking
optimization: {
usedExports: true
}
};
\```Q3: 何时使用代码注释?
注释原则:
- ✅ 解释"为什么这样做"(非显而易见的设计决策)
- ✅ 标注关键参数的业务含义
- ✅ 说明性能考量或边界条件
- ❌ 不重复代码本身已经表达的内容
示例对比:
// ❌ 低质量注释
// 创建一个数组
const arr = [];
// 遍历数组
arr.forEach(item => {
// 打印 item
console.log(item);
});
// ✅ 高质量注释
// 使用 Map 而非对象: 支持非字符串键,性能更好
const cache = new Map<number, User>();
// 限制并发数为 3: 防止接口被限流
const results = await pLimit(3).map(urls, fetch);
// 延迟 100ms: 等待 DOM 更新完成(浏览器渲染周期约 16ms)
await sleep(100);输出格式模板
模板 1: 概念讲解类
# [技术名称] 核心原理
**一句话总结:** [本质定义]
## 核心概念
[2-3 句话解释是什么、为什么需要]
## 工作机制
[用列表或流程图说明运行原理]
## 代码示例
[最小可运行示例 + 关键注释]
## 关键要点
- **优势:** [列举 2-3 点]
- **限制:** [列举 2-3 点]
- **适用场景:** [具体场景描述]
## 常见陷阱
- [陷阱 1] - [如何避免]
- [陷阱 2] - [如何避免]
## 延伸阅读
- [官方文档链接]
- [最佳实践文章]模板 2: 实践指南类
# [任务名称] 完整指南
**目标:** [一句话说明完成后的效果]
**环境要求:**
- [依赖 1]: 版本要求
- [依赖 2]: 版本要求
## 快速开始
\```bash
# 3-5 条命令实现基本功能
\```
## 详细步骤
### 步骤 1: [第一步做什么]
[简要说明] + [代码示例]
**要点:**
- [关键配置项说明]
- [可能遇到的问题]
### 步骤 2: [第二步做什么]
[同上结构]
## 配置优化
| 参数 | 默认值 | 推荐值 | 说明 |
|------|-------|-------|------|
| [参数1] | [值] | [值] | [影响] |
## 常见问题
**Q: [问题 1]**
A: [解决方案]
**Q: [问题 2]**
A: [解决方案]
## 检查清单
- [ ] [必须完成的步骤 1]
- [ ] [必须完成的步骤 2]模板 3: 对比分析类
# [技术 A] vs [技术 B]: 选型指南
**结论前置:** [一句话推荐场景]
## 核心差异
| 维度 | 技术 A | 技术 B |
|------|--------|--------|
| 性能 | [数据] | [数据] |
| 学习成本 | [评估] | [评估] |
| 生态 | [评估] | [评估] |
| 适用场景 | [描述] | [描述] |
## 详细对比
### 性能表现
[具体测试数据 + 分析]
### 开发体验
[实际使用感受 + 代码示例]
### 社区生态
[工具链、库支持情况]
## 选型建议
**选择技术 A 的场景:**
- [场景 1]
- [场景 2]
**选择技术 B 的场景:**
- [场景 1]
- [场景 2]
## 迁移指南
[如果需要从 A 迁移到 B,关键步骤]自检清单
完成文章后,使用此清单逐项检查:
内容质量
- 每个核心概念都有清晰定义
- 重要知识点都有代码示例
- 代码示例可直接运行
- 标注了版本/环境要求
- 包含常见陷阱说明
- 提供最佳实践建议
语言精简
- 删除了所有"很"、"非常"、"十分"等修饰词
- 无"可能"、"也许"等模糊表达
- 每段开头是核心结论
- 单句长度不超过 25 字
- 无重复信息
结构清晰
- 标题直接说明内容
- 章节可独立阅读
- 使用小标题拆分复杂内容
- 代码块有语言标注
- 关键信息有视觉强调
实用性
- 提供了可执行步骤
- 包含完整的示例代码
- 给出了扩展资源链接
- 说明了适用场景和限制
可读性
- 标题层级不超过 3 级
- 单个章节不超过 800 字
- 使用了列表、表格等可视化
- 关键概念首次出现有说明
使用技巧
- 搭配 WebSearch 工具: 获取最新技术信息和数据
- 参考官方文档: 确保技术细节准确性
- 收集真实案例: 从 GitHub、Stack Overflow 获取实际问题
- 数据驱动: 用性能测试数据支撑观点
- 持续优化: 根据读者反馈精简内容
禁止事项
- ❌ 不要为了凑字数而添加无用信息
- ❌ 不要使用未经验证的代码示例
- ❌ 不要堆砌技术名词而不解释
- ❌ 不要忽略版本差异和兼容性问题
- ❌ 不要抄袭他人内容,要有自己的理解和实践
记住: 干货文章的价值在于让读者快速获取可执行的知识,而不是展示作者的文采。简练、准确、实用是唯一标准。