CLAUDE.md

这是 Dorian（Dorian Alden Dai）的个人博客文档仓库。所有内容均为中文撰写。

仓库分支架构

notes 分支（当前）：纯粹的 Markdown 博客文档。所有内容以 .md 文件组织，通过目录层级实现标签化分类。
main 分支：博客网站的源代码，负责将 notes 分支的 .md 文档转换为 HTML 页面发布到博客网站。

当前工作在 notes 分支，只涉及 Markdown 文档的编写、整理和分类。

当前仓库结构

Dorian-Blog/
├── .claude/          ← Claude Code 配置与 Skills
│   └── skills/
│       ├── git-commit/                    ← Git 提交规范
│       ├── DailyEnglishDictation英语积累   ← 英语听写积累卡片生成
│       └── 格式规范定义                     ← 数据结构格式规范符号系统
├── .docs/            ← 文档规范（分类、命名、撰写标准）
│   ├── 01-目录标签化管理规范.md
│   ├── 02-文档命名规范.md
│   ├── 03-文档撰写规范.md
│   └── 04-顶层目录标签定义.md
├── .gitignore
├── README.md
├── CLAUDE.md         ← 本文件
└── .old/              ← 待整理的旧文档（正在逐步迁移到正式标签目录）
    ├── 卡片/
    ├── 学习/          ← 已合并原 计算机/ 内容
    ├── JavaWeb学习/
    ├── Competitions/
    ├── ... (其余旧目录)

目录标签化分类体系

文档分类采用目录层级即标签树的方式：目录路径本身构成标签体系，从顶层大领域逐层细化到底层具体主题。详细规范见 .docs/01-目录标签化管理规范.md。

顶层标签概览

顶层标签	领域	说明
`卡片/`	原子知识卡片	编号前缀 `01-` 到 `31-`，每张卡片记录一个独立技术问题或踩坑经验
`学习/`	系统性学习笔记	AI学习、Java学习、JsRE、小林coding面试题、工具使用、提示词、计算机四大件
`JavaWeb学习/`	Java Web 专项	Tomcat、Servlet、Maven、MyBatis、SpringSecurity、Spring
`Competitions/`	学术竞赛	Algorithm 算法竞赛、MCM 数学建模、UIEP
`作业/`	大学课程作业	C++实验、Web实验报告、软工导论、职业生涯规划等
`项目/`	项目相关	Harness、Skill、TODO可视化时间表、英语学习app
`我的项目/`	个人实际项目	Tetris、樟木林（已构建的项目）
`感想/`	个人感想	自由思考与观点文章
`成长记录/`	个人成长记录	事件驱动的学习日志
`实习准备/`	实习求职准备	LeetCode Hot 100、开发规范、面试题
`实习计划/`	实习规划	学习计划、能力要求、问题整理
`招聘记录/`	招聘会记录	公司调研、面试经历、学生感言
`AI资料/`	AI 参考资料	前端设计偏好、提示词优化
`AI踩坑/`	AI 踩坑记录	AI 工具使用中的问题
`非计算机/`	非技术内容	Daily English Dictation 每日英语听写、日常学习卡片

注：部分顶层标签待合并精简，详见 .docs/04-顶层目录标签定义.md 中的合并建议。

内容写作风格

详细规范见 .docs/03-文档撰写规范.md。要点：

语言：全部中文撰写，代码片段和技术术语保留英文。
标题层级：文档标题用 ##，内容标题从 ### 开始。标题上下文用空行隔开。
卡片格式（卡片/ 目录）：编号前缀 NN-title.md，简短标题。每张卡片记录一个具体技术问题和解决方案，篇幅短小精悍。新卡片推荐使用 YAML frontmatter（create-time、update-time）。
Daily English Dictation（非计算机/Daily English Dictation/）：按 10 篇一组分目录（001-010、011-020 等），命名统一为 NNN-level.md。使用固定模板（template.md），包含 Listening Practice 和 Accumulation 两大板块。
日常学习卡片（非计算机/日常学习卡片/）：按月份和星期组织（26-03/week1/day1.md）。
笔记文档：自由格式 Markdown，无强制模板。通常包含问题背景、解决方案、代码片段、反思总结。

