本篇定位这是你的工具箱。所有可直接复制使用的模板、一份按天拆解的落地计划、以及 10 个最常被问到的问题。建议收藏本篇随时回来查取。一、全套模板索引本小册共提供 14 份模板。下面按使用顺序排列每份标注用途和推荐优先级。序号模板名称用途优先级1CLAUDE.md 最小可用版项目规则入口起步用⭐⭐⭐ 必做2CLAUDE.md 进阶增强版项目规则入口成熟项目⭐⭐ 推荐3docs/content-rules.md内容文件规范⭐⭐⭐ 必做4docs/data-schema.md数据结构与实体关系⭐⭐⭐ 必做5docs/build-process.md构建链路说明⭐⭐⭐ 必做6docs/testing.md验证策略与检查清单⭐⭐ 推荐7docs/code-conventions.md项目代码约定⭐ 按需8docs/deployment.md发布流程与检查⭐ 按需9内容变更后检查清单每次改内容后对照⭐⭐⭐ 必做10结构变更后检查清单改数据结构后对照⭐⭐ 推荐11发布前/发布后检查清单上线前后对照⭐⭐ 推荐12信息筛选决策流程判断规则该不该写进 CLAUDE.md⭐⭐ 推荐13Hooks 配置示例5 个内容项目常用 hook⭐ 按需14维护节奏建议清单长期维护的时间表⭐ 按需二、模板 1CLAUDE.md 最小可用版适合刚开始搭建的项目。复制后把【】占位符替换成你的真实信息。# Project Context 本项目是一个【项目类型描述】主要用于【核心目标】。 处理任务时优先理解现有结构和字段设计再做增量修改。不随意重构。 ## About This Project - 框架【框架名称 语言】 - 内容源content/ 目录下的 Markdown 文件通过 frontmatter 定义元数据 - 内容解析【解析方式和关键文件位置】 - 搜索【搜索实现方式如有】 - 样式【CSS 方案】 - 部署【部署平台】 ## Key Directories - content/articles/【说明】 - content/faq/【说明】 - content/guides/【说明】 - app/页面路由与入口 - components/通用 UI 组件 - lib/内容解析、工具函数 - scripts/构建脚本 新增代码优先放入已有目录不随意创建新的顶层目录。 ## Commands - npm install安装依赖 - npm run dev启动开发环境 - npm run build完整构建 - npm run lint代码检查 - npm run type-check类型检查 - npm run content:build生成内容索引如有此命令 修改内容文件后建议运行内容构建命令确认索引正常。 ## Standards - 所有内容文件必须包含完整 frontmattertitle, slug, category, tags, date, draft - 不要修改已发布内容的 slug - 不要随意新增 frontmatter 字段 - category 使用已有分类名不发明近义词 - tags 命名保持一致 - 优先复用已有组件和函数 - 不提交 .env、密钥、Token ## Workflows ### 新增内容 1. 搜索是否已有类似内容 2. 确认应放入哪个内容目录 3. 使用统一的 frontmatter 结构 4. 文件名小写英文 中划线 5. 完成后运行内容构建验证 ### 修改已有内容 1. 先阅读原文件 frontmatter 和结构 2. 确认修改范围 3. 不修改 slug除非被明确要求 4. 完成后运行内容构建验证 ## Notes - generated/ 目录文件由脚本生成不手动修改 - frontmatter 与规范不一致时记录问题而非大批量修改 - 文档与代码不一致时以代码为准三、模板 2CLAUDE.md 进阶增强版追加模块
附录篇：全套模板汇总 + 一周落地计划 + 常见问题
本篇定位这是你的工具箱。所有可直接复制使用的模板、一份按天拆解的落地计划、以及 10 个最常被问到的问题。建议收藏本篇随时回来查取。一、全套模板索引本小册共提供 14 份模板。下面按使用顺序排列每份标注用途和推荐优先级。序号模板名称用途优先级1CLAUDE.md 最小可用版项目规则入口起步用⭐⭐⭐ 必做2CLAUDE.md 进阶增强版项目规则入口成熟项目⭐⭐ 推荐3docs/content-rules.md内容文件规范⭐⭐⭐ 必做4docs/data-schema.md数据结构与实体关系⭐⭐⭐ 必做5docs/build-process.md构建链路说明⭐⭐⭐ 必做6docs/testing.md验证策略与检查清单⭐⭐ 推荐7docs/code-conventions.md项目代码约定⭐ 按需8docs/deployment.md发布流程与检查⭐ 按需9内容变更后检查清单每次改内容后对照⭐⭐⭐ 必做10结构变更后检查清单改数据结构后对照⭐⭐ 推荐11发布前/发布后检查清单上线前后对照⭐⭐ 推荐12信息筛选决策流程判断规则该不该写进 CLAUDE.md⭐⭐ 推荐13Hooks 配置示例5 个内容项目常用 hook⭐ 按需14维护节奏建议清单长期维护的时间表⭐ 按需二、模板 1CLAUDE.md 最小可用版适合刚开始搭建的项目。复制后把【】占位符替换成你的真实信息。# Project Context 本项目是一个【项目类型描述】主要用于【核心目标】。 处理任务时优先理解现有结构和字段设计再做增量修改。不随意重构。 ## About This Project - 框架【框架名称 语言】 - 内容源content/ 目录下的 Markdown 文件通过 frontmatter 定义元数据 - 内容解析【解析方式和关键文件位置】 - 搜索【搜索实现方式如有】 - 样式【CSS 方案】 - 部署【部署平台】 ## Key Directories - content/articles/【说明】 - content/faq/【说明】 - content/guides/【说明】 - app/页面路由与入口 - components/通用 UI 组件 - lib/内容解析、工具函数 - scripts/构建脚本 新增代码优先放入已有目录不随意创建新的顶层目录。 ## Commands - npm install安装依赖 - npm run dev启动开发环境 - npm run build完整构建 - npm run lint代码检查 - npm run type-check类型检查 - npm run content:build生成内容索引如有此命令 修改内容文件后建议运行内容构建命令确认索引正常。 ## Standards - 所有内容文件必须包含完整 frontmattertitle, slug, category, tags, date, draft - 不要修改已发布内容的 slug - 不要随意新增 frontmatter 字段 - category 使用已有分类名不发明近义词 - tags 命名保持一致 - 优先复用已有组件和函数 - 不提交 .env、密钥、Token ## Workflows ### 新增内容 1. 搜索是否已有类似内容 2. 确认应放入哪个内容目录 3. 使用统一的 frontmatter 结构 4. 文件名小写英文 中划线 5. 完成后运行内容构建验证 ### 修改已有内容 1. 先阅读原文件 frontmatter 和结构 2. 确认修改范围 3. 不修改 slug除非被明确要求 4. 完成后运行内容构建验证 ## Notes - generated/ 目录文件由脚本生成不手动修改 - frontmatter 与规范不一致时记录问题而非大批量修改 - 文档与代码不一致时以代码为准三、模板 2CLAUDE.md 进阶增强版追加模块
