Files
platform-prototype/CLAUDE.md
T
liuyunqinandClaude Haiku 4.5 2ed0594d06 feat: 完整环境监测模块——地图/列表视图、设备详情、报警数据
新增员工端环境监测完整功能模块:
- 主页面(environment/index.html):4个监测类型Tab切换、地图/列表双视图、设备搜索筛选
- 设备详情页(device-detail.html):指标展示、趋势分析、SVG仪表盘、柱状图
- 报警数据页(alarm-data.html):日期范围筛选、类型筛选、阈值范围展示

数据结构与后台对齐:
- 室外空气:温度、湿度、太阳辐射、PM2.5、PM10、照度、风速
- 室内空气:温度、湿度、CO₂、甲醛、PM2.5、PM10
- 水质监测:PH、电导率、盐度、TDS、电阻率、温度
- 花粉监测:柏科、藜科、苋科、花粉总数

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-05-25 20:01:05 +08:00

3.7 KiB
Raw Blame History

项目约束

本项目所有工作必须严格遵守 项目背景.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.htmlSITE_MAP 中添加对应条目
  • PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑

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

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

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

记忆体系(会话启动必读)

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

读取流程

  1. 读取索引cat .claude/memory/MEMORY.md — 获取记忆文件清单与最近更新状态
  2. 必读文件(每次会话必须加载):
    • decisions.md — 关键决策与架构约定,避免重复讨论已决事项
    • feedback.md — 协作规范与用户纠正,避免重犯已纠正的错误
    • project_progress.md — 当前阶段进度与待办,避免重复已完成工作
  3. 按需加载(与当前任务相关时加载):
    • project_overview.md — 技术栈与架构(涉及架构讨论时)
    • user_profile.md — 用户角色与偏好(需要个性化回复时)

记忆体系的更新与同步

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

记忆目录

.claude/memory/
├── MEMORY.md              # 索引(入口)
├── decisions.md           # 关键决策
├── feedback.md            # 协作规范
├── project_progress.md    # 阶段进度
├── project_overview.md    # 技术栈与架构
└── user_profile.md        # 用户画像

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