Dex Task Tracking

核心用法

dex 是一款面向异步/多步骤工作的 CLI 任务追踪工具。它将任务以独立 JSON 文件形式存储于 .dex/tasks/ 目录，天然支持 Git 版本控制与多人协作。

创建工作流：dex create 生成任务，需填写描述与完整上下文（背景、需求、方案、完成标准）。追踪与更新：dex list 支持树形视图与 JSON 输出，dex show 可查看详情。完成归档：dex complete 强制记录结果，确保知识留存。层级管理：支持 --parent 创建子任务，适配复杂项目拆解。

显著优点

1. Git-native 设计：单文件单任务，零合并冲突，历史可追溯
2. 零依赖轻量：纯 CLI，无需数据库或服务端
3. 上下文强制：创建时必须输入完整背景，降低交接信息损耗
4. 结果归档：完成时需填写结果，形成闭环文档

潜在局限

• 无实时同步机制，依赖 Git 协作
• 缺乏可视化看板，纯终端交互
• 无内置提醒/通知，需主动检查
• 任务量大了之后 list 可读性下降

适合人群

• 频繁使用 OpenCode/Claude Code 等编码代理的开发者
• 需要跨多次会话追踪工作的独立开发者或小团队
• 偏好 Git 工作流、抗拒重型项目管理工具的技术团队

常规风险

• 任务 JSON 若含敏感信息（IP、密钥）需确保 .dex/ 在 .gitignore 中或仓库私有
• 长期任务可能因分支切换导致上下文丢失，需定期 show 回顾
• 多人协作时任务 ID 冲突概率低但存在，建议配合分支策略

核心用法

Dex 是一款专为异步/多步骤工作设计的任务追踪工具，采用纯文档型 Skill 形式提供 CLI 使用指南。核心工作流围绕创建-追踪-完成三阶段展开：

• 创建任务：dex create -d "描述" --context "完整上下文" —— 记录工作背景、需求、方案及完成标准
• 查看状态：dex list 树形展示待办，dex show <id> 查看详情
• 标记完成：dex complete <id> --result "执行结果" —— 沉淀决策、权衡与后续跟进
• 子任务支持：通过 --parent 参数构建层级任务结构，协调并行工作流

典型场景包括：向 OpenCode/Claude Code 派发编码任务（记录 workspace、分支、会话 ID）、PR 审查追踪、后台作业监控等。任务以 JSON 格式存储于 .dex/tasks/ 目录，单文件单任务设计天然支持 Git 版本控制，避免冲突。

显著优点

1. 极简本地优先：零外部依赖、零网络调用，数据完全本地掌控，符合隐私合规要求
2. Git 友好：JSON 文件存储天然支持版本追踪、diff 审查与协作同步
3. 上下文沉淀：强制要求记录"done-when"标准与完成结果，形成可检索的知识资产
4. Agent 工作流适配：专门为 AI 编码助手场景设计，支持 workspace/branch/session 元数据追踪
5. 层级结构：父子任务关系支持复杂项目拆解与并行协调

局限性与潜在缺点

• 无内置 CLI 工具：Skill 仅为使用说明文档，实际 dex 命令需用户自行安装对应工具
• T3 来源可信度：当前为个人开发者/社区项目，无公开仓库背书，长期维护存疑
• 功能边界清晰：专注于任务追踪，不涉及自动化执行、通知提醒或看板可视化
• 许可证未声明：当前版本未明确开源许可，商业使用需谨慎

适合人群

• 高频使用 Claude Code/OpenCode 等 AI 编码工具的开发者
• 需要跨会话维护上下文记忆的 AI 辅助工作流用户
• 偏好本地优先、Git 版本化任务管理的极简主义者
• 多项目并行、需要显式协调异步工作流的团队

常规风险

| 风险维度 | 评估 | 说明 |

|---------|------|------|

| 数据安全 | 🟢 极低 | 纯本地存储，无云端同步，数据泄露风险可控 |

| 可用性风险 | 🟡 中 | 依赖外部 `dex` CLI 工具的持续维护 |

| 合规风险 | 🟢 极低 | 无敏感数据收集，GDPR 友好 |

| 供应商锁定 | 🟢 低 | JSON 开放格式，易于迁移至其他系统 |

总体建议：作为工作流文档与规范参考极具价值，建议配套确认 dex CLI 工具的实际可用性与维护状态后再深度投入生产使用。