关于
获取项目列表及相关文档，并将其组织为 SR&ED 格式以供提交。
name: sred-project-organizer description: 获取项目列表及其相关文档，并将其整理为 SRED 格式以供提交。 risk: unknown source: community
SRED 项目整理
SRED 要求项目以特定格式呈现。获取过去一年中完成的项目列表，并将其总结为 SRED 期望的格式，附带支持证据。输出一个 Notion 文档，每个符合 SRED 条件的项目有一个子文档。
何时使用
- 你需要将上一年度的工作总结转换为 SRED 格式的项目文档。
- 任务涉及将项目分类为符合 SRED 条件、收集证据并在 Notion 中组织输出。
- 你已经拥有或准备生成此整理工具所依赖的上游工作总结。
前提条件
开始之前，确保可以访问 Github、Notion 和 Linear。Notion 和 Linear 应通过 MCP 连接。Github 可以通过 MCP 连接，但如果你有 gh CLI 工具的访问权限，也可以使用它。
如果其中任何一个无法访问，请提示用户在继续之前授予访问权限。
流程
步骤 1
提示用户提供一个 Notion 文档链接，该文档是由 sred-work-summary 技能生成的上一年度工作总结。
确保：
- 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
对于工作总结中的每个项目，根据 ${CLAUDE_SKILL_ROOT}/references/SRED.md 中 SRED 项目的描述进行评估。这意味着查看项目的相关 Notion 文档和 PR，并确定该项目工作是否看起来像一个有效的 SRED 项目。对此要宽松判断：能被归类为 SRED 项目的越多越好。
输出看起来符合 SRED 模型描述的项目列表，以及不符合该模型的项目列表。符合 SRED 描述的项目列表被称为"符合 SRED 条件"的项目。
确保：
- 工作总结中的所有项目都已被分类为符合或不符合 SRED 条件。
步骤 3
询问用户符合 SRED 条件的项目列表是否正确。给他们手动将任何项目分类为符合或不符合 SRED 条件的选项，并相应调整列表。
步骤 4
创建一个名为"SRED Project Descriptions"的私有 Notion 文档。输出此文档的完整链接。
步骤 5
对于每个符合 SRED 条件的项目，执行以下一系列步骤。
步骤 1
创建一个名为"SRED Project Summary - <年份> <项目名称>"的私有 Notion 文档，作为步骤 4 中创建的"SRED Project Description"文档的子文档。该文档应遵循 ${CLAUDE_SKILL_ROOT}/references/project-template.md 中的模板。
步骤 2
填写该文档的项目描述和项目目标部分。使用文档中这些部分的 aside 区域作为每个部分应包含什么信息的提示。使用工作总结中为每个项目收集的所有信息。使用项目的 Notion 文档以及你自己的推理来填写这些部分。
确保：
- 项目描述不超过 100 字。
- 项目目标不超过 100 字。
步骤 3 向用户提供该项目"SRED Project Summary"文档的完整 Notion 链接，并要求他们在继续之前进行审查。根据他们的要求进行任何更改。
步骤 4 每个项目将有一个或多个不确定性。不确定性由以下问题定义：
- 我们没有答案的挑战或问题是什么？
- 是否有我们可以用来作为解决问题基础的现有技术？
- 如果没有，为什么？
审查项目的所有 Notion 文档、Github PR 和 Linear 工单。确定项目的不确定性并展示给用户。询问用户这些是否正确或是否需要以某种方式调整。
确保：
- 每个不确定性的描述应只有几句话。
步骤 5 将不确定性添加到项目总结 Notion 文档的"技术不确定性"部分。
确保：
- 不确定性的描述应只有几句话。
步骤 6
对于上面发现的每个不确定性，使用 Notion 文档、Github PR 和 Linear 工单查找为解决此不确定性而进行的任何实验或尝试。在该不确定性的实验部分为每个实验制作一个项目符号列表。在结果/学习/成功部分制作一个项目符号列表，列出实验结果以及得出的任何学习或结论。对于任何 Notion 文档、Github PR 或 Linear 工单