platform-prototype/CLAUDE.md

项目约束

本项目所有工作必须严格遵守 项目背景.md 中定义的全部规范，包括：

• 项目结构规范（三端目录划分、模块分目录）
• HTML 原型编写规范（独立文件粒度、自包含、视觉尺寸、设计令牌）
• 交互效果规范（导航跳转、Tab切换、交互注释标注）
• 命名规范（小写短横线文件名、BEM 类名）
• 墨刀导入兼容约束（禁止外部引用、简洁DOM、内联SVG）
• 模块文档规范（CHANGELOG、PRD、截图，详见 项目背景.md 第七部分）

每次生成或修改 HTML 原型文件前，必须先确认符合上述约束。

Agent 行为约束（补充项目背景.md 中未涉及的 Agent 专属规则）

PRD 文档更新时机

• 禁止自动更新：修改原型页面时不得自动同步更新 PRD 文档
• 仅在用户明确要求时才编写、更新 PRD 或重新截取页面截图
• PRD 的具体编写规范和截图规范见 项目背景.md 第 7.3 和 7.4 节

CHANGELOG 更新时机

• 每次提交代码前，自动整理本次变更内容并追加到对应模块的 doc/CHANGELOG.md 中
• 格式规范见 项目背景.md 第 7.2 节

导航页同步

• 新增原型页面时，必须同步在 index.html 的 SITE_MAP 中添加对应条目
• PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑

文件写入安全（严重事故教训 2026-05-15）

绝对禁止：批量操作时覆盖已完成的文件修改。

• 对文件执行写入/编辑前，必须先读取该文件当前最新内容，禁止使用内存中缓存的旧版本写入
• 批量处理多文件时，每个文件独立「读取→修改→写入」，不得跨文件复用旧内容
• 同一会话中若一个文件被多次修改，后续修改必须基于前次修改后的最新状态
• 提交前必须执行 git diff --staged 审查，确认所有变更符合预期、无意外回退
• 若发现 diff 中出现非预期的删除或回退，必须立即中止提交并向用户报告

记忆体系（会话启动必读）

强制规则：每次新会话启动时，必须先读取本项目的记忆体系索引，再按需加载关键记忆文件，然后才能开始处理用户请求。长会话中若上下文被压缩，同样需要重新加载。

读取流程

1. 读取索引：cat .claude/memory/MEMORY.md — 获取记忆文件清单与最近更新状态
2. 必读文件（每次会话必须加载）：
   • decisions.md — 关键决策与架构约定，避免重复讨论已决事项
   • feedback.md — 协作规范与用户纠正，避免重犯已纠正的错误
   • project_progress.md — 当前阶段进度与待办，避免重复已完成工作
   • project_overview.md — 项目技术栈与三端架构，避免对项目结构产生误解
3. 按需加载（与当前任务相关时加载）：
   • user_profile.md — 用户角色与偏好（需要个性化回复时）
   • feedback_medical_pad_migration.md — 医疗点PAD端原型规范：无前缀英文名、无模块导航页、简单弹窗页内实现、1280×800 外壳（涉及 medical-pad 页面时）
   • feedback_shell_sidebar_scope.md — Web 管理端壳层规范：顶栏=一级分组、侧栏仅当前分组二级菜单、页头不放面包屑（涉及管理端新模块壳层时）
   • project_database_postgresql.md — 项目数据库统一为 PostgreSQL（生成数据库设计说明书/解析 SQL 时）
   • lint_report.md — 记忆健康检查报告（发现记忆体系存在待处理问题时）

记忆体系的更新与同步

1. 记忆体系文件更新：当收到git指令并完成本地代码提交之后要自动调用/memory-sync插件完成记忆文件的更新

记忆目录

.claude/memory/
├── MEMORY.md                          # 索引（入口）
├── decisions.md                       # 关键决策
├── feedback.md                        # 协作规范
├── feedback_medical_pad_migration.md  # 医疗点PAD端原型规范（按需）
├── feedback_shell_sidebar_scope.md    # Web管理端壳层导航规范（按需）
├── project_progress.md                # 阶段进度
├── project_overview.md                # 技术栈与架构
├── project_database_postgresql.md     # 数据库选型（按需）
├── user_profile.md                    # 用户画像
└── lint_report.md                     # 记忆健康检查报告（按需）

记忆文件是跨会话持久化的知识，优先级高于 Agent 的默认推断。若记忆内容与当前代码状态冲突，以代码为准并更新记忆。