# td - AI 代理的任务管理 ## 概述 `td` 是一个极简 CLI，用于跨上下文窗口跟踪任务和维护代理内存。当您的 AI 会话结束时，“td”会捕获已完成的操作、剩余的操作以及做出的决策，因此下一个会话将从上一个会话结束的位置继续进行。 **核心功能：** 运行“td use”并获取下一步操作所需的一切 - 当前焦点、待审审查、未解决的问题、最近的决策。 ## 快速入门 ### 会话开始（每次） td 使用 --new-session # 自动轮换 + 查看当前状态输出告诉你： * 活跃的工作会议和最近的决定 * 哪些问题正在等待审核（您可以审核这些） * 最高优先级的未决问题 * 之前会议的最新交接 ### 单问题工作流程专注于一个问题的工作： td start # 开始工作 td log "OAuth 回调已实现" # 跟踪进度 td log --decision "Using JWT tokens" # 记录决策 td handoff --done "..." --remaining "..." # 捕获状态 td review # 提交审核 ### 多问题工作流程（推荐给代理）代理处理相关问题： td ws start "Authimplementation" # 开始工作会话 td ws tag td-a1b2 td-c3d4 # 关联问题（自动启动它们） td ws tag --no-start td-e5f6 # 关联但不启动 td ws log "Shared token storage" # 记录所有标记的问题 td ws handoff # 捕获状态，结束会话 ## 关键工作流程 ### 工作流程 1：开始新工作 # 1.检查要做什么 td 使用 # 查看当前状态 td next # 最高优先级的未解决问题 td 关键路径 # 什么可以解除大多数工作的阻碍 # 2.开始工作 td 开始 # 3. 开始记录 td log“开始实施” ### 工作流程 2：移交工作这对于代理到代理的切换至关重要： td 切换 \ --done“OAuth 流程，令牌存储”\ --remaining“刷新令牌轮换，错误处理”\ --decision“使用 JWT 进行无状态身份验证”\ --uncertain “令牌应该在密码更改后过期吗？” 按键： * `--done` \- 实际完成的内容（说实话） * `--remaining` \- 还剩下什么（具体） * `--decision` \- 为什么你选择方法 X * `--uncertain` \- 你不确定什么下一个会话将通过“td use”或“td context ”查看所有这些上下文。 ### 工作流程 3：审查代码 # 1. 查看可审查的问题 TD可审查 # 2.检查详细信息 td 显示 td 上下文 # 3. 批准或拒绝 td 批准 # 或者： td拒绝——原因“缺少错误处理” **重要提示：** 您无法批准您实施的工作。会话隔离强制执行此操作。 ### 工作流程 4：处理阻止程序 # 1. 记录拦截器 td log --blocker“正在等待后端团队的 API 规范” # 2. 做点别的事 td next # 获取另一个问题 td ws tag td-e5f6 # 添加到工作会话 # 3.稍后再回到被阻止的问题 td context td-a1b2 # 当拦截器解析时刷新上下文 ## 按类别划分的命令 ### 检查状态 * `td 用法` \- 当前状态、评论、后续步骤 * `td use -q` \- 紧凑视图（第一次读取后） * `td current` \- 你正在做什么 * `td ws current` \- 当前工作会话状态 * `td next` \- 最高优先级打开 * `td 关键路径` \- 是什么解除了大多数工作的阻碍 ### 解决问题 * `td start ` \- 开始工作 * `td unstart ` \- 恢复打开（撤消意外启动） * `td log "msg"` \- 跟踪进度 * `td log --decision "..."` \- 记录决策 * `td log --blocker "..."` \- 日志拦截器 * `td show ` \- 查看详细信息 * `td context ` \- 用于恢复的完整上下文 ### 交接 * `td handoff --done "..." --remaining "..."` \- 单期 * `td ws handoff` \- 多问题工作会话 ### 评论 * `td review ` \- 提交审核 * `td reviewable` \- 您可以审核的问题 * `tdapprove ` \- 批准（仅限不同会话） * `td 拒绝 --原因 "..."` \- 拒绝 ### 创建/管理问题 * `td create "title" --type feature --priority P1` \- 创建 * `td list` \- 列出所有 * `td list --status in_progress` \- 按状态过滤 * `td block ` \- 标记为已阻止 * `td 删除 ` \- 删除 ### 文件跟踪 * `td link ` \- 跟踪有问题的文件 * `td files ` \- 显示文件更改 ### 其他 * `td 监视器` \- 实时仪表板 * `td session --new "name"` \- 强制新会话 * `td undo` \- 撤消上一个操作有关完整命令列表，请参阅 [quick_reference.md]()。 ## 资源 ### [quick_reference.md]() 按任务类型组织的完整命令参考。 ### [ai_agent_workflows.md]() 常见AI代理场景的详细工作流程： * 单一问题焦点 * 多议题工作会议 * 处理拦截器 * 恢复工作 * 代码审查流程 * 给人工智能代理的提示 ## 问题生命周期打开 → 进行中 → 审核中 → 关闭 | | v | （拒绝）被阻止----------+ ## 关键原则 **会话隔离：** 每个终端/上下文都有一个唯一的会话 ID。实现代码的会话无法批准它。不同的会议必须审查。这会强制进行实际的切换并防止“适用于我的上下文”错误。 **结构化交接：**不要只说“这就是我所做的”——用已完成/剩余/决定/不确定来构建它，以便下一个代理有清晰的上下文。 **最小：** 做一件事。单一二进制 SQLite 本地存储 (`.todos/`)，无服务器，可与任何 AI 工具配合使用。 ## 对于人工智能代理始终以以下方式开始对话： td 用法 --new-session 这会自动轮换会话并为您提供当前状态。然后： 1. **单一焦点问题** → 使用单一问题工作流程 2. **多个相关问题** → 使用 `td ws start` 进行工作会话 3. **上下文结束之前** → 始终为“td handoff”或“td ws handoff” 4. **记录决策** → 使用 `--decision` 标志来解释推理 5. **记录不确定性** → 使用 `--uncertain` 标志来标记未知数 6. **跟踪文件** → 使用“td link”，以便将来的会议知道发生了什么变化有关详细示例，请参阅 [ai_agent_workflows.md]()。

Td任务管理

包含技能