# 创建任务
task-executor create "任务描述"

# 创建检查点
task-executor checkpoint create "检查点名称"

# 执行任务
task-executor run "命令 1" "命令 2" ...

# 回滚到检查点
task-executor rollback {task_id} {checkpoint_name}

# 查看任务状态
task-executor status {task_id}

# 创建检查点
source checkpoint.sh
checkpoint_create "task_001" "before_config-change"

# 回滚到检查点
checkpoint_rollback "task_001" "before_config-change"

# 列出检查点
checkpoint_list "task_001"

// 执行任务
const executor = new Executor();
await executor.run(commands, { mode: 'semi' });

// 执行模式
// - auto: 全自动执行
// - semi: 关键节点确认
// - manual: 逐条确认

# 验证配置
source validator.sh
validate_config "hyprland"
validate_config "fish"
validate_config "fcitx5"

// 记录事件
const logger = new Logger(taskId);
logger.info('任务开始');
logger.warn('配置验证失败');
logger.error('执行出错');
logger.complete('任务完成');

~/skills/task-executor/
├── SKILL.md                 # 本文档
├── scripts/
│   ├── checkpoint.sh        # 检查点管理
│   ├── executor.mjs         # 执行引擎
│   ├── validator.sh         # 验证器
│   └── logger.mjs           # 日志记录
├── templates/
│   └── task-report.md       # 任务报告模板
└── tasks/                   # 任务数据
    └── {task_id}/
        ├── checkpoints/
        ├── logs/
        └── metadata.json

# 注册为 Skill
# 已在 ~/.claude/skills 中链接

# 触发词
- "执行任务"
- "自动完成"
- "帮我做"

# 同步任务状态到看板
task-executor sync --mission-control

# 执行超时（秒）
export TASK_EXECUTOR_TIMEOUT=1800

# 最大重试次数
export TASK_EXECUTOR_MAX_RETRIES=3

# 检查点目录
export TASK_EXECUTOR_CHECKPOINT_DIR="$HOME/.local/share/dotfiles/checkpoints"

# ~/.config/task-executor/config.yaml
mode: semi
timeout: 1800
max_retries: 3
checkpoint_dir: ~/.local/share/dotfiles/checkpoints
log_dir: ~/.local/share/dotfiles/logs/tasks

# 检查目录权限
ls -la ~/.local/share/dotfiles/checkpoints/

# 创建目录
mkdir -p ~/.local/share/dotfiles/checkpoints

# 列出可用检查点
task-executor checkpoint list {task_id}

# 手动恢复
cp -r ~/.local/share/dotfiles/checkpoints/{task_id}/{checkpoint}/* ~/

# 检查日志目录
ls -la ~/.local/share/dotfiles/logs/tasks/

# 创建目录
mkdir -p ~/.local/share/dotfiles/logs/tasks

# 1. 创建任务
task-executor create "修改 Hyprland 快捷键"

# 2. 创建检查点
task-executor checkpoint create "before-keybinding-change"

# 3. 执行修改
task-executor run \
  "echo 'bind = SUPER, K, exec, kdeconnect-cli -d' >> ~/.config/hypr/keybindings.conf" \
  "hyprctl reload"

# 4. 验证
task-executor validate "hyprland"

# 5. 如果失败，回滚
task-executor rollback "before-keybinding-change"

# 1. 创建任务
task-executor create "安装开发工具"

# 2. 创建检查点
task-executor checkpoint create "before-install"

# 3. 执行安装
task-executor run \
  "sudo pacman -S git neovim tmux" \
  "paru -S lazygit" \
  "npm install -g @anthropic-ai/claude-code"

# 4. 验证
task-executor validate "git" "nvim" "tmux" "claude"

# 5. 完成
task-executor complete

task-executor create <description> [--id <task_id>]

task-executor checkpoint create <name> [--task <task_id>]
task-executor checkpoint list <task_id>
task-executor checkpoint restore <task_id> <checkpoint_name>

task-executor run <command1> [command2] ... [--mode auto|semi|manual]

task-executor rollback <task_id> <checkpoint_name>

task-executor status [task_id]

task-executor complete <task_id> [--success|--failure]