你的 AI 每次用不同的变量名——命名一致性的三个锚点

# 上个月 AI 写的
def get_user_data(user_id):
    user_profile = db.query(User).filter_by(id=user_id).first()
    return user_profile

# 这个月 AI 写的
def fetchUser(userId):
    profile = db.query(User).filter_by(id=userId).first()
    return profile

# ❌ 命名规范（告诉 AI 格式，没告诉含义）
函数用 snake_case
变量用 snake_case
类用 PascalCase

# ✅ 命名清单（告诉 AI 具体用什么）
## 用户模块命名清单
函数：
  - get_user(id)      # 获取单个用户
  - list_users(filters) # 获取用户列表
  - create_user(data)  # 创建用户
  - update_user(id, data) # 更新用户
  - delete_user(id)    # 删除用户

变量：
  - user               # 单个用户对象
  - users              # 用户列表
  - user_input         # 用户输入（未处理）
  - user_data          # 用户数据（已处理）
  - user_id            # 用户 ID
  - user_email         # 用户邮箱

永远不要用：
  - fetchUser, getUserProfile（camelCase）
  - usr, u（缩写）
  - profile（用 user_profile）

# 每新增一个模块，花 3 分钟补充命名清单
# 不是提前设计所有命名——是做一点补一点

# 模块：订单
新增函数：place_order, cancel_order, refund_order
新增变量：order, order_items, order_status
# 就这样，不需要完整规划，用到再补

# 在项目根目录放一个 NAMING_EXAMPLE.py
# 这个文件不参与运行，纯粹作为风格参考

# NAMING_EXAMPLE.py
# 注意：这个文件不是用来执行的，是给 AI 看命名风格的

def get_user(user_id: int) -> dict:
    """获取单个用户"""
    user = db.query(User).filter_by(id=user_id).first()
    return user

def list_users(page: int, per_page: int) -> list:
    """分页获取用户列表"""
    users = db.query(User).offset((page - 1) * per_page).limit(per_page)
    return users

# ↑ AI 看到这些后生成的代码会自然用 get_xxx, list_xxx 模式
#    而不是 fetchXxx / getXxxList 之类的混搭

命名风格参照 NAMING_EXAMPLE.py。如果 NAMING_EXAMPLE.py 中没有对应的命名模式，请先问我。

# 你的清单里
用户输入变量：user_input

# AI 写代码时觉得
user_payload  # 更专业
payload       # 更简洁

# 给 AI 一条硬规则
## 命名策略
1. 清单已有的名字，直接用。不允许"优化"或"简写"。
   原因：一致性的价值 > 单个名字的优雅度。

2. 如果你认为清单中的名字确实不合适：
   → 先在回答中说明理由
   → 等我确认后再改
   → 确认后，同步更新命名清单

3. 清单中没有的名字：
   → 参照 NAMING_EXAMPLE.py 的风格
   → 如果仍不确定，问我

# 1. 阅读成本
# 一个命名一致的代码库，AI 每次新对话进入状态的速度快 3-5 倍
# 不需要"翻译"不同的命名风格

# 2. 重构成本
# 你想把 user_profile 重命名为 user_data
# 如果全项目用的都是 user_profile → 一次 grep + 批量替换
# 如果有 userProfile / profile / usr_prof / user_info → 六次 grep + 手动判断

# 3. AI 代码质量
# 当 AI 只看到一种命名模式时，它生成的代码更准确
# 当它看到三四种混搭时，它会混搭着用——结果就是更多的混搭

1. 给当前项目写一份"命名清单"（不是规范，是字典）
   → 先只写核心模块（用户、订单、商品），10 分钟够

2. 建一个 NAMING_EXAMPLE.py
   → 放 3-5 个关键函数的签名，就够了

3. 在 SOUL.md 里加一条：
   → "清单已有的名字，直接用。不允许优化或简写。"