new-module:创建新学习模块
本技能用于在 zero2Agent 项目中新建一个学习模块,并同步更新所有相关导航。
现有模块结构(参考)
zero2Agent/
├── learn-agent-basic/ # Module 01 — 08 篇文章
├── learn-agent-survey/ # Module 02 — 13 篇文章
├── learn-agent-training/ # Module 03 — 06 篇文章
├── learn-langgraph/ # Module 04 — 07 篇文章
├── learn-claude-code/ # Module 05 — 12 篇文章
├── learn-sdk-frameworks/ # Module 06 — 04 篇文章
├── learn-openclaw/ # Module 07 — 09 篇文章
├── learn-agent-interview/ # Module 09 — 08 篇(维度拆解 + 面经实录)
└── final-project/ # Module 10 — 占位符每个模块是根目录下的一个子目录,包含 index.md 作为模块入口。
模块 index.md 结构
markdown
---
layout: default
title: {module-dir-name}
description: {模块一句话描述,15–30 字}
eyebrow: Module {NN}
---
# {module-dir-name}
{2–3 句话:这个模块解决什么问题,适合什么阶段的读者}
## 这部分的主线
{3–5 个 bullet,说明核心学习路径}
## 建议阅读顺序
{初始为空,随文章增加而补充}
## 后续可补充的文章
- [ ] {建议文章1}
- [ ] {建议文章2}
- [ ] {建议文章3}需要同步更新的位置
创建新模块时,必须更新以下 3 处:
1. _layouts/default.html — 顶部导航
在 `` 中添加链接:
html
[{显示名称}]({module-dir}/index.html)2. _layouts/default.html — 侧边栏
在 `` 中添加链接(按编号顺序):
html
[{NN}. {module-dir-name}]({module-dir}/index.html)3. index.html 主页 — 模块卡片
在主页的模块列表区域添加新卡片。参考现有卡片的 HTML 结构,保持格式一致。
执行步骤
收集信息:如果用户没有提供,先确认:
- 模块编号(
NN,当前最大为 10) - 模块目录名(如
learn-mcp) - 模块显示名(如
MCP) - 模块描述(一句话)
- 模块主线(预期涵盖哪些主题)
- 模块编号(
创建目录和文件:
bashmkdir -p {module-dir}/写入
\{module-dir\}/index.md。更新
_layouts/default.html:- 在 `` 中添加导航链接
- 在 `` 中添加侧边栏链接
更新
index.html:在主页模块卡片区域追加新模块的卡片 HTML。输出确认:列出创建/修改的所有文件,说明模块编号和导航位置。