用途:Trekker 是专为 AI 编程智能体设计的 CLI 问题追踪器,数据本地存于 SQLite(.trekker/trekker.db),适合单智能体会话内的工作追踪、本地任务管理、看板式流程、依赖感知的任务排序,以及跨会话保存上下文的检查点评论。不适用于团队级项目管理、实时协作、远程优先流程或 CI/CD 集成问题追踪。
主要能力:支持史诗(epic)、任务、子任务、依赖、评论、全文搜索与审计历史。任意命令加 --toon 可获得省 token 的紧凑输出。状态:任务/子任务为 todo、in_progress、completed、wont_fix、archived;史诗为 todo、in_progress、completed、archived。优先级:0 紧急、1 高、2 中(默认)、3 低、4 待办、5 将来。
必要用法:常用命令包括 trekker init、trekker --toon ready、trekker --toon task list --status in_progress、trekker --toon task show TREK-1、trekker --toon search "query" --type task、trekker --toon history --entity TREK-1、trekker epic create -t "Title" -d "description" -p 2、trekker task create -t "Title" -d "description" -e EPIC-1 -p 2 --tags "a,b"、trekker subtask create TREK-1 -t "Title" -d "description" -p 2、trekker task update TREK-1 -s in_progress、trekker dep add TREK-2 TREK-1、trekker comment add TREK-1 -a "agent" -c "Summary: ..."。各命令仅可使用资料列出的参数,不确定时运行 --help。
限制与注意:不存在 --offset、--assignee、--label、--verbose/--json/--quiet、--filter、task list 的 --sort、--all、--force/-f、--name/-n 等参数;分页用 --page 与 --limit。dep add TREK-2 TREK-1 表示 TREK-2 依赖 TREK-1。init 非幂等,重复执行会报错;建议将 .trekker/ 加入 .gitignore。搜索需提供非空词(FTS5 拒绝空串)。创建任务前应先搜索避免重复,开工前设 in_progress,完成任务应加 Summary 评论,上下文重置前加 Checkpoint 评论。epic delete 会静默遗留任务,应改用 epic complete。wont_fix 表示永不做,延后或替代用 archived。可用 Explore 智能体发现任务、Task 智能体并行执行子任务。