专业知识库 · 全栈工程师

这里住的是工程师岗位相关的权威技术文档与工程方法论存量。工程师在 SOP 第 4–5 步需要参考时，优先从这里调用——不是临时 Google 搜索。

1. 为什么要有这个库

1.1 避免版本漂移

技术栈快速迭代的痛点： - Next.js 每半年一个大版本（Page Router → App Router → RSC） - Supabase 的 Auth / RLS API 频繁更新 - Claude API 每季度新功能（Tool Use → MCP → Computer Use）

如果每次都临时搜，容易拿到过时答案。专业知识库是"我们项目实际用的版本的快照"。

1.2 避免临时抄代码

工程师最容易掉进的坑： - Stack Overflow 上直接抄（可能是 5 年前的做法） - ChatGPT 给的代码（可能是幻觉）

专业知识库沉淀的是验证过的参考实现。

1.3 CKO 回写的落脚点

CKO 蒸馏时的"路径 A 岗位方法论更新"回写到这个库的 方法论/ 子目录。

2. 谁往这里写

来源	动作	落档位置
数据扒取部（被动任务）	按工程师点菜单扒官方文档 / 基准报告	`源_官方文档/` · `源_开源参考/` · `源_性能基准/`
CEO 本人（B 档来源）	有书的电子版、课程讲义时导入	`源_用户提供/`
CKO（蒸馏回写）	项目蒸馏过铁律 1 的方法论	`方法论/`
数据扒取部（主动任务）	每周订阅的技术博客、版本更新	`源_官方文档/_新鲜/` (30 天后归档)

3. 组织结构

专业知识库/
│
├── 方法论/                              · CKO 蒸馏写入的"怎么做工程"规则
│   ├── 12_Factor_App.md                · 云原生应用标准
│   ├── 架构分层原则.md                 · Client/Edge/Server/DB/AI
│   ├── 精益工程_MVP优先.md             · 精益约束 C3 落地
│   ├── 可观测性黄金三角.md             · Logs/Metrics/Traces
│   ├── OWASP_Top_10.md                 · Web 安全清单
│   ├── AI能力集成模式.md               · Claude Tool Use / MCP / 流式响应
│   ├── Prompt_Engineering实操.md       · 固化 / 版本号 / 防注入
│   ├── RAG管道最佳实践.md              · pgvector + embedding 策略
│   ├── Conventional_Commits.md
│   ├── Feature_Flag驱动发布.md
│   ├── 数据库迁移与回滚策略.md
│   ├── 前端性能优化_Core_Web_Vitals.md
│   └── _变更日志.md                    · CKO 回写追加
│
├── 源_官方文档/                         · T5（官方）
│   ├── Next.js/                        · App Router / RSC / Server Actions
│   ├── React/
│   ├── TypeScript/
│   ├── Tailwind/
│   ├── shadcn_ui/
│   ├── Supabase/                       · Auth / DB / Storage / Edge Functions / RLS
│   ├── Vercel/                         · 部署 / Edge / AI SDK
│   ├── Drizzle_ORM/
│   ├── Claude_API/                     · Anthropic SDK / Tool Use / MCP
│   ├── OpenAI_API/                     · 备选
│   ├── Expo/                           · React Native
│   ├── Cloudflare_Workers/
│   └── _新鲜/                          · 30 天内的版本更新
│
│   ├── Next.js_SaaS_Starter/
│   ├── Supabase_Examples/
│   ├── Claude_Cookbook/                · Anthropic 官方示例
│   └── LangChain_Templates/
│
├── 源_学术/                             · T1–T2 工程论文
│   ├── 分布式系统/                     · Google 三大论文 / Raft
│   ├── 数据库/                         · Postgres 内部原理
│   └── LLM_工程/                       · RAG / Agent 论文
│
├── 源_标准/                             · T3
│   ├── OWASP_Top_10/
│   ├── 12_Factor/
│   ├── W3C/                            · Web 标准
│   ├── GDPR/
│   └── 个保法/
│
├── 源_巨头/                             · T5 技术博客
│   ├── Vercel_Blog/
│   ├── Supabase_Blog/
│   ├── Anthropic_Blog/
│   ├── OpenAI_Blog/
│   └── Cloudflare_Blog/
│
├── 源_性能基准/                         · 库 A vs 库 B
│   ├── 框架冷启动对比/
│   ├── ORM性能对比/
│   └── LLM响应时延对比/
│
├── 源_用户提供/                         · B 档
│   ├── books/                          · 《设计数据密集型应用》等
│   └── courses/                        · 买过的课程讲义
│
└── _索引.md                             · 按主题组织的快速查表

