Seeds：面向AI Agent工作流的Git原生问题追踪器

一个专为AI Agent工作流设计的轻量级问题追踪工具，采用Git原生存储、JSONL文件格式、零依赖架构，为AI驱动的开发 workflow 提供简洁高效的任务管理能力。

• 原作者/维护者：jayminwest
• 来源平台：github
• 原始标题：seeds
• 原始链接：https://github.com/jayminwest/seeds
• 来源发布时间/更新时间：2026-05-28T11:15:43Z

原作者与来源

• 原作者/维护者：jayminwest
• 来源平台：github
• 原始标题：seeds
• 原始链接：https://github.com/jayminwest/seeds
• 来源发布时间/更新时间：2026-05-28T11:15:43Z 原作者与来源\n\n- 原作者/维护者：jayminwest\n- 来源平台：github\n- 原始标题：seeds\n- 原始链接：https://github.com/jayminwest/seeds\n- 来源发布时间/更新时间：2026-05-28T11:15:43Z\n\n项目背景与定位\n\n在AI Agent日益成为开发工作流核心驱动力的今天，传统的问题追踪工具往往显得过于笨重。Jira、Linear等工具虽然功能强大，但对于AI Agent驱动的轻量级 workflow 来说，往往存在配置复杂、依赖过多、与代码仓库分离等问题。\n\nSeeds 正是为解决这一痛点而诞生的。它是一个Git原生的问题追踪器，专为AI Agent工作流设计。项目的核心理念简单而有力：JSONL文件就是数据库。没有Dolt、没有守护进程、没有二进制数据库文件，只有纯文本的JSONL文件，与代码一起存储在Git仓库中。\n\n核心设计理念\n\nGit原生架构\n\nSeeds最大的特色在于其Git原生设计。所有问题数据都存储在项目目录下的 .seeds/ 文件夹中，以JSONL格式保存。这意味着：\n\n- 版本控制：问题状态的变化与代码变更同步提交，实现完整的可追溯性\n- 分支隔离：不同分支可以有不同的问题状态，适合特性开发 workflow \n- 协作友好：通过Git的合并机制处理并发修改，无需额外的服务器组件\n- 离线可用：无需网络连接即可查看和修改问题\n\n零依赖哲学\n\n项目追求极致的轻量级体验。运行时仅依赖Bun（一个快速的JavaScript运行时），没有数据库服务器、没有复杂的配置、没有沉重的依赖树。这种设计使得Seeds可以在任何能运行Bun的环境中快速启动。\n\nJSONL存储格式\n\n选择JSONL（JSON Lines）而非传统的关系型数据库或SQLite，体现了项目对简单性的追求。JSONL格式具有以下优势：\n\n- 人类可读：纯文本格式，可以直接用编辑器打开查看\n- 易于解析：每行一个JSON对象，流式处理友好\n- Git友好：文本格式便于Git diff和合并\n- 扩展灵活：无需预定义schema，可以随时添加新字段\n\n功能特性详解\n\n问题生命周期管理\n\nSeeds提供了完整的问题生命周期管理功能：\n\n- 创建问题：支持指定标题、类型、优先级、描述、负责人等属性\n- 更新问题：可以修改任意字段，支持扩展字段的自定义\n- 关闭问题：支持批量关闭，可记录关闭原因\n- 问题查询：支持按状态、类型、负责人、标签、优先级等多维度筛选\n\n依赖关系管理\n\n对于复杂的工作流，Seeds提供了依赖关系管理能力：\n\n- 添加依赖：sd dep add <issue> <depends-on>\n- 移除依赖：sd dep remove <issue> <depends-on>\n- 查看依赖：sd dep list <issue>\n- 阻塞标记：sd block 和 sd unblock 命令用于标记和解除阻塞状态\n\nReady工作流\n\nsd ready 命令是Seeds的一个特色功能，它会列出所有"可开始"的问题——即状态为open且没有未解决阻塞项的问题。这个设计特别适合AI Agent驱动的 workflow ，Agent可以定期查询ready列表，自动认领并执行任务。\n\n计划与执行\n\nSeeds引入了"计划（Plan）"的概念，支持将大问题拆分为子任务：\n\n- 计划模板：预定义的计划模板库\n- 生成计划提示：为指定问题生成结构化的计划提示词\n- 提交计划：验证计划并生成子问题\n\n这种设计特别适合AI Agent的规划和执行模式——Agent可以先生成计划，然后逐个执行子任务。\n\n灵活的输出格式\n\nSeeds支持多种输出格式，适应不同的使用场景：\n\n- markdown：人类友好的富文本格式\n- compact：紧凑的单行格式\n- plain：纯文本格式\n- ids：仅输出ID，适合管道操作\n- json：结构化JSON，适合程序处理\n\n技术实现亮点\n\nBun运行时\n\nSeeds选择Bun作为运行时，这是一个由Jarred Sumner开发的高性能JavaScript运行时。相比Node.js，Bun具有更快的启动速度和更低的内存占用，非常适合命令行工具的场景。\n\nCLI设计\n\n命令行界面遵循Unix哲学，每个命令只做一件事，但通过管道和组合可以实现复杂的工作流。例如：\n\nbash\n查找所有bug并批量关闭\nsd list --label bug --format ids | xargs sd close\n\n查找高优先级且未阻塞的任务\nsd ready --priority 1 --format json\n\n\n扩展字段支持\n\nSeeds允许为问题添加任意扩展字段，这种设计提供了极大的灵活性。AI Agent可以利用扩展字段存储自定义元数据，如置信度评分、预估工时、关联的代码文件等。\n\n使用场景\n\nAI Agent工作流\n\nSeeds的设计目标之一就是服务AI Agent工作流。在这种场景下：\n\n1. 人类开发者创建高层级的Seed（问题）\n2. AI Agent查询ready列表，认领任务\n3. Agent生成执行计划，创建子Seeds\n4. Agent逐个完成子任务，更新状态\n5. 完成后提交Git，问题状态与代码变更一起记录\n\n个人项目管理\n\n对于个人开发者，Seeds提供了一个无需配置的问题追踪方案。无需注册账号、无需搭建服务器，只需在项目中运行 sd init 即可开始使用。\n\n小型团队协作\n\n对于小型团队，Seeds的Git原生特性使得协作变得简单。问题状态的变化通过Git同步，团队成员可以通过Pull Request审查问题变更，与代码审查 workflow 保持一致。\n\n生态系统定位\n\nSeeds是overstory/mulch生态系统的一部分，用于替代之前的beads项目。它与overstory（AI驱动的开发环境）和mulch（项目模板管理）形成互补，共同构成了一套面向AI原生开发的工具链。\n\n项目价值与启示\n\nSeeds的价值在于其对"简单性"的坚持。在工具日益复杂的今天，Seeds证明了对于许多场景来说，简单的文本文件和Git已经足够。这种设计哲学对于工具开发者具有重要启示：\n\n1. 拥抱Git的分布式特性：利用Git的版本控制能力，而非与之对抗\n2. 文本优于二进制：人类可读的格式更易于调试和维护\n3. 为AI Agent设计：考虑AI Agent的使用模式，提供机器友好的接口\n4. Unix哲学：小而美的工具，通过组合实现复杂功能\n\n总结\n\nSeeds是一个面向AI Agent工作流的轻量级问题追踪器，它通过Git原生架构、JSONL存储、零依赖设计，为开发者提供了一个简洁而强大的任务管理方案。对于追求简单性、希望问题追踪与代码仓库紧密集成的开发者来说，Seeds是一个值得关注的选择。随着AI Agent在开发 workflow 中扮演越来越重要的角色，Seeds的设计理念可能会启发更多面向AI原生开发的工具出现。