AI 代理待办管理 xby-skill/xby-todolist

xby-todolist

DeepSeek Harness (DSH) 的插件：AI代理任务管理服务

为大型语言模型和AI代理提供外部工作记忆和任务管理功能，支持复杂多步骤任务的可靠执行。

功能

- set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
- todo_read — 使用此工具读取当前会话的待办事项列表。应主动且频繁地使用此工具，以确保你了解当前任务列表的状态。你应尽可能多地使用此工具，尤其是在以下情况下：
- 在对话开始时查看有哪些待处理事项
- 在开始新任务之前对工作进行优先级排序
- 当用户询问之前的任务或计划时
- 每当你对下一步该做什么不确定时
- 完成任务后，更新你对剩余工作的了解
- 每隔几条消息后，确保你仍在正轨上

用法：
- 此工具不接受任何参数。因此请将输入留空或为空。不要包含虚拟对象、占位字符串或诸如 "input" 或 "empty" 之类的键。将其留空。
- 返回待办事项列表，包含其状态、优先级和内容
- 使用此信息跟踪进度并规划后续步骤
- 如果尚不存在任何待办事项，将返回一个空列表
- todo_write — 使用此工具为当前编码会话创建和管理结构化任务列表。这有助于你跟踪进度、组织复杂任务，并向用户展示你的周全性。
它还有助于用户了解任务的进度及其请求的整体进展。

何时使用此工具在以下场景中主动使用此工具：

1. 复杂的多步骤任务 - 当任务需要 3 个或更多不同步骤或操作时
2. 非平凡且复杂的任务 - 需要仔细规划或多次操作的任务
3. 用户明确要求待办事项列表 - 当用户直接要求你使用待办事项列表时
4. 用户提供多个任务 - 当用户提供一系列待办事项时（编号或逗号分隔）
5. 收到新指令后 - 立即将用户需求记录为待办事项
6. 当你开始处理任务时 - 在开始工作之前将其标记为 in_progress。理想情况下，你一次只应有一个待办事项处于 in_progress 状态
7. 完成任务后 - 将其标记为 completed，并添加在实现过程中发现的任何新的后续任务

何时不使用此工具

在以下情况下跳过使用此工具：
1. 只有一个简单直接的任务
2. 任务微不足道，跟踪它不会带来任何组织上的好处
3. 任务可以在少于 3 个简单步骤内完成
4. 任务纯粹是对话性或信息性的

请注意，如果只有一个微不足道的任务要做，你不应使用此工具。在这种情况下，你最好直接执行该任务。

任务状态和管理

1. 任务状态：使用这些状态来跟踪进度：
- pending：任务尚未开始
- in_progress：当前正在处理（一次限制为一个任务）
- completed：任务已成功完成

2. 任务管理：
- 在工作过程中实时更新任务状态
- 任务完成后立即标记为已完成（不要批量标记完成）
- 任何时候只能有一个任务处于 in_progress 状态
- 在开始新任务之前先完成当前任务
- 将不再相关的任务从列表中彻底移除

3. 任务完成要求：
- 只有在完全完成任务后才将其标记为已完成
- 如果遇到错误、阻塞或无法完成，请将任务保持为 in_progress
- 当被阻塞时，创建一个新任务来描述需要解决的内容
- 在以下情况下切勿将任务标记为已完成：
- 测试失败
- 实现不完整
- 你遇到了未解决的错误
- 你找不到必要的文件或依赖项

4. 任务拆分：
- 创建具体、可执行的条目
- 将复杂任务拆分为更小、可管理的步骤
- 使用清晰、描述性的任务名称

如有疑问，请使用此工具。主动进行任务管理体现了你的用心，并确保你成功完成所有要求。

参数： todos：更新后的待办事项列表。每个待办事项必须包含：
- content：任务描述（字符串，至少 1 个字符）
- id：唯一任务标识符（字符串）
- priority：优先级（"high"、"medium"、"low"）
- status：任务状态（"pending"、"in_progress"、"completed"）

返回值：成功消息，或当所有任务完成时自动清除通知

安装

方式一：从 GitHub 直接安装（推荐）

格式: dsh plugin --profile add github:/
dsh plugin --profile web add github:xby_skill/xby-todolist

方式二：从本地目录安装（开发模式）

仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-todolist

方式三：通过 cordis.patch.yml 开发调试

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

配置

获取 API 密钥

前往 小笨羊官网 注册并获取 API 密钥。