技能介绍

解决的问题

在方案选型与架构设计阶段，工程师常遇到的不是“没有方案”，而是方案太多、上下文太少：同一需求，有人推荐事件驱动，有人坚持模块化单体；评审时又缺少可追溯的依据，只剩一句“之前踩过坑”。时间一长，团队经验散落在聊天记录、wiki、代码评审和口口相传里，新人很难快速知道在类似约束下做过什么选择、为什么这么做、后来效果如何。

技能如何工作

这个技能把方案选择和架构模式经验沉淀成可检索的资料库，核心数据来自两个位置：

references/experiences.md：经验条目列表，承载方案决策、模式选择、适用场景、关键取舍和实践结果。
references/index.md：经验索引，按关键词检索，便于面对新问题时快速定位相关条目。

使用时，它不替代工程师决策，而是把“相似约束下的历史选择”拉回视线。比如评估微服务拆分、缓存策略、异步流程或数据一致性方案时，可以先通过索引检索关键词，再回到经验条目查看当时的约束、方案边界和踩过的坑。讨论重点便从“哪个名词更时髦”转向“哪个约束更接近当前问题”。

适用边界与注意点

它适合作为团队技术记忆的补充层，而不是自动架构师。经验条目只说明过去在特定上下文中成立，不能直接复制到新业务规模、新SLA、新合规要求或新技术栈上，仍需结合实际代码、压测、可观测性数据和演进成本判断。经验库的价值也取决于维护质量：条目若缺少约束条件、决策理由或结果反馈，检索到的内容会很快失真。建议与 ADR、代码评审记录和运行指标一起使用，而不是当成唯一依据。