learn-from-trial

name	learn-from-trial
description	Review the current conversation's trial-and-error process and produce a structured lessons-learned summary: key steps, root causes of each failure, fixes applied, and concrete code examples — written so that even a junior engineer could succeed on the first attempt next time.
metadata	{"short-description":"Summarize trial-and-error lessons with concrete examples"}

learn-from-trial — 从试错中提炼经验

触发时机

当用户完成了一个经过多次失败才成功的任务后，调用此 skill 生成一份经验总结。

用户可能这样触发：

• /learn-from-trial
• "总结一下这次的经验"
• "把这次踩的坑整理出来"

输出目标

生成一份自包含的经验文档，要求：

• 即使是初级工程师，读完后能首次就成功完成相同任务
• 每条经验都附带具体的代码或命令示例
• 重点在"为什么会出错"和"怎么判断/修复"，而不是流水账

---

执行步骤

1. 梳理完整试错链

回顾对话中的每次尝试，按顺序列出：

尝试 v1 → 失败原因 → 修复 → 尝试 v2 → 失败原因 → 修复 → ... → 成功

对每次失败，明确：

• 表象：报了什么错？exit code 是多少？日志里哪行是关键？
• 根因：为什么会这样？是环境差异、配置错误、还是假设错误？
• 修复：改了什么？为什么这样改能解决？

2. 提炼经验技巧

将上面的分析归纳为若干条独立的、可复用的技巧，每条包含：

• 标题：一句话说清楚这条技巧的核心
• 背景：什么情况下会遇到这个问题（不要只说"我们遇到了"，要说"当 X 时会发生 Y"）
• 诊断方法：如何发现这个问题（给出具体命令/代码）
• 修复方法：如何解决（给出具体命令/代码）
• 验证方法：如何确认修复生效

3. 给出"首次成功模板"

在文末提供一个最终可工作的配置/命令模板，标注每个关键参数的作用和常见错误值。

---

输出格式

用中文写作，结构如下：

## 从零到成功：[任务名称] 全流程总结

### 试错路径
（简要时间线，每次尝试一行）

### 经验技巧

#### 1. [技巧标题]
**适用场景**：...
**诊断**：
\```bash
# 具体命令
\```
**修复**：
\```yaml/bash/python
# 具体代码
\```
**验证**：...

#### 2. [技巧标题]
...

### 最终成功模板
（带注释的完整可工作配置）

---

写作原则

• 具体 > 抽象：说"在 apt update 前加 rm -f /etc/apt/sources.list.d/deadsnakes*.list"，不要说"清理无效 apt 源"
• 因果 > 现象：说"因为 cpudev 节点没有 IPv6 出口，apt 尝试连接 PPA 的 IPv6 地址失败"，不要说"apt update 报错了"
• 比较 > 绝对：如果老配置能工作、新配置不能，直接对比两者的差异（infiniband: true vs infiniband: false）
• 初级友好：假设读者不了解这个系统，每个术语第一次出现时简单解释
• 排序：把"最容易踩且最难发现"的坑放在前面