模块 10架构决策与技术领导

Golden Path

从开发者关键旅程设计路径

创建 Agent 与本地调试
接入模型、Tool、Context 和身份
添加 Trace、Eval、策略和审批
发布、灰度、运营和事故处置
迁移、升级和退役

默认路径由可组合能力组成

参考架构和最小服务骨架
SDK/CLI 与标准协议
受治理的模型、Tool 和 Skill 目录
Eval/Release Pipeline 与 SLO 模板
安全、数据和成本默认值

好的默认值降低决策负担

最小权限、敏感日志关闭和预算上限
标准错误、Trace 与事件 Schema
开发/测试/生产环境隔离
默认可运行但明确标注需要业务填写的部分

路径要解释机制与边界

Quickstart 服务首次成功
How-to 解决具体任务
Reference 定义契约
Concept/Decision Guide 解释 Why 与 Why Not
故障排查连接 Trace 和 Runbook

例外是产品信号，不是治理失败

明确哪些底线不可绕过
其他例外记录原因、Owner 和支持边界
高频逃逸提示平台抽象错误或能力缺失
私叉需要升级、漏洞和退出责任

度量真实采用和开发体验

Time to First Production Run
成功率、门禁通过时间和支持工单
采用/逃逸/放弃路径及原因
平台升级覆盖率和迁移成本

Golden Path 按证据迭代

与代表性团队共创而非闭门设计
小范围试点和版本化发布
兼容窗口、自动迁移和废弃通知
删除不再提供价值的默认复杂度