| 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 来源
只列出内容本身留下的未解问题,而非作者好奇心。例如:
- 文档提到的"待定"项
- 内容内部矛盾或缺失数据
- 没有给出依据的论断