用途:为项目根目录生成 CLAUDE.md,作为 Claude 在特定代码库中每次调用都会加载的行为规则文件,内容需精简。
生成前先检查前置资料:读取 progress.txt(优先看 run_target 字段,决定启动命令与部署段),并依次读取 docs/TECH_STACK.md、DESIGN_SYSTEM.md、FRONTEND_GUIDELINES.md、BACKEND_STRUCTURE.md、APP_FLOW.md、IMPLEMENTATION_PLAN.md。随后判断所需技术栈适配器:Python 后端(Flask/Django/FastAPI)、其他后端(Go/Ruby/Rust/PHP)、桌面应用(Electron/Tauri);run_target 为 desktop 或 has_frontend 为 false 时相应调整或省略部分章节。
主要生成内容按步骤进行:概述(技术栈、类型、运行目标、启动命令)、Always Read First(4 个文件)、项目结构(仅关键目录)、设计规则(5 条)、组件规则、API 规则、状态规则、文件安全规则、当前实现阶段(含如何续接)、Common Gotchas(至少 3 条且项目特定、不得用占位符)、测试部分;保存到 ./CLAUDE.md(项目根目录而非 ./docs/),运行校验清单,并询问“CLAUDE.md generated. Approve or request revisions?”。
限制:文件应保持在 150 行以内,不写入完整代码示例;150-250 行需将内容移至 docs/,超过 250 行(或超过 5 个标题、含完整代码示例、用户反馈 Claude 遗忘规则)应拆分,拆分后保持 100 行以内。只读 ./docs/ 文件,不修改设计 token,一次只改一处并测试。其他平台、收费与具体效果等资料暂未提供。