用途：Dex 是给 AI 代理用的任务跟踪与协调工具，适合跨会话或多天的复杂工作、需要拆解为步骤的特性、需要保留决策与上下文、可能交接或回访的任务，以及执行前构建待办清单。快速单次会话任务或无上下文保留需求时可不用。
主要能力：任务持久化为仓库内 .dex/ 文件；三层层级（Epic → Task → Subtask，最大深度 3 级）；任务可设置阻塞关系；可记录结果与关联提交；支持从 markdown 计划生成任务；可选同步到 GitHub Issues 或 Shortcut Stories，并支持导入/导出。
使用方式：全局安装 npm install -g @zeeg/dex（或 pnpm add -g、bun add -g）。常用命令包括 dex（仪表板）、dex status、dex list、dex create、dex show、dex edit、dex start、dex complete、dex plan、dex sync、dex import、dex config、dex doctor。项目规划前先运行 dex dir，确认存储路径为 <repo>/.dex；若指向全局路径如 ~/.config/dex/local，应先初始化 git 仓库并创建 .dex/ 后重试。
限制：最大层级 3 级；删除父任务会删除所有子任务；子任务需先于父任务完成；阻塞任务仍可被完成（会有警告）；提交信息建议使用 GitHub issue 编号而非临时任务 ID。部分同步与配置细节需参考官方文档。