chore: Add 3 dev rules to CLAUDE.md template and archive CICD reference docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 21:38:43 +08:00
parent 50005945bc
commit 755dd3409c
3 changed files with 1591 additions and 0 deletions
@@ -78,6 +78,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - **包管理器**: 使用 {{包管理器}}（不是 {{其他包管理器}}）
 - **TDD 流程**: 先写测试再实现，核心业务逻辑覆盖率 100%
 - **日志规范**: 使用日志管理器，避免 console.log
+- **入口统一校验**: 所有外部输入（API 参数、用户输入、配置项）在入口处统一校验，内部代码信任已校验的数据，不重复检查
+- **空值显式报错**: 禁止静默吞掉 null/undefined/空字符串，遇到非预期空值必须抛出明确错误信息（含变量名和上下文），让问题在第一现场暴露
+- **关键节点结构化日志**: 在业务关键节点（请求进出、状态变更、外部调用、异常捕获）输出结构化日志，包含 traceId、操作、耗时、结果，便于排查和监控
 - **知识沉淀**: 将有价值的对话迭代沉淀到文档中，包括：
  - 重要技术决策和架构演进 → 更新 CLAUDE.md 相关章节
  - 新功能实现方案 → 更新组件职责、数据流等章节