yatl
一个极简、基于文件、与Git深度集成的任务追踪工具。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:yatl。 它的用途是:一个极简、基于文件、与Git深度集成的任务追踪工具。 完整的 Skill 内容见:https://321skill.com/skills/yatl/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前项目中创建一个高优先级的Bug修复任务,标题是‘修复登录接口在高并发下的报错’。”,它会执行 `yatl new "修复登录接口在高并发下的报错" --priority high --tags bug,api` 并返回任务ID。接着你可以说:“开始处理这个任务”,AI会使用 `yatl start <任务ID>` 将其状态改为进行中,并在你后续提交代码时,提醒你将 `.tasks/` 目录一并提交。
介绍
yatl 解决了开发者在项目开发中,任务管理与代码版本控制分离、任务状态难以追踪和协作的问题。它是一个单二进制文件,通过在项目根目录创建 .tasks/ 文件夹来管理任务,每个任务都是一个带有YAML前言的Markdown文件,任务状态由文件所在目录(open, in-progress, blocked等)决定,而非文件内容,这使得任务可以像代码一样进行分支、合并和差异比较。
使用非常简单,通过 yatl init 初始化后,即可用 yatl new 创建任务,yatl start/stop/close 管理状态,yatl ready 查看可执行任务,所有操作都通过命令行完成。任务文件是纯文本,可直接编辑,也便于脚本和AI Agent读取处理。
它非常适合需要将任务与代码变更紧密关联的开发者、技术团队,尤其是那些已经在使用Git进行版本控制,并希望任务管理能无缝融入现有工作流的人群。对于全栈、后端、运维开发等角色,yatl能清晰记录开发上下文。
建议将 .tasks/ 目录纳入Git版本控制,这样任务记录会随代码提交历史一同保存。由于状态基于目录,移动任务文件需使用yatl命令,避免手动操作导致状态不一致。对于重度依赖图形化界面或复杂工作流的团队,yatl可能过于简单。
核心特点
核心区别在于其“Git原生”设计:任务状态由文件系统目录位置决定,使得任务能像代码文件一样进行分支、合并和差异比对,完美融入Git工作流。同时,它采用纯文本Markdown文件存储,兼顾了人类可读性与程序(AI Agent)可处理性。
注意事项
不适合需要复杂权限管理、精细时间跟踪、甘特图或强图形化界面支持的大型项目管理场景。
常见问题
yatl和Jira、Trello有什么区别?
yatl是极简、文件驱动的CLI工具,深度集成Git,适合开发者将任务作为代码的一部分管理,而非功能全面的项目管理平台。
任务文件可以手动编辑吗?
可以,任务文件是标准Markdown,YAML前言可编辑,但状态变更(如打开->进行中)应使用yatl命令,以确保文件被移动到正确目录。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/yatl/raw/index.md 读取 yatl 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/yatl/raw/index.md(查看排版版本)