name: sred-work-summary
description: Go back through the previous year of work and create a Notion doc that groups relevant links into projects that can then be documented as SRED projects.
risk: critical
source: community
SRED 工作总结
收集一个人在给定年份完成的所有 Github PR、Notion 文档和 Linear 工单。将所有这些中的链接分组到项目中。将所有内容放入一个私有 Notion 文档中,并返回该文档的链接。
使用时机
- 你需要将一年的 PR、Notion 文档和 Linear 工单收集到项目分组中,为 SRED 做准备。
- 任务是在编写各个 SRED 项目描述之前构建上游 Notion 工作总结。
- 你需要一个可重复的收集工作流,在固定的时间窗口内跨 GitHub、Notion 和 Linear 工作。
前置条件
开始之前,确保可以访问 Github、Notion 和 Linear。Notion 和 Linear 应使用 MCP 连接。Github 可以使用 MCP 连接,但如果你有权访问ghCLI 工具,也可以使用它。
如果其中任何一项无法访问,请在继续之前提示用户授予访问权限。
流程
步骤 1
# 获取当前年份date+%Y此命令的输出是当前年份。
当前年份减一是上一年。
步骤 2
从用户那里收集所有所需信息:
Github 用户名:用户的 github 用户名是什么?
Github 仓库:应搜索哪些 Github 仓库中的 PR?
用户可以指定逗号分隔的列表,或提供包含仓库的目录。在第二种情况下,在指定目录中使用此命令:
# 查找 github 仓库find.-maxdepth2-name".git"-typed|sed's/\/.git$//'|sort确保:
- 列出的所有仓库都在
getsentryGithub 组织中。
此输出此后称为"用户仓库"。
事件:询问用户是否要包含事件文档。
答案要么是是,要么是否。如果答案是否,将排除某些文档以后的搜索。
其他用户:询问是否有任何其他用户可能创建了 Notion 文档。
这应该是逗号分隔的名称列表。记住这些为"其他用户"。
步骤 3
创建一个名为"SRED Work Summary [current year]"的私有 Notion 文档。此文档将称为工作总结。
如果已存在同名文档,通知用户重命名现有文档并停止执行。
确保:
- 如果工作总结已存在,停止执行。
步骤 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 工单都有链接
- 不要截断链接列表。不要使用"…and 75 more"之类的缩写。确保所有 Github PR、Notion 文档和 Linear 工单的完整集合在文档中可见。
步骤 6
运用你自己的智能,将工作总结文档中的所有 Github、Notion 和 Linear 工单链接分组到项目中。此文档的格式如下所示。
# Projects ## [Project Name] *Summary*: [X] PRs, [X] Notion docs, [X] Linear tickets ### Pull Requests [X] *[repository name] [Links to all the PRs] - [link] - [Merge date] ### Notion Docs [X] [Links to all the Notion docs] - [link] - [Creation date] ### Linear Tickets [X] - [link] - [Creation date]对于 Github PR,使用 PR 的标题和 PR 的描述进行分组。
对于 Notion 文档,使用完整文档进行分组。
对于 Linear 工单,使用工单的标题和工单的描述。
确保:
- 文件中的所有链接都分配给了一个项目。
- 文件遵循上述指定格式。
- 不要截断链接列表。不要使用"…and 75 more"之类的缩写。确保所有 Github PR、Notion 文档和 Linear 工单的完整集合在文档中可见。
步骤 7
搜索"其他用户"创建的 notion 文档。将与工作总结中项目相关的任何文档,将那些 Notion 文档的链接添加到工作总结中的适当项目中。
步骤 8
向用户返回工作总结 Notion 文档的链接。
确保:
- 最终输出中包含实际的 Notion 文档链接。
资源
这是 2025 年的示例工作总结文档:https://www.notion.so/sentry/Work-Summary-Feb-2025-Jan-2026-3068b10e4b5d81d3a40cfa6ad3fe1078?source=copy_link
限制
- 仅当任务明确匹配上述范围时使用本技能。
- 不要将输出视为针对特定环境验证、测试或专家审查的替代品。
- 如果缺少所需输入、权限、安全边界或成功标准,请停下来并要求澄清。