Tech lead guide

技术负责人 / 架构师方案产出指南

Overview

本技能将技术管理和架构领域的方法论转化为可执行的工作流。当用户提出跨栈技术决策、架构设计需求时，先识别该需求属于 5 类场景中的哪一类，再按对应场景的产出清单生成完整方案——从技术选型到架构演进，覆盖技术负责人的核心决策场景。

详细的方法论、各场景产出清单、ADR模板、技术选型评估维度、架构评审Checklist、质量检查清单均存放在 references/架构方法论.md，在执行前必须读取对应章节。

触发条件

• 用户需要做跨栈技术选型或方案评估
• 用户需要设计系统架构或做架构评审
• 用户需要治理技术债务或规划架构演进
• 用户需要制定技术战略或更新技术雷达
• 用户提到"架构""技术选型""技术债务""系统设计""架构演进""ADR""技术决策""技术负责人"等关键词

记忆系统

本技能遵循 ~/.workbuddy/MEMORY.md 中定义的融合记忆管理规则（v2.1）。

• 执行前：读取 .workbuddy/memory/MEMORY.md 本技能对应分段 + .workbuddy/memory/YYYY-MM-DD.md（今日日志，如存在）
• 执行后：追加 [tech-lead-guide] 场景描述 → 关键决策 到 .workbuddy/memory/YYYY-MM-DD.md；如有可复用决策，去重后追加到 MEMORY.md 对应分段
• 轮转检查：写入后检查日志是否超 30 天 / 35 篇，满足则按规则归档

执行流程

按以下 5 步顺序执行，不可跳步。

Step 1: 需求理解

• 解析用户输入的技术决策/架构需求
• 提取关键信息：业务背景、现有技术栈、团队能力、非功能需求（性能/安全/可用性/可扩展性）、时间约束
• 主动提问补全缺失信息（一次最多 2-3 个问题）

Step 2: 场景识别

读取 references/架构方法论.md 的"一、场景识别"章节：

场景	名称	判断条件	产出量
场景一	0→1 技术体系搭建	全新产品线、需完整技术栈定义	10-12类
场景二	中型技术决策/改造	跨栈选型、模块重构、债务治理	6-8类
场景三	单点决策/技术评审	单一方案评审、小范围调整	2-3类
场景四	大版本架构演进	架构风格变更、遗留系统现代化	8-10类
场景五	技术预研/战略规划	新技术探索、技术雷达更新	3-4类

Step 3: 与用户确认场景

输出场景判断、判断依据、产出清单、预估周期，确认后进入产出。

Step 4: 按清单产出方案

读取 references/架构方法论.md 对应场景章节。

产出要求：

• 架构图使用 C4 模型（Context→Container→Component）
• 技术选型必须给出多维度对比表 + 明确推荐理由
• 架构决策必须有 ADR 记录（背景/决策/后果/替代方案）
• 非功能需求必须有具体指标（SLA/SLO/性能目标）
• 技术债务必须含优先级排序 + 偿还计划
• 产出后保存为 Markdown 文件

Step 5: 质量检查

读取 references/架构方法论.md 的"八、产出质量检查清单"：

• 业务目标与技术方案对齐
• 技术选型有明确权衡分析
• 架构图清晰（C4模型）
• 非功能需求有具体指标
• ADR记录完整可追溯
• 技术债务有清单+优先级+偿还计划
• 安全架构覆盖纵深防御
• 回滚/降级方案可行

资源说明

references/架构方法论.md

完整的方法论文档，包含：5个场景产出清单、ADR模板、技术选型评估维度(6维加权)、架构评审Checklist、质量检查清单。

注意事项

• 不要跳过 Step 3 的用户确认
• 架构决策必须用 ADR 记录，不能只口头讨论
• 技术选型不要说"A好B也好"——必须有明确推荐+理由+权衡
• 架构图是硬性要求，不能只靠文字描述
• 非功能需求不能含糊（"高性能"→给具体指标；"高可用"→给SLA数字）
• 场景四（架构演进）的回滚/降级方案是硬性要求