SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场claude code x - autonomous execution subagent

claude code x - autonomous execution subagent

智能体与模型

查看项目

更新于 10-16 04:15

技能介绍

用途

Claude Code X 是一个任务执行代理（Task Execution Agent），模式为后台自主（Background Autonomous），版本 1.0.0。其核心目的是在后台自主执行 Claude Code，处理定义明确的任务，支持最多 5 个会话并行执行，让用户在任务运行期间继续其他工作。

主要能力

核心功能包括：

  • 并行执行：最多同时运行 5 个 Claude Code 会话。
  • 会话管理：基于 JSON 的持久化和生命周期跟踪。
  • 后台运行：非阻塞，允许用户继续其他工作。
  • 超时控制：可配置超时，默认 10 分钟。
  • 结果检索：完成后可访问完整输出日志。
  • 会话监控：实时检查状态和进度。

会话生命周期包括：Spawn（创建新的后台 Claude Code 会话）、Execute（使用指定工具自主运行任务）、Monitor（检查状态和输出）、Complete（检索结果并清理）。

默认启用的工具：Bash（命令执行）、Read（文件读取）、Write（文件写入）、Edit（文件编辑）、Glob（文件模式匹配）、Grep（内容搜索）。权限模式默认为 acceptEdits（自动接受文件编辑），可改为请求批准提示。

使用方式

基本执行示例：

Please use the Claude Code X skill to execute the following task in the background:

"Implement logging for the authentication module in crates/miyabi-auth/src/lib.rs"

并行批量执行示例：

Use Claude Code X to execute these 5 tasks in parallel:

1. Add logging to crates/miyabi-auth/src/lib.rs
2. Add logging to crates/miyabi-database/src/lib.rs
3. Add logging to crates/miyabi-api/src/lib.rs
4. Add logging to crates/miyabi-cache/src/lib.rs
5. Add logging to crates/miyabi-worker/src/lib.rs

Monitor their progress and report when all are complete.

自定义配置示例：

Use Claude Code X with:
- Timeout: 15 minutes
- Tools: Bash, Read, Write, Edit, Grep
- Task: "Refactor error handling in crates/miyabi-core/src/errors.rs"

实现步骤：

Step 1：验证任务，检查任务是否定义明确、有清晰成功标准、独立（不依赖用户输入）、适合自主执行。如果不清楚，先向用户请求澄清。

Step 2：使用 shell 脚本执行：

# Execute task
./.claude/commands/claude-code-x.sh exec "Task description here"

# Optional: Custom configuration
./.claude/commands/claude-code-x.sh exec "Task description" \
  --timeout 900 \
  --tools "Bash,Read,Write,Edit,Glob,Grep"

Step 3：捕获会话 ID。脚本会输出：

✅ Session started successfully
🔗 Session ID: claude-code-x-20251027-123456-abc123
🔗 PID: 12345

存储该会话 ID 用于监控。

Step 4：监控进度（可选）：

# Check status
./.claude/commands/claude-code-x.sh status claude-code-x-20251027-123456-abc123

# List all sessions
./.claude/commands/claude-code-x.sh sessions

Step 5：检索结果：

./.claude/commands/claude-code-x.sh result claude-code-x-20251027-123456-abc123

Step 6：向用户报告，提供摘要：会话 ID、执行时间、退出码（0 = 成功）、修改的文件、遇到的任何问题。

会话管理命令：

# List Active Sessions
./.claude/commands/claude-code-x.sh sessions

# Check Session Status
./.claude/commands/claude-code-x.sh status <session-id>

# Get Full Results
./.claude/commands/claude-code-x.sh result <session-id>

# Kill Running Session
./.claude/commands/claude-code-x.sh kill <session-id>

# Cleanup Old Sessions
./.claude/commands/claude-code-x.sh cleanup

配置环境变量：

# Session directory (default: .ai/sessions/claude-code-x)
export CLAUDE_CODE_X_SESSION_DIR=".ai/sessions/claude-code-x"

# Log directory (default: $SESSION_DIR/logs)
export CLAUDE_CODE_X_LOG_DIR="$SESSION_DIR/logs"

# Max concurrent sessions (default: 5)
export CLAUDE_CODE_X_MAX_SESSIONS=5

# Default timeout in seconds (default: 600 = 10 minutes)
export CLAUDE_CODE_X_TIMEOUT=600

适用场景

适合使用的情况：

  • 有 3 个以上独立、定义明确的任务。
  • 任务在执行期间不需要用户交互。
  • 希望通过并行执行最大化吞吐量。
  • 用户可在执行期间受益于多任务处理。
  • 任务遵循清晰模式（例如相似的 Issue）。

不适合使用的情况：

  • 任务在执行期间需要用户决策。
  • 需求不明确或处于探索阶段。
  • 任务对其他运行中的任务有复杂依赖。
  • 需要即时的交互式反馈。

并行执行策略包括：模式 1 相似任务（理想，5 个任务全部并行）；模式 2 分阶段执行（阶段 1 并行基础设施设置任务，阶段 2 交互式关键逻辑，阶段 3 并行提供者实现）；模式 3 混合编排（规划交互、基础设施并行、核心流程交互、提供者并行、测试交互）。

限制

性能特征：

  • 速度：每个会话创建开销约 2-3 秒；执行与交互式 Claude Code 类似；5 个并发会话时吞吐量最高可达 5 倍。
  • 资源使用：每个会话内存约 200MB；每个会话日志磁盘约 1MB；CPU 占用极小（大部分时间用于 AI 推理）。
  • 限制：最大并发会话 5 个（可配置）；默认最大超时 10 分钟（可配置至最多 30 分钟）；日志保留至手动清理。

故障排查：

  • 会话无法启动：错误“Maximum concurrent sessions (5) reached”，解决方法是列出活动会话、终止不活动会话或等待完成，或清理旧会话。
  • 会话超时：错误“Session times out before completion”，解决方法是增加超时，例如 --timeout 1200。
  • 会话失败：检查日志 ./.claude/commands/claude-code-x.sh result <session-id>。常见问题包括缺少文件（在任务描述中添加文件创建）、依赖错误（确保依赖可用）、任务不清晰（使任务描述更具体）。

成功指标目标：时间节省 >25%；成功率 >90%；并行化 3-5 个并发会话；任务清晰度 <10% 需要澄清。

版本 1.0.0，创建于 2025-10-27，作者 Claude Code (Sonnet 4.5)，状态为生产就绪。