用途:为 autonomous-dev 插件生态提供标准化的状态管理与持久化模式,确保状态在 Claude 重启和系统故障后仍可靠、可恢复。
主要能力:JSON 持久化配合原子写入(先写临时文件再 os.replace 重命名,避免崩溃时文件损坏);使用 fcntl.flock 实现文件锁,防止并发修改;崩溃恢复设计,状态包含足够上下文以支持“从上次检查点继续”;状态版本化与迁移(如 STATE_VERSION 与 migrate_state 逐版本升级);批量操作跟踪(BatchStateManager 记录 completed/failed、current_index、时间戳,并在 150K tokens 时自动清理上下文);用户偏好管理。
使用方式:技能在关键词匹配时自动加载,关键词包括 state、persistence、JSON、atomic、crash recovery、checkpoint。库作者实现有状态功能时应采用原子写入、并发加锁、可恢复状态、版本化与加载校验。批量状态示例:manager = BatchStateManager.create(["feat1", "feat2", "feat3"]),处理中调用 manager.mark_completed(feature) 或 manager.mark_failed(feature, str(e)),再 manager.save();崩溃后用 BatchStateManager.load("batch-20251116-123456") 与 get_next_feature() 跳过已完成项。检查点集成采用可移植路径检测(向上查找 .git 定位项目根),导入 agent_tracker 的 AgentTracker.save_agent_checkpoint,失败时优雅降级不阻塞流程。
适用场景:长时间运行的批量处理、需要断点续跑的任务、多进程/多会话并发访问同一状态文件、状态结构需要升级迁移的库。
限制:资料未提供具体安装命令、收费与价格信息;文件锁示例基于 fcntl,属类 Unix 环境;技能内容需随新模式、版本策略与并发模式变化而更新。