AI News HubLIVE
站内改写2 分钟阅读

Show HN:Git Issues —— 面向AI代理的版本化任务管理

Git Issues 是一个基于Git的轻量级问题追踪器,将问题存储为仓库中的Markdown文件,与代码一起进行版本控制。它无需数据库或服务器,支持分支感知、离线编辑、AI代理工作流和双向关系等特性,为开发者和AI代理提供无缝的任务管理体验。

来源Hacker News AI作者: steviee

Git Issues 是一个创新的问题追踪系统,它将问题管理直接集成到Git仓库中,以Markdown文件的形式存储问题,并与代码一起进行版本控制。这种设计确保了问题状态始终与代码同步,无需额外的数据库或服务器基础设施。该工具由Steviee开发,使用Go语言编写,安装极其简单:只需运行 go install github.com/steviee/git-issues@latest 即可获得一个独立的二进制文件。初始化时,通过 issues init 命令在仓库根目录创建 .issues/ 文件夹,所有问题文件都保存在此,与 src/ 等代码目录并列,实现了真正的“代码即问题”理念。

Git Issues 的核心优势在于其与Git深度集成的版本控制能力。当开发者切换分支时,对应分支的问题列表也会自动切换,这意味着每个功能分支都可以拥有独立的问题集合,极大支持了并行开发。同时,工具完全兼容 git bisect,在历史提交中能够精确呈现当时的问题状态,这为回归调试提供了有力支持。此外,git log .issues/ 可以清晰展示问题文件的变更历史,确保所有修改都有迹可循。

由于采用纯文本的Markdown格式,Git Issues 突破了传统问题追踪工具的局限。用户可以在任何编辑器中编辑问题文件,包括Vim、VS Code甚至GitHub在线界面,无需担心API速率限制或服务器宕机。离线环境同样适用,例如在飞机或高铁上也可以正常编辑。这种无锁定设计意味着用户可以随时迁移,只需保留Markdown文件即可。

针对AI代理,Git Issues 提供了专门的工作流:issues next 获取下一个未阻塞且优先级最高的问题,issues claim 标记为进行中,issues done 关闭问题并自动执行 git add 暂存。同时,仓库中的 .agent.md 文件为AI代理提供了完整的上下文信息,包括数据模式和推荐流程。工具还支持双向关系(如 blocksdepends-onrelated-toduplicates),关联问题的状态会自动同步。

其他实用功能包括基于Bubble Tea的交互式看板(issues board 命令)、多种输出格式(表格、JSON、ID列表)以及自动暂存机制——每次问题修改都会自动执行 git add,确保问题状态随代码提交一起移动。总的来说,Git Issues 为开发者和AI代理提供了一套高效、轻量且版本控制友好的问题管理方案,特别适合那些希望减少基础设施依赖、追求离线可用性和AI集成能力的团队。