name: project-retrospective description: 生成LESSONS.md回顾文件，捕获机构知识，特别是失败教训。适用于关闭新闻项目、调查、事件或出版物时。包括研究项目、事件后分析、编辑工具和出版物的模板。

项目回顾撰写器

创建LESSONS.md文件，捕获机构知识，特别是失败教训。像记者报道自己的项目一样思考——要具体、诚实，指出实际错误。

何时使用

完成调查或项目后
关闭或暂停出版物时
事件后分析
将项目移交给他人时
对持续计划的年度回顾

关键部分：“真正的问题”

这是回顾中最有价值的部分。它回答：

“我们以为自己在构建什么 vs. 实际需要什么？”

好例子：

当用户只需要全文搜索时，我们构建了一个全面的标签系统。三周时间花在没人使用的功能上。

坏例子（太笼统）：

我们学会了用户研究的重要性。

模板结构

# LESSONS.md

## 项目
- **名称：** [项目名称]
- **日期：** [开始 - 结束]
- **状态：** [已完成 / 已放弃 / 进行中]
- **作者：** [您的姓名]

## 摘要
[一段话：做了什么，有什么影响，为什么重要]

## 成功之处

### 技术成功
- [具体决策及其成功原因]
- [节省时间的工具/模式]

### 流程成功
- [有帮助的方法论]
- [有效的沟通模式]

## 失败之处

### 关键失败
- [阻碍进展的具体事物 - 要具体]
- [错误假设及其代价]

### 技术债
- [后来造成伤害的捷径]
- [不需要的复杂性]

### 外部因素
- [超出控制影响项目的事物]

## 真正的问题
[这是最重要的部分]

我们以为： [初始假设]
实际需要： [现实]
差距成本： [浪费的时间/努力/金钱]

## 建议

### 如果继续此项目
1. [第一优先级]
2. [第二优先级]
3. [第三优先级]

### 如果重新开始
- [要做的不同之处]
- [要完全跳过的部分]

### 技术栈判断
- **保留：** [运行良好的工具]
- **替换：** [造成问题的工具]
- **添加：** [希望拥有的工具]

## 可重用组件

| 组件 | 为什么有价值 |
|-----------|------------------|
| [名称] | [具体重用潜力] |
| [名称] | [为什么别人应该使用] |

## 下次的问题
- [值得调查的未解答问题]
- [开始前要研究的事物]

语调指南

诚实、具体、略带自嘲
像向朋友解释为什么项目花了两倍时间
无企业用语或推卸责任
指出具体错误，而非模糊“挑战”

包含 vs 排除内容

包含	排除
有背景的具体失败	模糊“学习”
错误的时间/成本实际数据	对个人的指责
有帮助或有害的工具	通用最佳实践
你会撤销的决定	显而易见的陈述
意外发现	其他文档中的信息

具体性测试

对于“失败之处”中的每个项目，问：

我能指出具体决定吗？
我能量化影响吗？
这会帮助别人避免相同错误吗？

如果任何为否 → 更具体。

好 vs 坏条目示例

坏 - 太笼统：

沟通可以更好

我们低估了复杂性

测试不足

好 - 具体且可操作：

跳过数据文件的模式验证。成本：3小时调试导致静默失败的拼写错误。

当浏览器原生输入可行时构建自定义日期选择器。浪费2天。

数据加载失败时无错误消息——用户只看到空白屏幕。

“真正的问题”示例

弱：

我们学会要求会变化。

强：

当编辑实际需要Slack机器人时，我们为编辑构建了管理仪表板。他们生活在Slack中——强迫他们打开Web应用是他们永远不会接受的摩擦。仪表板有2个月活跃用户；我们一天内构建的Slack机器人原型有47个。

写作中的红旗

如果发现自己写这些，停止并更具体：

“沟通是关键”
“我们学会…的重要性”
“今后，我们应该…”
“挑战包括…”
“有一些问题…”

这些是真实洞察的占位符。替换它们。

新闻特定模板

模板位于 templates/ 目录：

模板	用于
`research-project.md`	调查、数据新闻项目
`event.md`	会议、研讨会、活动
`publication.md`	新闻通讯、播客、持续内容
`editorial-tool.md`	新闻编辑室软件、AI工具

模板选择

哪种项目？
├── 调查/分析 → research-project.md
├── 会议/研讨会 → event.md
├── 新闻通讯/播客 → publication.md
└── 新闻编辑室工具 → editorial-tool.md

最好的回顾是由那些受过伤并想拯救他人免受同样命运的人写的。