用途:该技能面向技术设计文档写作,适用于新功能设计、系统架构、重大技术决策、跨团队提案、技术选型与 API 契约等场景,对应技术设计文档(TDD)、RFC、架构决策记录(ADR)、C4 模型图、技术选型矩阵、OpenAPI/AsyncAPI 规范等文档类型。
主要能力与硬性规则:每份设计文档必须包含至少 2 个备选方案并说明取舍;系统设计必须包含架构图(C4 Context/Container、时序图或数据流图,可用 Mermaid 或 PlantUML C4);必须定义可度量的成功指标(如延迟、可用性、错误率、吞吐量);必须列出风险与缓解措施。文档结构涵盖前置信息、问题陈述、方案、备选方案、风险评估、实施计划与开放问题。
使用方式:按文档类型选用模板(如 templates/design-doc-template.md、templates/adr-template.md、reference/tech-selection.md),文档与代码同库版本管理,建议目录为 docs/architecture/ADRs、docs/design、docs/rfcs。评审流程为作者撰写、异步评审 2-3 天、30-45 分钟宣读会、修订并取得技术负责人签署;上线后 1 个月复查更新。
限制与注意:避免事后补写文档、过度细节、瀑布式完美设计、文档过期、缺少备选方案与成功标准。资料未提供具体安装命令、收费方式与平台支持信息。