附录 A. 通往第一卷的桥梁
应用卷依赖于第一卷的材料。本附录将所有桥梁汇集于一处：第一卷的哪些部分被视为先决条件、我们的 SDD 方言如何与 Spec Kit 和 Kiro 相关联，以及第二卷的生产场景如何从 AgentClinic 教学项目中发展而来。
如果以下任何内容不熟悉——请先完成第一卷的相应部分，否则第二卷的许多章节会显得术语堆砌。
在第 1 章之前，请阅读第 0 部分。它将基础 AgentClinic 转换为教学生产模型，并确定最小路径：哪些工件需要手动填写、哪些示例在本地运行，以及哪些模块仅适用于完整的实施路径。
不掌握这些，第二卷无法阅读
| 需要理解的内容 | 第一卷中的引入位置 |
|---|---|
mission.md、tech-stack.md、roadmap.md 的结构 | 第 6 部分. 制定宪法 |
requirements.md、plan.md、validation.md 的格式 | 第 7 部分. 功能规格说明 |
| 合并准入事实、EARS、Given/When/Then | 第 9 部分. 功能验证：从规格到事实 | | 重新规划和路线图更新 | 第 10 部分. 项目重新规划 | | 遗留代码库维护和规格考古 | 第 13 部分. 现有项目维护 | | 智能体可替换性、对 ACP/AGENTS.md 的引用 | 第 15 部分. 智能体可替换性 | | 团队评审和证据包 | 第 16 部分. 团队协作和代码评审 | | Qwen Code 钩子、PreToolUse 和 PostToolUse | 第 17 部分. Qwen Code 钩子 | | SDD 反模式 | 第 20 部分. SDD 反模式 | | 实践考核作为整个流程的验证 | 第 22 部分. 实践考核 |
SDD 方言：Spec Kit、Kiro、教材作者方言
应用卷使用与第一卷相同的作者方言。与 GitHub Spec Kit 和 AWS Kiro 的详细对比见第一卷附录 A：工件对应表、流程迁移建议、各格式的限制。
如果团队已在 Spec Kit 或 Kiro 中工作，阅读第二卷时请在心里重命名：requirements.md → /speckit.specify、plan.md → /speckit.plan + /speckit.tasks、validation.md → /speckit.analyze + 检查清单。各章节不严格绑定格式：其思想可在方言之间迁移而不损失意义。
AgentClinic 领域地图
第二卷的生产场景在心理上基于第一卷的教学项目 AgentClinic 展开。领域实体的完整描述——患者智能体、疾病、治疗方案、预约、评价、反馈——收集于第一卷附录 B。
第二卷不要求第一卷的结果已在真实生产基础设施中运行。各章节中的外部系统——是教学用的事件来源和约束。它们用于展示同一 SDD 循环在面临回滚风险、升级、指标和模型预算时的表现。
当第二卷中出现生产实体（appointments-api、node_not_ready、appointment_latency、appointment_latency_spike、high_memory_usage、autoscale_200pct、cdn_error_budget_burn、rate_limit_breach）时，它们与 AgentClinic 的对应关系如下。对于考核路径，请使用 high_memory_usage 作为主要案例；其余字符串有助于理解本地可运行示例，不需要单独的证据包。
| 第一卷的教学代码 | 第二卷的衍生生产场景 |
|---|---|
GET / 路由（Hello Hono，第 7 部分） | node_not_ready：副本不响应就绪检查（health-check） |
| Hono JSX 上的智能体页面（第 11 部分） | appointment_latency / appointment_latency_spike：/agents 路由延迟 |
| SQLite + 评价迁移（第 12 部分） | high_memory_usage：部署后的读取峰值 |
| 反馈表单（第 12 部分） | rate_limit_breach：相同 POST 请求流 | | MVP 阶段（第 12 部分） | autoscale_200pct：负载急剧增长 | | 智能体日志（第 11 部分） | cdn_error_budget_burn：仪表板指标差异 | | 诊所运营者语气（第 6 部分） | 来自非正式信号的隐性规格 |
应用卷 README 提供了简短的阅读地图和指向本附录的链接。完整的领域表位于此处，以便在阅读第二卷任何章节时，可以快速回忆某个生产症状对应的是哪段教学代码。
第二卷新增内容
| 层次 | 第二卷中的讨论位置 |
|---|---|
| AgentClinic-production 实验室框架和最小路径 | 第 0 部分. AgentClinic-production 实验室 |
| 从遗留系统痕迹中恢复规格 | 第 1 部分. 从遗留系统中恢复规格 |
| 规格中的受控缺陷 | 第 2 部分. 规格缺陷诊断 |
| 具有不可变层和可变层的生产宪法 | 第 3 部分. 项目宪法 | | 角色间的对抗性验证 | 第 4 部分. LLM 对决 | | 规格的变异测试 | 第 5 部分. 规格变异测试 | | 隐性启发式规则的形式化 | 第 6 部分. 筛选隐性规格 | | 规格网关作为强制关卡 | 第 7 部分. 规格 CI | | 争议变更的文件仲裁 | 第 8 部分. 争议变更的多智能体仲裁 | | 模型路由和分层预算 | 第 9 部分. 分层预算 | | 反古德哈特的成对守护指标 | 第 10 部分. 保护指标免受古德哈特效应 | | 与生产 API 集成和自动修复 | 第 11 部分. 生产 API | | 应用循环反模式诊断图 | 第 12 部分. 生产 SDD 反模式 |
| 最终生产考核和证据包 | 第 13 部分. 实践考核 |
上表即是将抽象生产场景转化为教学项目延续的桥梁。在第二卷的个别章节中（例如第 12 部分——生产 SDD 反模式），对第一卷的引用也以单独区块置于页脚；在其他章节中，它们根据讨论需要编织入正文。