SoloBot v1.0
长时间自主执行过程中的「目标记忆保险丝」与「漂移紧急刹车片」
SoloBot 是一个专为 Claude Code 设计的自主执行机器人插件，解决长时间自主执行中的三大核心问题：
- 目标遗忘 - 运行 50~300+ 迭代后，非功能约束、原始取舍动机逐渐淡化/遗忘
- 跨会话恢复 - 隔天/隔周重启时，难以可靠恢复原始目标上下文
- 目标漂移 - 长期项目最容易发生「越跑越偏」
功能特性
- PlanMem 目标锚定 - 持久化存储目标、约束和决策历史
- 周期性重锚 - 每 N 次迭代自动提醒 Claude 重读原始目标
- 漂移检测 - 监控输出是否偏离核心约束，及时预警
- 决策记录 - 记录执行过程中的重要决策
- Integrations 集成 - 支持 OpenSpec/Kiro Specs 等第三方插件
安装方式
🚀 方式 A：从 GitHub Marketplace 安装（推荐）
# 1. 添加 SoloBot 作为 marketplace
/plugin marketplace add maxlee/solobot
# 2. 安装插件
/plugin install solobot@solobot-marketplace
安装后直接使用：
# 启动自主执行循环
/solobot "你的任务描述" --max 50
# OpenSpec 集成模式
/solobot:openspec feature-name
🚀 方式 B：克隆后本地安装
# 1. 克隆仓库到本地
git clone https://github.com/maxlee/solobot.git ~/solobot
# 2. 在 Claude Code 中安装插件
/plugin install ~/solobot
🔧 本地开发测试
方式 A：沉浸式开发模式（推荐）
跳过所有权限确认，让迭代循环更加流畅：
claude --dangerously-skip-permissions --plugin-dir /path/to/solobot
⚠️ 注意：此模式会跳过所有安全确认，仅建议在受信任的项目中使用。
方式 B：标准开发模式
claude --plugin-dir /path/to/solobot
方式 C：调试模式
查看插件加载详情：
claude --debug --plugin-dir /path/to/solobot
快速开始
# 启动自主执行循环
/solobot Implement the user authentication feature
# 设置最大迭代次数
/solobot Fix all failing tests --max 30
# 自定义完成标记
/solobot Refactor the database layer --promise "REFACTORING_DONE" --max 100
首次运行时，SoloBot 会自动初始化 .solobot/ 目录结构。
目录结构
插件目录 (solobot/)
solobot/
├── .claude-plugin/
│ └── plugin.json # 插件清单
├── commands/ # Slash 命令
│ ├── solobot.md # 主命令
│ ├── init.md # 初始化
│ ├── log.md # 记录决策
│ ├── show-log.md # 显示决策日志
│ ├── status.md # 显示状态
│ ├── stats.md # 显示统计
│ ├── cancel.md # 取消执行
│ ├── wrap.md # 包装其他命令
│ └── openspec.md # OpenSpec 桥接
├── hooks/
│ ├── hooks.json # Hook 配置
│ ├── session-start.sh # 会话启动 Hook
│ └── stop-hook.sh # 停止 Hook
├── scripts/ # 脚本实现
│ ├── setup-solobot.sh
│ ├── init-solobot.sh
│ ├── log-decision.sh
│ ├── show-log.sh
│ ├── show-status.sh
│ ├── show-stats.sh
│ ├── cancel-solobot.sh
│ ├── wrap-command.sh
│ └── integrations/
│ ├── init-integrations.sh
│ └── openspec-bridge.sh
├── templates/ # 文件模板
│ ├── planmem/
│ │ ├── goal.md
│ │ ├── invariants.md
│ │ └── decisions-log.md
│ └── integrations/
│ └── config.json
└── tests/ # BATS 测试
工作目录 (.solobot/)
SoloBot 在项目根目录创建 .solobot/ 存储 PlanMem 和 Integrations 配置：
.solobot/
├── planmem/ # PlanMem 记忆模块
│ ├── goal.md # 目标锚点
│ ├── invariants.md # 核心约束
│ ├── decisions-log.md # 决策历史
│ └── archived-goals/ # 历史目标版本
└── integrations/ # 集成模块
├── config.json # 集成配置
└── bridges/ # 第三方桥接配置
状态文件 (.claude/solobot.local.md)
执行状态存储在 .claude/solobot.local.md：
---
# 核心执行字段
promise: "TASK_COMPLETE"
max_iterations: 50
current_iteration: 12
session_id: "abc123"
# PlanMem 字段
planmem_enabled: true
iteration_since_anchor: 7
anchor_interval: 15
drift_warning_count: 0
total_anchors: 2
last_activity_timestamp: "2026-01-15T10:30:00Z"
# Integrations 字段
integrations_enabled: true
active_integrations:
- openspec
---
命令参考
/solobot - 启动自主执行
启动自主执行循环，直到任务完成或达到最大迭代次数。
/solobot <prompt> [--max N] [--promise STRING]
参数：
<prompt> - 任务描述（必需）--max N - 最大迭代次数（默认：50）--promise STRING - 完成标记字符串（默认："TASK_COMPLETE"）
示例：
/solobot Implement the user authentication feature
/solobot Fix all failing tests --max 30
/solobot Refactor the database layer --promise "REFACTORING_DONE" --max 100
/solobot:init - 手动初始化
手动初始化 .solobot/ 目录结构。
/solobot:init [optional prompt to extract goal from]
/solobot:log - 记录决策
添加时间戳条目到决策日志。
/solobot:log <decision description>
示例：
/solobot:log Decided to use REST API instead of GraphQL for simplicity
/solobot:log Adjusted scope to exclude mobile support in v1
/solobot:show-log - 显示决策日志
显示最近的决策日志条目。
/solobot:show-log [count]
参数：
/solobot:status - 显示状态
显示当前目标摘要和执行状态。
/solobot:status
输出包括：
- 当前目标摘要
- 迭代计数（当前/最大）
- 最后活动时间
- 漂移警告计数
- 活跃集成列表
/solobot:stats - 显示统计
显示执行统计信息。
/solobot:stats
输出包括：
- 总迭代次数和进度
- 重锚统计（总次数、间隔）
- 漂移检测状态
- 会话信息
- 决策日志条目数
/solobot:cancel - 取消执行
取消当前自主执行循环。
/solobot:cancel
行为：
- 移除状态文件以停止执行循环
- 保留 PlanMem 文件
- 记录取消操作到决策日志
/solobot:wrap - 包装命令
包装其他 slash 命令进行自主执行。
/solobot:wrap <command> [--max N] [--promise STRING]
示例：
/solobot:wrap /plan implement user authentication
/solobot:wrap /spec create API design --max 30
a5c-ai
feiskyer
itsuzef
DennisLiuCk
jes5199
robzilla1738