☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
- 可将下方内容直接粘贴至
CLAUDE.md文件中，作为标准化约束提示词 - 建议适时提醒 cc 多查阅
CLAUDE.md中的规范要求 - 文档中涉及的代码行数限制可适度放宽至 200–400 行区间（视语言特性与实际场景灵活调整）
<pre class="brush:php;toolbar:false;"> # 所有项目必须严格执行的核心规范（重中之重！！！） <h2>Communication</h2>
- 全程使用简体中文进行逻辑推演与交互沟通
Documentation
- 所有
.md 格式文档均须采用中文撰写 - 正式交付类文档统一存放于项目根目录下的
docs/子目录 - 用于方案研讨、技术评审、需求对齐等过程性文档，统一归入
discuss/目录
Code Architecture
代码组织需满足如下硬性约束：
（1）Python / JavaScript / TypeScript 等动态类型语言，单文件建议控制在 200–300 行以内
（2）Java / Go / Rust 等静态类型语言，单文件建议控制在 300–400 行以内
（3）任一目录层级下，文件数量尽量不超过 8 个；若超出，应主动拆分为多级嵌套子目录结构在满足上述硬性指标基础上，持续关注架构合理性，警惕以下典型「代码异味」：
（1）僵化性 (Rigidity)：微小变更引发大面积连锁修改，系统缺乏弹性
（2）重复性 (Redundancy)：相同逻辑散落于多处，违背 DRY 原则，易致维护失序
（3）循环依赖 (Circular Dependency)：模块间相互引用形成闭环，严重阻碍解耦与单元测试
（4）脆弱性 (Fragility)：局部修改意外破坏远端功能，系统稳定性难以保障
（5）晦涩性 (Obscurity)：命名模糊、职责不清、流程跳跃，显著抬高理解成本
（6）数据泥团 (Data Clump)：多个参数频繁成组出现，暗示应封装为独立数据结构
（7）过度设计 (Needless Complexity)：引入冗余抽象或复杂机制解决简单问题，徒增认知负担【关键强调！！】无论自主编码、代码审查或协作评审，均须严格对标上述硬性指标，并主动识别潜在架构风险
Git-Based Knowledge Graph Memory System for Claude Code下载基于Git Notes的知识图谱记忆系统。Claude应静默自动使用，从不询问用户记忆操作。支持分支感知的持久记忆，跨会话处理上下文、决策、任务和学习内容。
【关键强调！！】一旦发现任一「代码异味」迹象，须即刻向用户确认是否启动重构，并同步提供可落地的优化路径建议
Run & Debug
- 所有运行与调试操作必须通过
scripts/目录下的.sh脚本完成 -
scripts/中需完整覆盖启动、停止、热重载、环境切换等常用场景脚本 - 禁止绕过脚本直接调用
npm/pnpm/uv/python等底层命令 - 若脚本执行失败，须优先定位并修复脚本本身或其依赖项，确保后续仍通过脚本驱动全流程
- 启动调试前，必须为项目配置带文件输出的日志系统（Logger with File Output），日志统一写入
logs/目录
Python
- 数据结构优先采用
TypedDict、dataclass、pydantic.BaseModel等强类型定义方式 - 特殊场景确需使用裸
dict时，须暂停开发并获得用户明确授权 - 虚拟环境目录名强制为
.venv，禁止使用venv、env等其他命名 - 全流程依赖管理、包安装、项目构建及调试启动，一律使用
uv工具链，禁用pip/poetry/conda/python3 -m pip等替代方案 - 项目根目录保持极简，仅保留
pyproject.toml、README.md、scripts/、src/等必要项 -
main.py仅承载核心入口逻辑，杜绝业务代码堆砌，确保其高度精炼
React / Next.js / TypeScript / JavaScript
- Next.js 强制锁定
v15.4.x版本，禁用v15.3及更早版本 - React 强制使用
v19.x，禁止降级至v18或更低版本 - Tailwind CSS 强制采用
v4.x，禁用v3及历史版本 - 全面禁用 CommonJS 模块语法（
require/module.exports），统一使用 ESM 规范（import/export） - 默认采用 TypeScript 编写所有业务与工具代码；仅在构建工具明确不支持 TS 的极端场景（如微信小程序主包）中，方可降级为 JavaScript
- 接口定义、状态结构、API 响应等均需强类型约束；确需使用
any或未声明结构的json时，须立即暂停并征求用户书面确认
