关于 sred-project-organizer
此 Skill 根据 SRED 标准评估年度工作总结中的项目,并在 Notion 中创建附有证据的项目说明。流程涵盖项目分类、技术不确定性、实验和资料记录。
主要功能
- 01按 SRED 标准分类项目
- 02创建 Notion 主文档和项目子页
- 03起草项目说明与目标
- 04记录不确定性、实验和结果
- 05添加支持证据链接
适用场景
- 01将年度工作总结整理为 SRED 项目记录
- 02记录技术不确定性与实验工作
- 03与用户共同审核项目分类
MCP 相关
通过 MCP 连接使用 Notion 和 Linear;GitHub 可通过 MCP 或 `gh` 命令行访问。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ getsentry/ skills --skill sred-project-organizer安装后在 Claude Code 中输入/sred-project-organizer确认已加载。
附带文件references/project-template.mdreferences/SRED.md
详细介绍
SRED 项目整理
SRED 要求项目采用特定格式呈现。请整理过去一年开展过的项目,并按照 SRED 要求的格式进行总结,同时提供佐证材料。输出一份 Notion 文档,并为每个符合 SRED 要求的项目创建一个子文档。
前置条件
开始前,请确保可以访问 Github、Notion 和 Linear。Notion 和 Linear 应通过 MCP 连接。Github 可以通过 MCP 连接;如果你有权使用 gh CLI 工具,也可以改用它。
如果无法访问其中任何一项,请先提示用户授予访问权限,再继续操作。
流程
第 1 步
请用户提供一份 Notion 文档的链接。该文档是由 sred-work-summary skill 生成的上一年度工作总结。
确保:
- Notion 链接指向有效文档,且大致符合以下格式:
# 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]
第 2 步
对于工作总结中的每个项目,请根据 references/SRED.md 中对 SRED 项目的描述进行评估。这意味着要查看该项目相关的 Notion 文档和 PR,并判断项目工作是否符合 SRED 项目的要求。请尽量作出积极判断:可归类为 SRED 项目的项目越多越好。
输出符合 SRED 项目标准的项目列表,以及不符合该标准的项目列表。符合 SRED 描述的项目称为“SREDable”项目。
确保:
- 工作总结中的所有项目都已归类为 SREDable 或非 SREDable。
第 3 步
询问用户 SREDable 项目列表是否正确。让用户可以手动将任何项目归类为 SREDable 或非 SREDable,并据此调整列表。
第 4 步
创建一份名为“SRED Project Descriptions”的私有 Notion 文档。输出该文档的完整链接。
步骤 5
对于每个符合 SRED 要求的项目,请按以下步骤操作。
步骤 1
创建一个私有 Notion 文档,命名为 “SRED Project Summary - ”,并将其设为步骤 4 中创建的 “SRED Project Description” 文档的子文档。该文档应遵循 references/project-template.md 中的模板。
步骤 2
填写该文档中的 Project Description 和 Project Goals 部分。根据文档这两部分中的 aside 区块提示,确定每个部分应填写哪些信息。使用 Work Summary 中收集的每个项目的所有信息。结合项目的 Notion 文档以及你自己的推理填写这些部分。
确保:
- 项目描述不得超过 100 个单词。
- 项目目标不得超过 100 个单词。
步骤 3 向用户提供该项目 “SRED Project Summary” 文档的完整 Notion 链接,并请用户在继续之前进行审核。根据用户提出的要求进行修改。
步骤 4 每个项目都有一个或多个不确定性。不确定性由以下问题定义:
- 我们遇到了什么挑战或问题,但尚无答案?
- 是否存在可用于作为问题解决依据的先例?
- 如果没有,为什么?
查看该项目的所有 Notion 文档、Github PR 和 Linear 工单。确定该项目存在哪些不确定性,并向用户展示。询问用户这些内容是否正确,或是否需要调整。
确保:
- 每项不确定性的描述应只有几句话。
步骤 5 将这些不确定性添加到 Project Summary Notion 文档的 “Technical Uncertainties” 部分。
确保:
- 不确定性的描述应只有几句话。
步骤 6
对于上述发现的每项不确定性,使用 Notion 文档、Github PR 和 Linear 工单,查找为解决该不确定性而进行的实验或尝试。在该不确定性的 Experiments 部分中,为每项实验列出一个项目符号。在 Results / Learnings / Success 部分中,以项目符号列出实验结果,以及由此得出的经验或结论。对于引用的任何 Notion 文档、Github PR 或 Linear 工单,将对应资源的链接放入该不确定性的 Uncertainty-Specific Documentation & Links 部分。
确保:
- 每项实验只列出一个项目符号。
- 每项结果/经验/成功只列出一个项目符号。
步骤 7
获取 Work Summary 中该项目的所有链接;对于未作为某项不确定性的一部分链接的内容,将其加入 Project Summary 的 Project Documentation & Links 部分。
确保:
- 列出所有具体链接,不要提供摘要,也不要只提供指向 Github 通知的通用链接。
- 检查每个链接是否与该项目和/或其不确定性直接相关。
步骤 8 再次向用户提供 Project Summary 文档的链接,并请用户在继续处理下一个符合 SRED 要求的项目之前进行审核。提醒用户填写文档的 Participants 部分。
步骤 6
提供 “SRED Project Descriptions” Notion 文档的链接。
示例
Work Summary 示例:https://www.notion.so/sentry/SRED-Work-Summary-2026-30a8b10e4b5d81f5bc8df3553da55220
参考资料
项目的定义及其组织方式概述:references/SRED.md
特定项目摘要的 Notion 模板:references/project-template.md