fengpu
76dbca9fb7
- decisions.md: 新增健康生产菜单「净菜组配」与设备端「净配秤」术语边界决策 + 补 frontmatter - project_progress.md: 新增 2026-08-21~27 九条里程碑 - lint_report.md: 更新健康检查结果（AUTO-FIX 1 项，NEED-HUMAN 7 项） - MEMORY.md / CLAUDE.md: 刷新 base commit 与元数据
3.9 KiB
3.9 KiB
项目约束
本项目所有工作必须严格遵守 项目背景.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 中出现非预期的删除或回退，必须立即中止提交并向用户报告
记忆体系（会话启动必读）
强制规则：每次新会话启动时，必须先读取本项目的记忆体系索引，再按需加载关键记忆文件，然后才能开始处理用户请求。长会话中若上下文被压缩，同样需要重新加载。
读取流程
- 读取索引：
cat .claude/memory/MEMORY.md— 获取记忆文件清单与最近更新状态 - 必读文件（每次会话必须加载）：
decisions.md— 关键决策与架构约定，避免重复讨论已决事项feedback.md— 协作规范与用户纠正，避免重犯已纠正的错误project_progress.md— 当前阶段进度与待办，避免重复已完成工作project_overview.md— 项目技术栈与三端架构，避免对项目结构产生误解
- 按需加载（与当前任务相关时加载）：
user_profile.md— 用户角色与偏好（需要个性化回复时）lint_report.md— 记忆健康检查报告（发现记忆体系存在待处理问题时）
记忆体系的更新与同步
- 记忆体系文件更新：当收到git指令并完成本地代码提交之后要自动调用/memory-sync插件完成记忆文件的更新
记忆目录
.claude/memory/
├── MEMORY.md # 索引（入口）
├── decisions.md # 关键决策
├── feedback.md # 协作规范
├── project_progress.md # 阶段进度
├── project_overview.md # 技术栈与架构
├── user_profile.md # 用户画像
└── lint_report.md # 记忆健康检查报告（按需）
记忆文件是跨会话持久化的知识，优先级高于 Agent 的默认推断。若记忆内容与当前代码状态冲突，以代码为准并更新记忆。