---
name: new-article
description: 在 zero2Agent 项目中创建新的学习文章。当用户说"写一篇新文章"、"创建文章"、"新建文章"、"在某模块下添加一篇关于X的文章"、"帮我起草一篇讲XX的内容"、"整理面经"时触发。适用于所有模块下新建内容，包括面试维度拆解文章和面经实录。即使用户没有明确说"文章"，只要涉及给 zero2Agent 项目增加教学内容，也应当触发此技能。
---

# new-article：创建新文章

本技能用于在 zero2Agent 项目中创建符合项目风格的新学习文章。

## 项目约定

**目录结构**
```
{module-dir}/
└── {NN}-{slug}/
    └── index.md
```
- `{NN}` 是两位数编号，如 `01`、`09`、`10`
- `{slug}` 是英文小写、用连字符连接，如 `tool-calling-basics`
- 每篇文章独占一个子目录，主文件统一命名为 `index.md`

**已有模块目录**
| 模块 | 目录 | 已有文章数 |
|------|------|-----------|
| Agent Basic | `learn-agent-basic/` | 08 篇 (01–08) |
| Agent Survey | `learn-agent-survey/` | 13 篇 (01–13) |
| Agent Training | `learn-agent-training/` | 06 篇 (01–06) |
| Agent Interview | `learn-agent-interview/` | 08 篇 (01–08)，含面经实录 |
| LangGraph | `learn-langgraph/` | 07 篇 (01–07) |
| Claude Code | `learn-claude-code/` | 12 篇 (01–12) |
| SDK Frameworks | `learn-sdk-frameworks/` | 04 篇 (01–04) |
| OpenClaw | `learn-openclaw/` | 09 篇 (01–09) |
| Final Project | `final-project/` | 0 篇 (占位符) |

**Frontmatter 格式**
```yaml
---
layout: default
title: {文章标题（中文）}
description: {一句话描述，10–25 字}
eyebrow: {Module Name} / {NN}
---
```
eyebrow 示例：`Agent Basic / 09`、`LangGraph / 01`

## 文章写作风格（必须遵守）

zero2Agent 的读者是懂代码、懂深度学习基础的开发者，但对 Agent 工程实践还不熟悉。写作时：

1. **问题优先**：先说“为什么要关心这个问题”，再讲概念和方案。不要一上来就定义。
2. **工程视角**：解释概念时，要说清楚它在系统里扮演什么角色，而不是给出教科书定义。
3. **避免框架崇拜**：不要把某个框架讲成“最佳答案”，要讲清楚它解决什么问题、有什么代价。
4. **暴露真实复杂度**：要主动提到“这里容易踩坑”、“Demo 能跑但生产不行”。
5. **精炼、不废话**：不加不必要的修饰语，每个段落有实际内容。
6. **使用代码块和图表**：需要展示执行流程时优先用 ` ```text ` 代码块而不是大段描述。需要正式图表时默认使用 ` ```mermaid `，包括多阶段管线、对比关系、架构分层和复杂流程，并按 `mermaid-check` 验证兼容性。仅当 Mermaid 无法可靠表达所需布局，或用户明确要求可编辑 Draw.io 画布时，才使用 `drawio-skill` 生成 `.drawio` 源文件和渲染资产。
7. **文末导航**：在最后用 `下一篇建议继续看：` + 链接收尾（或说明尚无后续）。

## 文章结构模板

```markdown
---
layout: default
title: {标题}
description: {一句话描述}
eyebrow: {Module} / {NN}
---

# {标题}

{开篇：1–3 句话，说明这个话题在实际工程中为什么重要 / 常见误解是什么}

## {核心概念或问题拆解}

{正文……}

## {深入一层：机制 / 设计原则 / 常见坑}

{正文……}

## {实践建议 或 典型误区}

{正文……}

## 小结

{用 3–5 个 bullet 提炼核心观点，不重复正文措辞}

下一篇建议继续看：

- [{下一篇标题}]({相对路径}/index.html)
```

## 面试模块特殊格式（learn-agent-interview）

该模块有两类文章，格式不同：

### 维度拆解文章（01–07）
按考察维度分类，每道题用“新手答 vs 高手答”对比格式：
```markdown
## Q：{面试题}

> 来源：{公司/岗位}

**新手答**："{浅层回答}"

**高手答**：

{深度回答，分层递进，带具体方案}

**差距在哪**：{分析新手和高手答案的差距，点出面试官真正在考什么}
```

### 面经实录文章（08+）
完整还原一场真实面试，保留题目顺序。每道题格式：
```markdown
## Q{N}：{面试题}

**新手答**："{浅层回答}"

**高手答**：

{深度回答}

**考察点**：{一句话说明面试官在考什么}
```
文末附面试整体分析（考察逻辑、技术栈覆盖范围）。

## 执行步骤

1. **收集信息**：如果用户没有提供以下信息，先确认：
   - 目标模块（哪个目录）
   - 文章编号（`NN`）
   - 文章主题和标题
   - 是否需要参考已有文章风格（默认：是）

2. **创建目录和文件**：
   ```bash
   mkdir -p {module-dir}/{NN}-{slug}/
   ```
   然后写入 `index.md`。

3. **更新模块 index.md**：在对应模块的 `index.md` 中，把新文章加入“建议阅读顺序”和文章列表表格。

4. **输出确认**：告知用户创建了哪个文件，以及文章在模块中的位置。