production-ai-app-engineering
================================
一份与编程语言、业务方向无关的「AI 应用工程决策手册」。
不是规则清单，而是取舍判断：每个模式都讲清「问题 → 推荐做法 → 为什么有效 →
失败边界/代价 → 何时不该用」。

本包内含两个语言版本，内容一一对应
------------------------------------
  production-ai-app-engineering/      英文版（English）
  production-ai-app-engineering-zh/   中文版（简体中文）

内容涵盖（每版 11 卷）
----------------------
01 架构分层与依赖边界     02 Agent 编排（路由/规划/DAG/重规划）
03 结构化 LLM 边界        04 人在环（HITL）
05 工具韧性与安全         06 可靠性原语（队列/事件流/幂等/状态机/锁/限流）
07 多租户与密钥           08 上下文与记忆
09 可观测与评测           10 成本 / 配额 / 部署
11 通用反模式

安装（作为 ZCode / 兼容 Agent Skills 的本地技能）
-------------------------------------------------
把你要用的那个目录放进任一技能目录即可：

  ~/.agents/skills/production-ai-app-engineering/       # 英文版，全局（推荐）
  ~/.agents/skills/production-ai-app-engineering-zh/    # 中文版，全局
  ~/.zcode/skills/<name>/                               # 优先级更高，可覆盖
  <项目>/.agents/skills/<name>/                         # 仅当前项目

目录结构（每版相同）：
  <name>/
  ├── SKILL.md          # 入口：frontmatter + 8 条核心原则 + 分卷索引
  └── references/       # 11 个分卷，按需读取

用法
----
设计、评审、重构或调试任何以 LLM 为核心的应用前，先读 SKILL.md 按任务类型
查索引表，再按需读对应的 references/ 分卷。

许可：可自由用于学习与工程实践。
