Skip to content

Commit ec6c11f

Browse files
committed
fix(book): SUMMARY syntax for mdbook strict parser
mdbook rejects plain text as section dividers and forbids duplicate file paths. Flatten the grouping headers and add an appendix stub that points back to v1 cheatsheet.
1 parent 0f14d75 commit ec6c11f

2 files changed

Lines changed: 34 additions & 23 deletions

File tree

book/src/SUMMARY.md

Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,10 @@
1111
- [提示词工程](./methods/prompting.md)
1212
- [需求拆解](./methods/task-decomposition.md)
1313
- [上下文管理](./methods/context-management.md)
14-
- 工具速通
15-
- [Cursor — IDE 起步](./tools/cursor/README.md)
16-
- [GitHub Copilot — 行内补全 + Agent](./tools/copilot/README.md)
17-
- [Claude Code — CLI Agent 之王](./tools/claude-code/README.md)
18-
- [OpenAI Codex CLI — 内核沙箱 + ChatGPT 订阅可用](./tools/codex/README.md)
14+
- [Cursor — IDE 起步](./tools/cursor/README.md)
15+
- [GitHub Copilot — 行内补全 + Agent](./tools/copilot/README.md)
16+
- [Claude Code — CLI Agent 之王](./tools/claude-code/README.md)
17+
- [OpenAI Codex CLI — 内核沙箱 + ChatGPT 订阅可用](./tools/codex/README.md)
1918

2019
---
2120

@@ -25,23 +24,20 @@
2524
- [代码审查](./methods/code-review.md)
2625
- [调试方法论](./methods/debugging.md)
2726
- [测试策略](./methods/testing.md)
28-
- 多工具协作
29-
- [选型指南](./workflows-src/tool-selection.md)
30-
- [实战场景脚本](./workflows-src/scenarios.md)
31-
- [Claude Code + Cursor 协作](./workflows-src/claude-code-cursor.md)
32-
- [Claude Code + Copilot 协作](./workflows-src/claude-code-copilot.md)
33-
- 踩坑合集
34-
- [陷阱总览](./pitfalls-src/README.md)
35-
- [Claude Code 陷阱](./pitfalls-src/claude-code.md)
36-
- [Cursor 陷阱](./pitfalls-src/cursor.md)
37-
- [Copilot 陷阱](./pitfalls-src/copilot.md)
38-
- [Aider 陷阱](./pitfalls-src/aider.md)
39-
- 进阶工具
40-
- [Aider — Git 原生多模型](./tools/aider/README.md)
41-
- [Gemini CLI — 2M 上下文](./tools/gemini-cli/README.md)
42-
- [Windsurf — Cascade 自动上下文](./tools/windsurf/README.md)
43-
- [Trae — 字节出品免费版](./tools/trae/README.md)
44-
- [Kiro — Spec 驱动开发](./tools/kiro/README.md)
27+
- [多工具选型指南](./workflows-src/tool-selection.md)
28+
- [实战场景脚本](./workflows-src/scenarios.md)
29+
- [Claude Code + Cursor 协作](./workflows-src/claude-code-cursor.md)
30+
- [Claude Code + Copilot 协作](./workflows-src/claude-code-copilot.md)
31+
- [陷阱总览](./pitfalls-src/README.md)
32+
- [Claude Code 陷阱](./pitfalls-src/claude-code.md)
33+
- [Cursor 陷阱](./pitfalls-src/cursor.md)
34+
- [Copilot 陷阱](./pitfalls-src/copilot.md)
35+
- [Aider 陷阱](./pitfalls-src/aider.md)
36+
- [Aider — Git 原生多模型](./tools/aider/README.md)
37+
- [Gemini CLI — 2M 上下文](./tools/gemini-cli/README.md)
38+
- [Windsurf — Cascade 自动上下文](./tools/windsurf/README.md)
39+
- [Trae — 字节出品免费版](./tools/trae/README.md)
40+
- [Kiro — Spec 驱动开发](./tools/kiro/README.md)
4541

4642
---
4743

@@ -56,7 +52,7 @@
5652

5753
# 别册 · 速查手册
5854

59-
- [9 工具速查表(同卷一](./cheatsheet.md)
55+
- [9 工具速查表(跳到卷一](./appendix-cheatsheet.md)
6056
- [项目更新日志](./changelog.md)
6157

6258
---

book/src/appendix-cheatsheet.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# 别册 · 速查手册
2+
3+
完整 9 工具速查表与卷一·入门章节是同一份内容,避免重复,请直接看:
4+
5+
👉 **[卷一 · 9 工具速查表](./cheatsheet.md)**
6+
7+
---
8+
9+
## 速查手册的设计意图
10+
11+
- 案头放一份,每天翻两眼
12+
- 写代码时遇到"那个命令叫啥来着",搜这个就够
13+
- 不带方法论、不带导读——只有冷冰冰的命令和参数表
14+
15+
如果你来到这里时感觉"内容怎么没看到"——这页就是个目录跳板。完整内容在卷一速查表。

0 commit comments

Comments
 (0)