# Seeds：面向AI Agent工作流的Git原生问题追踪器 > 一个专为AI Agent工作流设计的轻量级问题追踪工具，采用Git原生存储、JSONL文件格式、零依赖架构，为AI驱动的开发 workflow 提供简洁高效的任务管理能力。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-05-28T11:15:43.000Z - 最近活动: 2026-05-28T11:23:50.503Z - 热度: 116.9 - 关键词: Git原生, 问题追踪, AI Agent, 工作流, Bun, JSONL, CLI工具, 任务管理, 开源工具 - 页面链接: https://www.zingnex.cn/forum/thread/seeds-ai-agentgit - Canonical: https://www.zingnex.cn/forum/thread/seeds-ai-agentgit - Markdown 来源: ingested_event --- ## 原作者与来源 - 原作者/维护者：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\n**Seeds** 正是为解决这一痛点而诞生的。它是一个Git原生的问题追踪器，专为AI Agent工作流设计。项目的核心理念简单而有力：**JSONL文件就是数据库**。没有Dolt、没有守护进程、没有二进制数据库文件，只有纯文本的JSONL文件，与代码一起存储在Git仓库中。\n\n## 核心设计理念\n\n### Git原生架构\n\nSeeds最大的特色在于其Git原生设计。所有问题数据都存储在项目目录下的 `.seeds/` 文件夹中，以JSONL格式保存。这意味着：\n\n- **版本控制**：问题状态的变化与代码变更同步提交，实现完整的可追溯性\n- **分支隔离**：不同分支可以有不同的问题状态，适合特性开发 workflow \n- **协作友好**：通过Git的合并机制处理并发修改，无需额外的服务器组件\n- **离线可用**：无需网络连接即可查看和修改问题\n\n### 零依赖哲学\n\n项目追求极致的轻量级体验。运行时仅依赖Bun（一个快速的JavaScript运行时），没有数据库服务器、没有复杂的配置、没有沉重的依赖树。这种设计使得Seeds可以在任何能运行Bun的环境中快速启动。\n\n### JSONL存储格式\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 `\n- **移除依赖**：`sd dep remove `\n- **查看依赖**：`sd dep list `\n- **阻塞标记**：`sd block` 和 `sd unblock` 命令用于标记和解除阻塞状态\n\n### Ready工作流\n\n`sd 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\n### Bun运行时\n\nSeeds选择Bun作为运行时，这是一个由Jarred Sumner开发的高性能JavaScript运行时。相比Node.js，Bun具有更快的启动速度和更低的内存占用，非常适合命令行工具的场景。\n\n### CLI设计\n\n命令行界面遵循Unix哲学，每个命令只做一件事，但通过管道和组合可以实现复杂的工作流。例如：\n\n```bash\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\n### AI 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原生开发的工具出现。