name: sred-work-summary description: 回顾上一年的工作,并创建一个Notion文档,将相关链接分组到项目中,以便作为SRED项目进行文档化。
SRED工作摘要
收集一个人在给定年份内完成的所有Github PR、Notion文档和Linear工单。将所有链接分组到项目中。将所有内容放入一个私有的Notion文档,并返回该文档的链接。
前提条件
在开始之前,确保可以访问Github、Notion和Linear。Notion和Linear应使用MCP连接。Github可以使用MCP连接,但如果您有访问gh CLI工具的权限,可以使用它代替。
如果任何这些无法访问,请提示用户在继续之前授予访问权限。
流程
步骤1
# 获取当前年份
date +%Y
此命令的输出是当前年份。 当前年份减去一是上一年。
步骤2
从用户收集所有所需信息:
Github用户名:用户的github用户名是什么?
Github仓库:应搜索哪些Github仓库的PR?
用户可以指定一个逗号分隔的列表,或提供一个包含仓库的目录。在第二种情况下,在指定目录中使用此命令:
# 查找github仓库
find . -maxdepth 2 -name ".git" -type d | sed 's/\/.git$//' | sort
确保:
- 所有列出的仓库都在
getsentryGithub组织中。
此输出后文称为“用户仓库”。
事件:询问用户是否要包括事件文档。
答案要么是是或否。如果答案是否,将在后续搜索中排除某些文档。
其他用户:询问是否有任何其他用户可能创建了Notion文档。
这应该是一个逗号分隔的名字列表。记住这个作为“其他用户”。
步骤3
创建一个私有的Notion文档,标题为“SRED Work Summary [当前年份]”。此文档将被称为工作摘要。
如果已经存在同名的文档,请通知用户重命名现有文档并停止执行。
确保:
- 如果工作摘要已存在,停止执行。
步骤4
时间窗口是上一年的2月1日到当前年的1月31日。
查找在时间窗口内由给定github用户名在用户仓库中创建的所有Github PR。
如果用户不想包括事件文档,忽略标题或描述中包含INC-X、inc-X的任何Github PR。
使用Github MCP或gh命令执行此操作。
查找用户在时间窗口内创建的所有Notion文档。
如果用户不想包括事件文档,忽略标题中包含INC-XXXX的任何Notion文档。
使用Notion MCP执行此操作。
查找在时间窗口内分配给用户的所有Linear工单。
如果用户不想包括事件文档,忽略标题中包含INC-XXXX的任何Linear工单。
使用Linear MCP执行此操作。
确保:
- 所有Github PR在时间窗口内创建或合并,并且由用户打开。
- 所有Notion文档在时间窗口内创建,并且由用户创建。
- 所有Linear工单在时间窗口内打开或完成,并且在完成时分配给用户。
步骤5
对于步骤4中找到的每个Github PR、Notion文档和Linear工单,将链接放入步骤3创建的私有文档中。
确保:
- 工作摘要中为所有Github PR提供链接
- 工作摘要中为所有Notion文档提供链接
- 工作摘要中为所有Linear工单提供链接
- 不要截断链接列表。不要使用像“…还有75个更多”这样的缩写。确保所有Github PR、Notion文档和Linear工单的完整集合在文档中可见。
步骤6
使用您自己的智能将工作摘要文档中的所有Github、Notion和Linear工单链接分组到项目中。文档的格式如下所示。
# 项目
## [项目名称]
*摘要*:[X] PRs, [X] Notion docs, [X] Linear tickets
### 拉取请求 [X]
*[仓库名称]
[所有PR的链接]
- [链接] - [合并日期]
### Notion文档 [X]
[所有Notion文档的链接]
- [链接] - [创建日期]
### Linear工单 [X]
- [链接] - [创建日期]
对于Github PR,使用PR的标题和描述进行分组。 对于Notion文档,使用整个文档进行分组。 对于Linear工单,使用工单的标题和描述。
确保:
- 文件中的所有链接都分配到一个项目。
- 文件遵循上述指定格式。
- 不要截断链接列表。不要使用像“…还有75个更多”这样的缩写。确保所有Github PR、Notion文档和Linear工单的完整集合在文档中可见。
步骤7
搜索由“其他用户”创建的Notion文档。将与工作摘要中的项目相关的任何文档添加链接到工作摘要中的相应项目。
步骤8
返回工作摘要Notion文档的链接给用户。
确保:
- 最终的输出中包含实际的Notion文档链接。
资源
这是一个2025年工作摘要文档的示例:https://www.notion.so/sentry/Work-Summary-Feb-2025-Jan-2026-3068b10e4b5d81d3a40cfa6ad3fe1078?source=copy_link