用途
该技能面向需要清晰沟通复杂技术思想的场景，帮助撰写技术分析、系统架构文档、决策记录（ADR）和研究综合报告。核心目标是通过结构化分析与基于证据的推理，让读者（包括新成员）能够跟随论证并理解结论。
主要能力
文档类型模板
架构决策记录（ADR） 模板包含：标题（ADR-{NNN}: {Decision Title}）、状态（Proposed | Accepted | Deprecated | Superseded by ADR-{NNN}）、日期、决策者、Context（动机与作用力）、Decision（提议或决定的变更）、Consequences（正面收益、负面权衡、中性观察）、Alternatives Considered（备选方案的优缺点及被拒原因）。
系统分析文档 模板包含：Executive Summary（2-3 句说明是什么、为什么、建议）、Current State（现状与证据）、Problem Statement（具体可度量的问题）、Analysis（基于证据的调查）、Recommendations（按优先级排序并附工作量估计）、Appendix（原始数据、详细指标、补充证据）。
技术 RFC 模板包含：标题、作者、状态（Draft | Review | Accepted | Rejected）、创建日期、评审截止日期、Summary（一段话说明提议）、Motivation（为何需要，附具体示例）、Detailed Design（如何工作，附图表与代码示例）、Drawbacks（诚实评估缺点）、Alternatives（考虑过的其他方案及本方案胜出原因）、Unresolved Questions（待讨论的开放项）。
写作原则
论证结构：每个分析段落遵循 Claim（主张）— Evidence（数据、指标、代码示例）— Reasoning（证据为何支持主张）— Implication（若成立则意味着什么）。
证据层级（从强到弱）：生产指标（如“迁移后 P99 延迟增加 3 倍”）> 可复现测试（如“基准测试显示 40ms 对 120ms”）> 代码分析（如“此模式产生 N+1 查询”）> 专家意见（如“团队认为这能扩展”）> 类比（如“Netflix 这么做”）。
金字塔原理：先给结论再支撑。反例：先讲分析数据库、缓存层、API，最后才说缓存命中率仅 23% 导致响应慢。正例：先说缓存命中率 23% 导致响应慢，再解释数据库查询层生成缓存键不一致导致不必要未命中，标准化键生成可将命中率提升至约 85%。
结构模式
问题—方案—证据：Problem（具体可度量的问题）、Solution（提议的变更）、Evidence（为何该方案能解决问题）、Effort（T 恤尺码 + 关键依赖）。
对比表：按性能、复杂度、团队熟悉度、维护成本等标准对选项 A/B/C 打分并给出推荐。
风险矩阵：列出风险、可能性、影响、缓解措施（如 API 限流、数据迁移失败、团队带宽）。
风格准则
清晰性：使用主动语态（“调度器触发任务”而非“任务被调度器触发”）；具体名词（“API 返回 429 状态”而非“API 有问题”）；具体数字（“P99 延迟为 230ms”而非“延迟很高”）。
简洁性：先讲要点而非铺垫；每段一个观点；将“In order to”改为“To”；删除“It is important to note that”直接陈述；删除“As mentioned previously”。
技术准确性：核实所有指标与测量；包含测量方法；区分观察与解释；为外部主张引用来源；为所有数据标注日期（如“截至 2026 年 3 月”）。
图表
按场景选择图表类型：系统组件用架构图（方框 + 箭头）；流程用流程图或时序图；数据关系用 ER 图；时间线用甘特图或时间线；层级用树状图；对比用表格而非图表。支持 Mermaid 内联图，例如：
graph LR
A[Client] --> B[API Gateway]
B --> C[Auth Service]
B --> D[Skills Service]
D --> E[(Database)]
评审清单
执行摘要自包含（读者无需继续阅读即可获得要点）；每个主张都有支撑证据；备选方案公平呈现（非稻草人）；诚实承认风险与权衡；细节程度适合受众；图表有图例与标签；所有缩写首次使用时定义；陌生人测试：新团队成员能跟上论证。
反模式
埋没要点（应结论先行、证据在后）；诉诸权威（“Google 这么做”不是论据，需解释为何有效）；虚假精确（无测量方法却称“性能提升 47.3%”）；缺少备选方案（应至少比较 2-3 个选项）；范围蔓延（聚焦既定问题，将离题内容标记为单独文档）；无有效期（所有分析应包含“截至”日期与重新审视的条件）。
使用方式
资料未提供具体安装命令或调用方式，暂未提供。
适用场景
适用于撰写架构决策记录、系统分析文档、技术 RFC、研究综合报告，以及需要结构化论证与证据支撑的技术沟通场景。
限制
资料未提供关于收费、价格、平台支持范围或效果保证的信息，暂未提供。