Qiniu/CLAUDE.md

Claude Code 配置 — 七牛云暑期实习笔记库

此知识库级别的配置为 Claude 操作提供指导说明。 在行动前，先列计划（工具调用）。

知识库上下文

• 用途：记录七牛云暑期实习期间的内容
• 主要分类：技术学习 / 项目实战 / 周报日报
• 标签风格：英文为主（如 #go、#redis、#k8s）

文件创建规范

Frontmatter 模板

---
tags: []
create time: YYYY-MM-DD HH:mm
---

字段	格式	说明
tags	数组	必须存在 []，智能填充相关英文标签
create time	YYYY-MM-DD HH:mm	当前系统时间

文档结构

1. ## 概述 — 简短描述文档内容，不留占位文本
2. ## 正文 — 主要内容，详略得当，注重拓展进阶
3. ## 关联笔记 — Wiki-links 形式的 .md 文件链接；若无此项可移除

子文档规则

创建子文档时，先在同级目录下建立同名文件夹，将文件放入其中，再在父文档适当位置插入链接。示例：

• notes/redis.md → notes/redis/redis-internals.md
• 并在父文档中添加 - [[redis/redis-internals]]

文件夹命名约定

目录	用途	示例
technical/	技术知识点	Go、Redis、K8s 等
projects/	开发项目记录	具体参与的模块或系统
weekly/	周/日报	按周归档的工作总结

• 文件名统一使用 kebab-case（小写 + 短横线），如 redis-hash-internals.md
• 日期类文件在文件名中包含日期，如 2026-w25-weekly-report.md

分类专属规范

以下规范以通用规范为基础，各目录追加其特有的格式和内容要求。

technical/ — 技术学习笔记

侧重知识传递与理解深化。

结构模板

---
tags: [技术标签]
create time: YYYY-MM-DD HH:mm
---

# <知识点名称>

## 概述
[一句话说明这个知识点是什么，解决什么问题]

## 核心概念
[原理、机制、关键设计决策。使用 `> [!info]` / `> [!tip]` / `> [!warning]` 等提示块突出重点]

## 代码示例
[Go / React/TS 优先，点到为止。注释精简，仅体现核心逻辑]

## 常见陷阱与最佳实践
[踩过的坑、容易误解的地方、团队约定]

## 延伸阅读
- 推荐阅读链接或相关笔记

写作要求

• 穿插 启发式问题（如「为什么 Redis 选择跳表而非平衡树？」）引导思考
• 关键流程必须用 Mermaid 图表说明，避免纯文字 ASCII 图
• 每个代码示例后必须有 1-2 句文字解释
• 如果涉及对比（A vs B），用表格呈现更清晰

---

projects/ — 项目实战记录

侧重技术方案与实施过程的完整记录。

结构模板

---
tags: [项目标签]
create time: YYYY-MM-DD HH:mm
status: active | completed | on-hold  # 可选状态字段
---

# <项目/模块名称>

## 背景
[为什么要做？业务需求和技术动机]

## 技术方案
- 选型及理由
- 架构概览（可附 Mermaid 架构图）
- 接口设计要点

## 实现细节
- 关键代码片段（附解释）
- 遇到的问题及解决过程
- 性能优化或权衡取舍

## 结果与验证
- 上线效果 / 测试覆盖 / 监控指标
- 后续 TODO 或改进方向

## 关联笔记
- [[相关笔记]]

写作要求

• 保持 客观记录风格，少抒情多事实
• 每次迭代或里程碑更新时补充进度，而非重写全文
• API 变更、数据库 schema 调整等应附带具体 diff 或结构说明

---

weekly/ — 周报/日报

侧重结构化总结与快速回顾。

结构模板

---
tags: [weekly]
create time: YYYY-MM-DD HH:mm
week: W25  # 第几周
---

# 2026-W25 Weekly Report

## 本周完成
- [ ] 任务描述 + 简要成果
- [ ] 任务描述 + 简要成果

## 问题 / 阻塞
- 描述当前卡点及影响范围
- 已尝试的解决方案

## 收获 / 反思
- 学到的新知识点
- 做得好的 / 可以改进的地方
- 待办事项 & 下周计划

写作要求

• 简洁条目式，不展开长段落
• 每条完成后打 [x]，未完成保留 [ ]
• 「问题 / 阻塞」板块用于向上同步风险，务必诚实标注
• 日期按周归档，文件名格式：2026-w25-weekly-report.md

---

内容风格

以下为贯穿所有分类的基础原则：

• 文风：严谨但不失"活人感"，循序渐进，深入浅出。
• 最小读取：只读取完成任务所必需的文件，减少 Token 消耗。
• 不确定时先问：对文件归属分类存疑时，使用 AskUserQuestion 询问用户，而非自行猜测。
• 不碰 .obsidian/：内部插件配置和缓存文件不在操作范围内。