track-capstone 状态(M13 + ARCHITECTURE_CHEATSHEET,Wave 2)
模块 13 — ✅ 完成
ARCHITECTURE_CHEATSHEET — ✅ 完成(占位文件替换为正式版)
- 产出文件(10 项,全部落盘):
13-capstone-project/README.md — 项目规格:Helios Assist 场景(客服+内部知识库,含工具/MCP/检索/人审)、需求 R1–R10、约束 C1–C8、验收标准、模块 01–12 映射表
13-capstone-project/decision-workbook.md — 15 个决策点(D01–D15:模型选择/提示与上下文/RAG vs 大上下文/工具设计/MCP vs 直接 API/agent vs workflow/权限与审批/人审/安全/评估/日志审计/成本/可靠性/部署/故障处理),每点:背景/选项表(≥3)/学习者填写区/<details> 折叠参考答案/模块回链;文末附 15×回链总表
13-capstone-project/reference-architecture.md — 3 张 Mermaid 图(数据面 flowchart / 控制面 flowchart / 退款流程 sequenceDiagram,含失败与升级 alt 分支)+ 逐层职责表(含负面清单)+ 失败/降级路径总表 + 三条不变式
13-capstone-project/bad-vs-better.md — 完整对照案例(坏:全塞上下文+prompt 禁令当安全+admin token+无评估+白屏;好:分源检索+应用层强制+审批门+三层评估+降级链),逐点「为什么」+ 总结自查表
13-capstone-project/rubric.md — 5 维度(架构 25%/安全 20%/评估 20%/成本 15%/可靠性 20%)× 4 级水平描述;安全/评估 0 分=上线否决项;打分表模板 + 常见失分模式
ARCHITECTURE_CHEATSHEET.md(仓库根目录,替换 Phase 5 占位文件)— 8 节一页速查:workflow vs agent / MCP vs direct API / RAG vs 大上下文 / 何时人审 / 缓存与 batch / 权限放应用层 / 失败处理选择树(ASCII)/ 成本-延迟-可靠性三角
13-capstone-project/examples/capstone_skeleton.py — 无 key 架构骨架模拟(网关/路由/检索 pre-filter/MockClaude 剧本+故障注入/工具层+策略引擎/审批门/升级队列/预算重试+降级链/受控 agent 步数上限),5 场景带断言自检
flashcards/flashcards-13.csv — 23 张(≥15 要求),跨模块综合决策类,csv 模块解析校验通过(5 列无坏行)
glossary/glossary-13-capstone.md — 新文件,18 条 Capstone 级术语(参考架构/数据面控制面/deflection/审批门/爆炸半径/降级链/熔断器/错误预算/SLO/发布门/灰度/数据飞轮/ADR 等;已对照 core/production/foundations 术语表去重)
sources/sources-13-capstone.csv — 新文件,CAP01–CAP16 全部 VERIFIED
- 示例实跑结果:
python3 capstone_skeleton.py → exit=0,断言 PASS(S1 L1 FAQ→ok;S2 退款 $480→策略 P12 命中→审批门 APPROVE→resolved_approved;S3 API 连续 5xx/超时→退避重试→预算耗尽→模板降级→escalated;S4 坐席 REJECT→escalated 接管;S5 L3 agent 3 步收敛 AGENT_STOP)。43 条追踪事件、升级队列 2 条;预检正确丢弃作废政策块(policy-refunds-v1)
- 来源核验:本 run(2026-08-30)web_fetch 逐一访问 CAP01–CAP16 共 16 个 URL,全部 HTTP 200;内容与模块 01–12 口径一致(BEA 页首编者注、四档模型价目、缓存倍率、MCP 2026-07-28 规范等)。两个旧路径 404 已记录:
reduce-prompt-injection(用 mitigate-jailbreaks 替代)、eval-overview(用 develop-tests 替代)——若其他模块仍引用旧路径,Wave 3 链接检查时需统一
- 写入范围自查:仅本任务 10 项(13-capstone-project/ 5 文件 + examples 1 + 根目录 CHEATSHEET 1 + flashcards/glossary/sources 各 1 + 本文件);未运行 git;未触碰其他 track 文件。掩码坑自查:全部产出 grep 确认无
*** 残留(bad-vs-better.md 起草时出现 1 处已修复)、无密钥赋值行、无 ${VAR} 占位符
- 待协调者验收:
- Mermaid 3 图(reference-architecture.md)请用渲染器目检一遍(flowchart 中 subgraph 嵌套与
& 并联边在部分渲染器兼容性不同)
- 工作簿/速查表中模型名与价目均为「截至 2026-08-30」,与模块 02/10 同源;Wave 3 合并时如遇 02 的口径更新请同步本模块
- 决策点对模块 12(评估与可观测性)的引用按 CURRICULUM_PLAN 目录名
12-evaluation-observability 预留(该模块由 production track 收尾中,本模块只做文字引用未放死链)
- CHEATSHEET 第⑦节为 ASCII 选择树(一页式排版考虑);若 Wave 3 想统一 Mermaid 化可再议
- flashcards-13 的 certification_domain 沿用仓库现有非官方学习分桶(Agents & Orchestration / RAG & Retrieval / Security & Compliance / Evaluation / Cost Optimization / Reliability & Error Handling / Production Deployment / Tool Design & Integration),与 14-prep 的官方域映射在 Wave 3 统一
- 遗留问题:无。Capstone 未建 labs/、questions/ 目录——按 CURRICULUM_PLAN 的模块交付清单模板本模块交付物以任务简报的 10 项为准(决策工作簿即 labs 的等价物、rubric+验收测试即 questions 的等价物);如协调者认为仍需补 labs/questions 可再派工,工作量小
📚 目录