4. 每份资料的元数据规范

---
title: {资料标题}
author: {作者 / 组织}
version: {版本号，如 Next.js 14.2}
year: {年份}
source_url: {来源 URL}
tier: {A / B}
authority_level: {T1–T7}
collected_at: {YYYY-MM-DD}
collected_by: {数据扒取部 / 用户提供 / CKO 回写}
tags: [Next.js, App Router, RSC]
summary: {一句话摘要}
---

4.1 权威金字塔（T1–T7，工程师特化）

级别	描述	示例
T1	顶会论文 / 祖师书	OSDI / SOSP / SIGMOD / 《Designing Data-Intensive Applications》
T2	学术期刊 / 博士论文	ACM Queue / arXiv
T3	标准组织	W3C / OWASP / 12-Factor
T4	顶级大学课程	MIT 6.824 / CMU 15-445
T5	官方文档 / 巨头博客	Next.js docs / Supabase docs / Anthropic blog
T6	高质量技术博客	Vercel blog / Dan Abramov / Kent C. Dodds
T7	社区问答	Stack Overflow / Reddit（不作引用源）

底线：工程师的正式技术决策至少引用 T5 及以上。T7 严禁作为技术决策依据。

5. 用法

5.1 在 SOP 第 4 步（技术选型）中的调用顺序

先看 方法论/ 里是否有现成的架构模式
没有 → 看 源_官方文档/ 找最新版本的权威做法
没有 → 看 源_开源参考/ 找同类项目的实现
没有 → 看 源_学术/ 找原理论文
还没有 → 点给数据扒取部扒新源
扒完后 → CKO 评估是否值得升级进 方法论/

5.2 `_索引.md` 按主题组织示例

## AI 能力集成
- Claude Tool Use → `方法论/AI能力集成模式.md` + `源_官方文档/Claude_API/tool_use.md`
- MCP 协议 → `源_官方文档/Claude_API/mcp.md`
- RAG 管道 → `方法论/RAG管道最佳实践.md`
- Prompt 工程 → `方法语/Prompt_Engineering实操.md`

## 数据库
- Supabase RLS → `源_官方文档/Supabase/rls.md`
- Drizzle 迁移 → `源_官方文档/Drizzle_ORM/migrations.md`
- Postgres 索引 → `源_学术/数据库/postgres_indexing.pdf`

## 性能
- Next.js RSC → `源_官方文档/Next.js/app_router.md`
- Core Web Vitals → `方法论/前端性能优化_Core_Web_Vitals.md`

6. 红线

❌ 不把单次项目的做法直接写到 方法论/（CKO 铁律 1）
❌ 不保存无元数据的资料
❌ 不保存二次蒸馏的总结（CKO 铁律 2）
❌ 不保存 Stack Overflow / Reddit 的答案作为方法论依据（T7 以下不准入库）
❌ 不保存包含真实密钥 / 业务数据的示例
❌ 不保存盗版电子书
❌ 不保存过时 ≥ 2 个大版本的官方文档（及时刷新）

7. 维护节奏

每周：数据扒取部追加官方文档的版本更新
每周：工程师 review _新鲜/ 决定哪些要精读
每月：CKO 回顾 方法论/，清理过时规则
每季：reviewer 过一遍库，确认没有"伪方法论"或过时版本