tourze/claude-todo-bundle

A Symfony bundle for managing TODO tasks with Claude AI integration

0.0.1 2025-11-18 09:45 UTC

Requires

• php: ^8.2
• doctrine/dbal: ^4.0
• doctrine/doctrine-bundle: ^2.13
• doctrine/orm: ^3.0
• doctrine/persistence: ^4.1
• easycorp/easyadmin-bundle: ^4
• psr/log: ^3|^2|^1
• symfony/config: ^7.3
• symfony/console: ^7.3
• symfony/dependency-injection: ^7.3
• symfony/doctrine-bridge: ^7.3
• symfony/event-dispatcher: ^7.3
• symfony/event-dispatcher-contracts: ^3
• symfony/framework-bundle: ^7.3
• symfony/http-kernel: ^7.3
• symfony/process: ^7.3
• symfony/property-access: ^7.3
• symfony/yaml: ^7.3
• tourze/bundle-dependency: 1.*
• tourze/easy-admin-enum-field-bundle: 1.0.*
• tourze/enum-extra: 1.0.*
• tourze/symfony-dependency-service-loader: 1.0.*

Requires (Dev)

• doctrine/doctrine-fixtures-bundle: ^4.0
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• symfony/phpunit-bridge: ^7.3
• tourze/phpunit-base: 1.*
• tourze/phpunit-doctrine-entity: 1.*
• tourze/phpunit-enum: 1.*
• tourze/phpunit-symfony-kernel-test: 1.0.*
• tourze/phpunit-symfony-unit-test: 1.*
• tourze/phpunit-symfony-web-test: 1.*

MIT

• Monorepo Team

README

English | 中文

一个用于管理TODO任务并集成Claude AI执行的Symfony Bundle。

功能特性

• 📝 TODO任务管理（创建、存储、检索）
• 🏷️ 任务分组管理
• 🤖 Claude AI集成，自动执行任务
• 🖥️ 命令行接口操作

安装

composer require tourze/claude-todo-bundle

配置

在 config/packages/claude_todo.yaml 中配置：

claude_todo:
    claude:
        api_key: '%env(CLAUDE_API_KEY)%'
        model: 'claude-3-sonnet'
        max_tokens: 4000
    task:
        default_timeout: 300
        max_retries: 3

使用方法

添加任务

bin/console claude-todo:push "backend" "实现用户认证API"

获取任务

# 从所有任务中获取
bin/console claude-todo:pop

# 从指定分组获取
bin/console claude-todo:pop "backend"

列出任务

# 列出待处理和进行中的任务（默认）
bin/console claude-todo:list

# 列出指定分组的任务
bin/console claude-todo:list "backend"

# 列出所有状态的任务
bin/console claude-todo:list --all

# 列出特定状态的任务
bin/console claude-todo:list --status=completed

# 列出多个状态的任务
bin/console claude-todo:list --status=pending --status=failed

# 限制显示数量
bin/console claude-todo:list --limit=20

执行任务

bin/console claude-todo:run 123

清理任务

# 清理所有任务
bin/console claude-todo:clear --force

# 清理指定分组的任务
bin/console claude-todo:clear "backend" --force

# 交互式确认清理
bin/console claude-todo:clear

修复已完成任务时间

# 修复缺失完成时间的已完成任务
bin/console claude-todo:fix-completed-time

# 预览模式（不实际修改）
bin/console claude-todo:fix-completed-time --dry-run

Worker模式（持续执行）

启动Worker持续监听并执行任务：

# 默认设置（永不超时）
bin/console claude-todo:worker

# 指定组
bin/console claude-todo:worker --group=backend

# 设置空闲超时（秒）
bin/console claude-todo:worker --idle-timeout=600

# 设置1小时后空闲退出
bin/console claude-todo:worker --idle-timeout=3600

# 自定义检查间隔和重试次数
bin/console claude-todo:worker --check-interval=5 --max-attempts=5

Worker会自动：

• 获取优先级最高的待处理任务
• 使用Claude CLI执行任务
• 更新任务状态（完成或失败）
• 继续处理下一个任务
• 当达到空闲超时时停止

开发

运行测试

composer test

代码检查

composer phpstan
composer cs-fix

许可证

MIT