第 7 章：大型项目的提示词架构

7.1 三层提示词体系

在大型项目中，单一提示词无法覆盖所有场景。你需要建立多层级体系，每层有不同的职责和粒度：

7.2 全局一致性维护

风格字典（Style Dictionary）

风格字典是项目级的"命名圣经"。当 AI 生成新代码时，它必须遵循已建立的命名和风格约定。

# 项目风格字典 — 放在 CLAUDE.md 或 .claude/style-dict.md 中
## 命名约定
- 数据库表：snake_case 复数 (disk_infos, user_sessions)
- API 端点：kebab-case (/api/disk-health, /api/user-sessions)
- React/Vue 组件：PascalCase (DiskHealthPanel.vue)
- 配置键：snake_case 层级点号 (storage.default_pool.size)

## 术语表
- "pool" = 存储池（一组磁盘的逻辑集合）
- "share" = 共享目录（暴露给网络的文件夹）
- "volume" = 卷（存储池中分配的独立空间）
- "export" = NFS 导出项

## 代码模式
- 数据库操作 → 使用 Repository 类，不裸写 SQL
- 外部命令调用 → 通过 CommandExecutor 封装，统一错误处理
- 配置读写 → 通过 ConfigManager，不允许直接 os.getenv
- API 响应 → 统一格式 {"data": ..., "error": ..., "meta": {...}}

配置中心模式

项目中所有可配置的值集中管理，AI 在生成代码时引用配置中心而非硬编码值：

# config/constants.py — AI 生成的代码应引用这些值
class StorageDefaults:
    DEFAULT_FS_TYPE = "ext4"
    MOUNT_BASE_PATH = "/mnt/nas"
    MAX_VOLUME_SIZE_GB = 16 * 1024  # 16TB
    HEALTH_CHECK_INTERVAL = 3600     # 1小时

class NetworkDefaults:
    SMB_WORKGROUP = "WORKGROUP"
    NFS_EXPORT_PATH = "/exports"
    FTP_PORT = 21
    MAX_CONNECTIONS = 50

7.3 长周期项目的上下文管理

上下文持久化策略矩阵

上下文信息分层