Skip to content

Commit f33806e

Browse files
committed
docs: 新增分布式与测开学习内容 — 完善知识体系入口
- 新增分布式系统入门、拜占庭将军问题和测试开发学习路线文章 - 同步 README、首页、专题 README 与 VuePress 侧边栏导航 - 扩展 AI 编程 Skills 推荐和 AI 内容规划,忽略本地素材索引 - 验证:pnpm docs:build、定向 markdownlint、git diff --check 通过
1 parent d894d4d commit f33806e

15 files changed

Lines changed: 1238 additions & 71 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,3 +25,4 @@ docs/cs-basics/network/TODO.md
2525
PERFORMANCE_NOTES.md
2626
dist.zip
2727
/TODO
28+
docs/ai/MATERIALS.md

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -359,10 +359,12 @@ JVM 这部分内容主要参考 [JVM 虚拟机规范-Java8](https://docs.oracle.
359359
## 分布式
360360

361361
- [⭐分布式高频面试题](https://interview.javaguide.cn/distributed-system/distributed-system.html)
362+
- [分布式系统入门](https://javaguide.cn/distributed-system/distributed-system-intro.html)
362363

363364
### 理论&算法&协议
364365

365366
- [CAP 理论和 BASE 理论解读](https://javaguide.cn/distributed-system/protocol/cap-and-base-theorem.html)
367+
- [拜占庭将军问题详解](https://javaguide.cn/distributed-system/protocol/byzantine-generals-problem.html)
366368
- [Paxos 算法解读](https://javaguide.cn/distributed-system/protocol/paxos-algorithm.html)
367369
- [Raft 算法解读](https://javaguide.cn/distributed-system/protocol/raft-algorithm.html)
368370
- [ZAB 协议解读](https://javaguide.cn/distributed-system/protocol/zab.html)

docs/.vuepress/sidebar/index.ts

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -427,6 +427,10 @@ export default sidebar({
427427
text: "分布式系统知识体系",
428428
link: "/distributed-system/",
429429
},
430+
{
431+
text: "分布式系统入门",
432+
link: "distributed-system-intro",
433+
},
430434
{
431435
text: "⭐分布式高频面试题",
432436
link: "distributed-system-interview-questions",
@@ -438,6 +442,7 @@ export default sidebar({
438442
collapsible: true,
439443
children: [
440444
{ text: "CAP定理与BASE理论详解", link: "cap-and-base-theorem" },
445+
{ text: "拜占庭将军问题", link: "byzantine-generals-problem" },
441446
{ text: "Paxos算法详解", link: "paxos-algorithm" },
442447
{ text: "Raft算法详解", link: "raft-algorithm" },
443448
{ text: "ZAB协议详解", link: "zab" },

docs/.vuepress/sidebar/roadmap.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,10 @@ export const roadmap = arraySidebar([
2323
text: "后端全栈学习路线(2026)",
2424
link: "full-stack-roadmap",
2525
},
26+
{
27+
text: "测试开发学习路线(2026)",
28+
link: "test-development-roadmap",
29+
},
2630
],
2731
},
2832
]);

docs/ai-coding/practices/claude-md-best-practices.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ head:
88
content: CLAUDE.md,Claude Code,AI编程,AI项目规范,Agentic Coding,AI辅助开发,CLAUDE.md最佳实践,.claude/rules
99
---
1010

11-
你好,我是小 G。前几天分享 [Claude Code 使用技巧](https://javaguide.cn/ai-coding/claudecode-tips.html) 的时候,我提到了一个很重要的文件 `CLAUDE.md`,并简单介绍了一下。
11+
你好,我是小 G。前几天分享 [Claude Code 使用技巧](https://javaguide.cn/ai-coding/practices/claudecode-tips.html) 的时候,我提到了一个很重要的文件 `CLAUDE.md`,并简单介绍了一下。
1212

1313
有 G 友在评论区留言:这个文件既然这么重要,能不能单独写一篇来讲?
1414

@@ -52,7 +52,7 @@ README 主要是写给人看的,重点是介绍项目信息;`CLAUDE.md` 则
5252
| **谁读** | Claude Code 专属 | 跨工具开放标准,OpenAI Codex、Cursor、Google Jules 等也采用 |
5353
| **定位** | Claude Code 的项目规则文件 | 跨工具通用的 Agent 指令文件 |
5454

55-
![多智能股票分析项目中的 CLAUDE.md 和 AGENTS.md](https://oss.javaguide.cn/github/javaguide/ai/coding/claude-agents-md.png)
55+
![CLAUDE.md 和 AGENTS.md](https://oss.javaguide.cn/github/javaguide/ai/coding/claude-agents-md.png)
5656

5757
简单说:通常来看 **AGENTS.md** 是跨工具标准,**CLAUDE.md** 是 Claude Code 专属入口。两者可以复用同一份基础指令。
5858

@@ -348,7 +348,7 @@ Spring Boot 4.0 + Java 21 + Spring AI 2.0 + React 面试平台。
348348

349349
## CLAUDE.md 放在哪里?
350350

351-
Claude Code 支持 `CLAUDE.md` 放在多个位置,按优先级从低到高
351+
Claude Code 支持 `CLAUDE.md` 放在多个位置。按加载顺序和影响范围,可以先这样看
352352

353353
![CLAUDE.md 层级与优先级](https://oss.javaguide.cn/github/javaguide/ai/coding/claudecode/claude-md-best-practices-file-hierarchy.png)
354354

@@ -359,11 +359,10 @@ Claude Code 支持 `CLAUDE.md` 放在多个位置,按优先级从低到高:
359359
| **项目级** | `./CLAUDE.md``./.claude/CLAUDE.md` | 团队共享规范,提交至 Git |
360360
| **本地级** | `./CLAUDE.local.md` | 个人的项目特定配置,加入 `.gitignore` |
361361
| **子目录** | `./subdir/CLAUDE.md` | Claude 访问该目录文件时按需加载,不在会话开始时注入 |
362-
| | | |
363362

364-
Claude Code 会把不同层级的 `CLAUDE.md` 一起加载,不是后面的文件把前面的直接覆盖掉。不过,越靠近当前项目、作用范围越具体的规则,会排在更后面,通常也更容易被 Claude 采纳
363+
Claude Code 会把不同层级的 `CLAUDE.md` 一起加载,不是后面的文件把前面的直接覆盖掉。不过,越靠近当前项目、作用范围越具体的规则,会排在更后面,也更贴近当前任务
365364

366-
比如用户级规则写“统一用空格缩进”,项目级规则写“这个仓库使用 Tab”,那在这个项目里,Claude 通常会优先按项目规则来。官方文档里的加载顺序也是从组织级、用户级,一直到项目级和本地级。
365+
比如用户级规则写“统一用空格缩进”,项目级规则写“这个仓库使用 Tab”,那在这个项目里,Claude 更可能按项目规则来。官方文档里的加载顺序也是从组织级、用户级,一直到项目级和本地级。真遇到互相打架的规则,最好直接删掉冲突项,不要指望 Claude 每次都选对
367366

368367
我的做法比较简单:项目级 `CLAUDE.md` 提交到 Git,放团队都要遵守的规则;只和自己有关的偏好,比如当前项目里希望提交信息用中文,就放进 `CLAUDE.local.md`,再加到 `.gitignore`,别把个人习惯混进团队文件。
369368

0 commit comments

Comments
 (0)