summary-patterns

name	summary-patterns
description	Layout pattern library for summary-type artifacts. Provides rules for TL;DR writing, key finding importance grading, and source credibility scoring.

Summary Patterns

总结型内容的布局模式库。

TL;DR 写作规则

• 必须包含：谁、做了什么、结果/意义
• 句数随 complexity：simple=3、medium=4-5、complex=5-6
• 不使用"本文认为"等学术腔
• 第一句给结论，其余句补背景、机制或后果

反面案例

"本文从多个维度详细讨论了 Kubernetes 的网络模型……"

正面案例

Kubernetes 的 Pod 默认使用 CNI 网络插件分配 IP；每个 Pod 拿到一个集群内可路由的 IP，而非端口映射。这意味着多容器共享网络命名空间，但容器间仍需注意端口冲突。

关键发现的重要性评级

• high：直接影响决策或行动
• medium：背景理解有帮助
• low：细节或补充说明

按重要性降序排列。high 用强调色徽章，medium 用中性色，low 用淡灰色。

来源可信度评估维度

官方文档 > 技术博客（知名作者）> 社区讨论 > 未知来源

评分输出

• ★★★ — 官方/规范/源码
• ★★ — 一线工程师博客、白皮书
• ★ — 论坛、Stack Overflow 高分回答
• ⚠ — 无明确来源或匿名讨论

Action Items 写作规则

• 每项以动词开头（"补充"、"验证"、"协调"）
• 标注优先级 P0/P1/P2 与（若已知）负责人
• 不写"研究一下"这类无法验证完成的项

Open Questions 来源

只列出内容本身留下的未解问题，而非作者好奇心。例如：

• 文档提到的"待定"项
• 内容内部矛盾或缺失数据
• 没有给出依据的论断