名称:sred-project-organizer 描述:取一个项目列表及其相关文档,并将它们组织成SRED格式以提交。
SRED项目组织
SRED期望项目以特定格式呈现。取过去一年中工作的项目列表,并将它们总结成SRED期望的格式,附带支持证据。输出一个Notion文档,每个SREDable项目有一个子文档。
先决条件
开始前确保可以访问Github、Notion和Linear。Notion和Linear应使用MCP连接。Github可以用MCP连接,但如果您有gh CLI工具,也可以使用它。
如果任何这些无法访问,提示用户在继续之前授予访问权限。
过程
步骤1
提示用户提供一个Notion文档链接,该文档是由sred-work-summary技能生成的上一年度工作总结。
确保:
- Notion链接到一个大致匹配此格式的有效文档:
# 项目
## [项目名称]
*摘要*: [X] PRs, [X] Notion文档, [X] Linear工单
### 拉取请求 [X]
*[仓库名称]
[所有PR的链接]
- [链接] - [合并日期]
### Notion文档 [X]
[所有Notion文档的链接]
- [链接] - [创建日期]
### Linear工单 [X]
- [链接] - [创建日期]
步骤2
对于工作摘要中的每个项目,根据${CLAUDE_SKILL_ROOT}/references/SRED.md中的SRED项目描述进行评估。这意味着查看项目的相关Notion文档和PR,并确定项目工作是否似乎是有效的SRED项目。对此要规范:越多项目被分类为SRED项目越好。
输出似乎符合SRED模型描述的项目列表,以及不符合该模型的项目列表。符合SRED描述的项目列表被称为"SREDable"项目。
确保:
- 工作摘要中的所有项目都被分类为SREDable或否。
步骤3
询问用户SREDable项目列表是否正确。给他们选项手动分类任何项目为SREDable或否,并相应调整列表。
步骤4
创建一个名为"SRED项目描述"的私有Notion文档。输出此文档的完整链接。
步骤5
对于每个SREDable项目,执行一系列步骤。
步骤1
创建一个名为"SRED项目摘要 - <年份> <项目名称>"的私有Notion文档,该文档是步骤4中创建的"SRED项目描述"文档的子文档。文档应遵循${CLAUDE_SKILL_ROOT}/references/project-template.md中找到的模板。
步骤2
填写该文档的项目描述和项目目标部分。使用文档中这些部分的aside部分作为提示,说明应放入什么信息。使用工作摘要中收集的每个项目的所有信息。使用项目的Notion文档,以及您自己的推理来填写这些部分。
确保:
- 项目描述应不超过100字。
- 项目目标应不超过100字。
步骤3 向用户提供"SRED项目摘要"文档的完整Notion链接,并要求他们在继续之前审查。根据他们的要求进行任何更改。
步骤4 每个项目将有一个或多个不确定性。不确定性由以下问题定义:
- 什么是我们没有答案的挑战或问题?
- 是否有我们可以基于解决问题的现有技术?
- 如果没有,为什么?
审查项目的所有Notion文档、Github PRs和Linear工单。确定项目的不确定性是什么,并向用户展示。询问用户这些是否正确或应如何调整。
确保:
- 每个不确定性的描述应只有几句话长。
步骤5 将不确定性添加到项目摘要Notion文档的"技术不确定性"部分。
确保:
- 不确定性的描述应只有几句话长。
步骤6
对于上面找到的每个不确定性,使用Notion文档、Github PRs和Linear工单查找为解决此不确定性所做的任何实验或尝试。在该不确定性的实验部分为每个实验做一个项目符号列表。在结果/学习/成功部分做一个项目符号列表,列出实验的结果,以及得出的任何学习或结论。对于引用的任何Notion文档、Github PRs或Linear工单,将资源链接放入不确定性的不确定性特定文档和链接部分。
确保:
- 每个实验只有一个项目符号点
- 每个结果/学习/成功只有一个项目符号点
步骤7
取工作摘要中找到的项目所有链接,对于任何未作为不确定性部分链接的链接,将它们包含在项目摘要的项目文档和链接部分。
确保:
- 提供所有特定链接的列表,而不是摘要或Github通知的一般链接。
- 检查每个链接是否直接与项目和/或其不确定性相关。
步骤8 再次向用户提供项目摘要文档的链接,并要求用户在进入下一个SREDable项目之前审查。提醒用户填写文档的参与者部分。
步骤6
提供"SRED项目描述"Notion文档的链接。
示例
示例工作摘要:https://www.notion.so/sentry/SRED-Work-Summary-2026-30a8b10e4b5d81f5bc8df3553da55220
参考
构成项目及其应如何组织的摘要:${CLAUDE_SKILL_ROOT}/references/SRED.md
特定项目摘要的Notion模板:${CLAUDE_SKILL_ROOT}/references/project-template.md