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 工程实践还不熟悉。写作时：
- 问题优先：先说“为什么要关心这个问题”，再讲概念和方案。不要一上来就定义。
- 工程视角：解释概念时，要说清楚它在系统里扮演什么角色，而不是给出教科书定义。
- 避免框架崇拜：不要把某个框架讲成“最佳答案”，要讲清楚它解决什么问题、有什么代价。
- 暴露真实复杂度：要主动提到“这里容易踩坑”、“Demo 能跑但生产不行”。
- 精炼、不废话：不加不必要的修饰语，每个段落有实际内容。
- 使用代码块和图表：需要展示执行流程时优先用
```text代码块而不是大段描述。需要正式图表时默认使用```mermaid，包括多阶段管线、对比关系、架构分层和复杂流程，并按mermaid-check验证兼容性。仅当 Mermaid 无法可靠表达所需布局，或用户明确要求可编辑 Draw.io 画布时，才使用drawio-skill生成.drawio源文件和渲染资产。 - 文末导航：在最后用
下一篇建议继续看：+ 链接收尾（或说明尚无后续）。
文章结构模板
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}：{面试题}
**新手答**："{浅层回答}"
**高手答**：
{深度回答}
**考察点**：{一句话说明面试官在考什么}文末附面试整体分析（考察逻辑、技术栈覆盖范围）。
执行步骤
收集信息：如果用户没有提供以下信息，先确认：
- 目标模块（哪个目录）
- 文章编号（
NN） - 文章主题和标题
- 是否需要参考已有文章风格（默认：是）
创建目录和文件：
bashmkdir -p {module-dir}/{NN}-{slug}/然后写入
index.md。更新模块 index.md：在对应模块的
index.md中，把新文章加入“建议阅读顺序”和文章列表表格。输出确认：告知用户创建了哪个文件，以及文章在模块中的位置。