bt
一个极简、基于文件的Git原生任务追踪器。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bt。 它的用途是:一个极简、基于文件的Git原生任务追踪器。 完整的 Skill 内容见:https://321skill.com/skills/bt/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前项目中创建一个高优先级的Bug修复任务,标题是‘修复登录接口在高并发下的性能问题’,并打上 `bug` 和 `performance` 标签。”,AI会执行 `yatl new "修复登录接口在高并发下的性能问题" --priority high --tags bug,performance` 来创建任务。或者,你可以让AI“列出所有已就绪、可以开始处理的任务”,AI会运行 `yatl ready` 并返回结果。
介绍
yatl 是一个专为开发者设计的极简任务追踪工具,它将任务直接存储为项目仓库中的Markdown文件。它解决了传统任务管理工具与开发流程割裂的问题,让任务管理像代码一样可追踪、可合并。
使用上,你只需在项目根目录运行 yatl init 初始化,之后便可通过 yatl new 创建任务、yatl start 开始工作、yatl close 关闭任务。所有任务文件都存放在 .tasks/ 目录下,其状态(待处理、进行中、已阻塞等)由文件所在的子目录决定,清晰直观。
它非常适合与代码仓库深度绑定的开发团队、独立开发者,以及希望任务历史能随代码分支一起留存和追溯的项目。对于习惯使用命令行和Git,并希望任务管理无缝集成到现有工作流中的人来说,yatl是一个理想选择。
建议将 .tasks/ 目录纳入版本控制,这样任务变更就能随代码提交一同记录。同时,由于其文件结构简单,也便于AI助手或自动化脚本直接读取和操作任务数据,实现自动化的工作流。
核心特点
核心区别在于其“Git原生”和“文件驱动”的设计:任务状态完全由文件在 `.tasks/` 下的目录位置决定,而非文件内的元数据,这使得任务状态变更在Git中清晰可见,且依赖关系能自动触发状态流转(如被阻塞任务在依赖解决后自动重开)。
注意事项
不适合需要复杂权限管理、看板视图或强实时协作的非技术团队使用。
常见问题
yatl 和 Jira、Trello 有什么区别?
yatl 是极简、文件驱动的CLI工具,深度集成Git,适合开发者将任务作为代码的一部分管理,而非功能全面的团队协作平台。
任务文件可以手动编辑吗?
可以,任务文件是标准的Markdown加YAML头信息,你可以直接用文本编辑器修改,yatl 会读取更新后的内容。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bt/raw/index.md 读取 bt 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bt/raw/index.md(查看排版版本)