📚 首页 / coordination / track-gapfix.md

track-gapfix — 内容缺口 + 架构决策训练集补齐汇报（subagent 交付，2026-08-30）

任务来源：用户原始简报第 7/9 节的内容缺口 + 架构决策训练集硬指标（≥30 场景）。协调者：mark 主会话。写入范围严格限于本清单所列文件，未动其他任何文件，未使用 git。

交付清单

A. 模块内容补丁（3 个 README 追加 + 3 个 CSV 追加）

文件	变更	说明
`04-tool-use/README.md`	新增 §13 幂等性与安全重试（原 §13 下一步 → §14）	三层重试风险（SDK/执行器/模型 is_error 重发）、幂等键与写操作去重、重试风暴防护（退避+抖动+爬坡）、`tool_use id ≠ 幂等键` 边界、超时≠失败先对账、与 §5 错误回传/§6 审批门合成可靠性视图；含 Bad vs Better 与术语表。来源：api/errors、handle-tool-calls（均 2026-08-30，仓库既有 VERIFIED 源）；幂等键/熔断等明确标注为通用工程实践非官方专文
`05-prompting-structured-output/README.md`	新增 §10 提示词版本管理（原 §10 本模块文件 → §11）	prompt 即代码（版本控制/不可变版本/prompt×模型×参数三元组/schema 同步版本化）、变更评审检查单、回归评估联动（Mermaid 门禁图，呼应模块 12 golden dataset 与官方 eval-first）、与 prompt caching 的前缀稳定交互；Bad vs Better。来源：prompt-engineering overview、develop-tests、api/versioning、prompt-caching（均仓库既有 VERIFIED 源）；版本管理实践标注为工程综合
`07-rag-context-engineering/README.md`	① §8.4 五路选型对比表（RAG vs 长上下文 vs 工具查询 vs 数据库直查 vs 微调，8 维度 + 决策要点五问句）；② 新增 §14 查询改写（改写/扩展/分解 + HyDE，与 contextual retrieval 的对称性，Mermaid 位置图）；③ 新增 §15 Lost in the Middle（U 形位置衰减 + 缓解三招：重排摆放/结构化/分段处理，与 context rot 的术语辨析）；原 §14 文件地图 → §16（闪卡数同步改 32 张）	新来源：arXiv 2212.10496（HyDE）与 arXiv 2307.03172（LitM）本轮 web_fetch 实测 HTTP 200 后引用；fine-tuning 官方文档 URL 实测 404，故 §8.4 的④⑤列明确标注「本仓库综述、平台微调能力以官方文档现状为准」，不虚构官方断言；Anthropic RAG cookbook 抓取内容无法核实 query analysis 章节，未将该说法归于官方
`flashcards/flashcards-04.csv`	+3 张（幂等/幂等键/重试风暴）	22 张，csv 模块解析校验通过（5 列无坏行）
`flashcards/flashcards-05.csv`	+3 张（版本管理/回归联动/缓存交互）	25 张，同上校验通过
`flashcards/flashcards-07.csv`	+8 张（改写/HyDE/对称性/LitM/缓解/顺序即资源/直查 vs 工具查询/微调劣势）	32 张，同上校验通过；与 07 README 文件地图声明的 32 张一致

B. architecture-exercises/（新建目录，5 个文件，32 题 = 硬指标 30 的 106%）

文件	内容
`README.md`	使用说明（做题流程/答案分离/评分自检）+ EX01–EX32 全量索引表（标题/英文核心张力/难度/文件）+ 出题依据说明
`scenarios-retrieval-context.md`	EX01–EX08：RAG or long context ×2、more context or better retrieval、tool query vs RAG、fine-tuning or RAG、LitM 位置治理、agentic search、检索层权限
`scenarios-tools-mcp.md`	EX09–EX16：API or MCP ×2（集团平台/创业公司正反例）、Tool or Resource、Claude decides or application decides、automatic write or human approval、支付超时幂等对账、strict tool use、工具结果裁剪 vs code_execution
`scenarios-agents-orchestration.md`	EX17–EX24：Workflow or agent、Agent or deterministic code、Single or multi-agent ×2（正例/强耦合反例）、synchronous or asynchronous ×2、stopping conditions、parallelization
`scenarios-production-security.md`	EX25–EX32：larger model or smaller model ×2（路由/先修杠杆）、cache or not cache ×2（正例/反例）、哪层做权限 ×2（工具执行器强制/注入纵深防御）、529 退避降级、Batch API 成本

每题八要素完整（脚本校验：32/32 题均有 Scenario/Constraints/Options + Best choice/Why/Why other choices are weaker/Tradeoffs/What would change the answer）；题目三要素在前、答案五要素统一在各文件末尾「答案与解析」独立小节。
部分题目从各模块 questions 场景题提炼改写（场景/约束/选项全部重写，非复制），其余新创作；答案引用的官方论断均带 URL+2026-08-30（BEA、contextual-retrieval、errors、batch、prompt-caching、rate-limits、MCP spec 等，全部为仓库 sources 已 VERIFIED 的 URL）。
难度分布：★☆☆×6、★★☆×22、★★☆+★★★×4（★★★×4：EX08/EX14/EX30 等综合题）。

校验记录

三个 README 追加后章节编号连续、代码围栏配平（6/14/12 均为偶数）、表格结构完整。
三个 CSV 经 Python csv 模块逐行解析：列数全为 5，列头与原文件一致。
32 题编号 EX01–EX32 连续无缺漏无重复（题面+答案各 32 处标题）。
外部 URL 实测（本轮 web_fetch）：arXiv 2212.10496 ✅ 200、arXiv 2307.03172 ✅ 200、platform.claude.com/docs/en/build-with-claude/fine-tuning ❌ 404（未引用）。

待协调者验收点

07 README §8.4 的「数据库直查/微调」两列是本仓库综述口径（题头已声明）——若后续收录官方 fine-tuning 文档源，可把该两行升级为带官方来源的表述。
architecture-exercises/ 未加入顶层 README 仓库地图与 PROGRESS/STUDY_PLAN（超出本任务写入白名单）——建议协调者在 Wave 3 全仓链接检查时补挂。
新增 14 张闪卡使 flashcards 总量 +14；总仓「≥200 张」指标的合并计数请协调者在 GLOSSARY/flashcards 合并阶段更新。