Руководства

Списки задач

Отслеживайте и отображайте задачи с помощью Claude Agent SDK для организованного управления задачами

Отслеживание задач предоставляет структурированный способ управления задачами и отображения прогресса пользователям. Claude Agent SDK включает встроенную функциональность задач, которая помогает организовать сложные рабочие процессы и держать пользователей в курсе прогресса выполнения задач.

Жизненный цикл задач

Задачи следуют предсказуемому жизненному циклу:

Создаются как pending, когда задачи идентифицированы
Активируются в in_progress, когда начинается работа
Завершаются, когда задача успешно завершается
Удаляются, когда все задачи в группе завершены

Когда используются задачи

SDK автоматически создает задачи для:

Сложных многошаговых задач, требующих 3 или более отдельных действий
Предоставленных пользователем списков задач, когда упоминается несколько элементов
Нетривиальных операций, которые выигрывают от отслеживания прогресса
Явных запросов, когда пользователи просят организацию задач

Примеры

Мониторинг изменений задач

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Оптимизируй производительность моего React приложения и отслеживай прогресс с задачами",
  options: { maxTurns: 15 }
})) {
  // Обновления задач отражаются в потоке сообщений
  if (message.type === "tool_use" && message.name === "TodoWrite") {
    const todos = message.input.todos;
    
    console.log("Обновление статуса задач:");
    todos.forEach((todo, index) => {
      const status = todo.status === "completed" ? "✅" : 
                    todo.status === "in_progress" ? "🔧" : "❌";
      console.log(`${index + 1}. ${status} ${todo.content}`);
    });
  }
}

Отображение прогресса в реальном времени

import { query } from "@anthropic-ai/claude-agent-sdk";

class TodoTracker {
  private todos: any[] = [];
  
  displayProgress() {
    if (this.todos.length === 0) return;
    
    const completed = this.todos.filter(t => t.status === "completed").length;
    const inProgress = this.todos.filter(t => t.status === "in_progress").length;
    const total = this.todos.length;
    
    console.log(`\nПрогресс: ${completed}/${total} завершено`);
    console.log(`Сейчас работаем над: ${inProgress} задач(ей)\n`);
    
    this.todos.forEach((todo, index) => {
      const icon = todo.status === "completed" ? "✅" : 
                  todo.status === "in_progress" ? "🔧" : "❌";
      const text = todo.status === "in_progress" ? todo.activeForm : todo.content;
      console.log(`${index + 1}. ${icon} ${text}`);
    });
  }
  
  async trackQuery(prompt: string) {
    for await (const message of query({
      prompt,
      options: { maxTurns: 20 }
    })) {
      if (message.type === "tool_use" && message.name === "TodoWrite") {
        this.todos = message.input.todos;
        this.displayProgress();
      }
    }
  }
}

// Использование
const tracker = new TodoTracker();
await tracker.trackQuery("Создай полную систему аутентификации с задачами");

Связанная документация

Примеры

Мониторинг изменений задач

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Оптимизируй производительность моего React приложения и отслеживай прогресс с задачами",
  options: { maxTurns: 15 }
})) {
  // Обновления задач отражаются в потоке сообщений
  if (message.type === "tool_use" && message.name === "TodoWrite") {
    const todos = message.input.todos;
    
    console.log("Обновление статуса задач:");
    todos.forEach((todo, index) => {
      const status = todo.status === "completed" ? "✅" : 
                    todo.status === "in_progress" ? "🔧" : "❌";
      console.log(`${index + 1}. ${status} ${todo.content}`);
    });
  }
}

Отображение прогресса в реальном времени

import { query } from "@anthropic-ai/claude-agent-sdk";

class TodoTracker {
  private todos: any[] = [];
  
  displayProgress() {
    if (this.todos.length === 0) return;
    
    const completed = this.todos.filter(t => t.status === "completed").length;
    const inProgress = this.todos.filter(t => t.status === "in_progress").length;
    const total = this.todos.length;
    
    console.log(`\nПрогресс: ${completed}/${total} завершено`);
    console.log(`Сейчас работаем над: ${inProgress} задач(ей)\n`);
    
    this.todos.forEach((todo, index) => {
      const icon = todo.status === "completed" ? "✅" : 
                  todo.status === "in_progress" ? "🔧" : "❌";
      const text = todo.status === "in_progress" ? todo.activeForm : todo.content;
      console.log(`${index + 1}. ${icon} ${text}`);
    });
  }
  
  async trackQuery(prompt: string) {
    for await (const message of query({
      prompt,
      options: { maxTurns: 20 }
    })) {
      if (message.type === "tool_use" && message.name === "TodoWrite") {
        this.todos = message.input.todos;
        this.displayProgress();
      }
    }
  }
}

// Использование
const tracker = new TodoTracker();
await tracker.trackQuery("Создай полную систему аутентификации с задачами");