文档命名规范

详细规范见 .docs/02-文档命名规范.md。要点：

卡片/：NN-title.md（递增两位数字 + 描述性标题），禁止日期命名
Daily English Dictation：NNN-level.md（三位数字 + 统一难度后缀：beginner/intermedia/advanced/expert）
通用禁止：纯数字文件名（1.md）、artifact（——、-hard-hard）、拼写错误（advance）
招聘记录/：YYYY-MM-DD-事件名.md 或 类型-描述.md

Git 提交规范

详见 .claude/skills/git-commit/SKILL.md。格式：type(scope): 中文简述

type	场景
`docs`	新增/修改文档内容
`file`	文件移动、重命名
`ref`	目录结构重组

scope 取文件路径的顶层目录名，subject 只描述操作过程不描述影响，20 字以内。

Claude Code 配置

仓库在 .claude/skills/ 下有 3 个自定义 Skill：

git-commit：自动分析工作区变更，按目录分组，生成规范的中文提交信息并分批提交。
DailyEnglishDictation英语积累：从英语听写句子中自动提取词汇、短语、语法结构、发音现象，生成结构化积累卡片。
格式规范定义：定义数据结构格式规范的符号系统（可选字段 [ ]、重复 */+、枚举 {}、条件依赖等）。

文档规范存放于 .docs/，包含 4 个独立规范文件，Claude Code 可按需加载。

文档整理进度

✅ 计算机/ 已合并到 学习/：消除了 23 个重复 .md 文件及图片资源。
✅ 所有旧文档已移入 .old/：根目录保持干净，后续逐步从 .old/ 迁移到正式标签目录。
✅ 文档规范已建立：.docs/ 下的 4 个规范文件定义了完整的分类、命名、撰写标准。
🔜 待整理：从 .old/ 逐个目录往外迁移文档、统一命名、修复命名 artifact、合并重叠标签。

工作约定

在 notes 分支上工作，不涉及网站构建相关操作。
新增文档时沿标签树定位，放入对应的标签目录。避免在根目录创建新 .md 文件。
卡片/ 中新卡片使用递增数字编号作为前缀（NN-title.md）。
Daily English Dictation 新练习放入对应的 10 篇一组子目录，统一使用 NNN-level.md 命名。
文档整理时只调整结构（目录、文件名），不修改文档内容。
顶层目录稳定性：顶层目录是用户认可的分类体系，不随意新增、删除或重命名。调整顶层目录必须经用户明确同意。
移动与重命名是高风险操作：移动文件和重命名会导致用户对文档位置不熟悉。每次操作前必须展示完整的变更计划并获得用户同意，不得擅自执行。
禁止批量操作：不得一次性执行大量移动或重命名。每次只处理一个目录，变更范围应小而清晰，便于用户逐一确认。
文档操作分离原则：移动文件、重命名文件、修改文档内容三类操作不得混在同一步骤中进行。每次只执行一种操作类型，避免冲突和混乱。例如：先完成所有文件移动（归类），用户确认后再进行重命名，最后才修改内容。
文档迁移安全机制：从 .old/ 迁移或调整文档时，先用 git mv 或在确认前保留原始文件，不得提前删除旧文档。调整完毕后必须经用户明确同意，才能执行删除旧文件或旧目录的操作。在用户明确确认之前，任务视为未完成，不得执行 commit。
每完成一个目录的整理且用户确认后，才 commit，遵守 git-commit 规范。
编辑已有文档时保留其原有格式风格。
.gitignore 中排除了 TODO.md 和 我的灵感.md。

CLAUDE.md ​

仓库分支架构 ​

当前仓库结构 ​

目录标签化分类体系 ​

顶层标签概览 ​

内容写作风格 ​

文档命名规范 ​

Git 提交规范 ​

Claude Code 配置 ​

文档整理进度 ​

工作约定 ​