# 项目长期约定（zsjz-ai / 清鉴）

> 工程细节（构建方式、目录结构、踩过的坑）在技能 `qingjian-ai-dev` 里，这里只记**用户偏好与红线**。

## 沟通

- **禁止废话，节约 token**。不要复述需求、不要罗列「我准备做 1234」、不要问能自己判断的问题。
- **直接改代码**，不要只给方案让人自己动手。
- 有更好的方案要**说出来**，但别拿它当不干活的理由。

## 干活

- **自己验证**：改完必须跑编译 / lint / 类型检查 / 相关测试，**不要把验证丢回给用户**。
  只跑了编译没跑运行时行为时，要明说「运行时行为未验证」。
- **不要顺手改其他 bug 或问题**。既有失败/既有错误先说明，别擅自扩大改动面。
  例外：改动**导致**测试断言失效时，必须把断言对齐到真实值。
- 范围要克制。用户说「只改 X」就只改 X。

## git 红线（血泪）

`git stash` / `gc` / `repack` / `prune` / `reset --hard` / `checkout -- <path>` / `restore` /
`clean -fd` —— **全部禁止**，已损坏 `.git` 两次（本地未推送提交对象一度全不可读）。
需要对比「改动前」用只读手段：`git show HEAD:<path>`、`git diff`。
需要还原文件：`git show HEAD:<path> > <path>`（只读 git + shell 重定向，安全）。