核心用法
agent-autopilot 是一套完整的子代理自驱动工作流框架，核心目标是将 AI 代理从被动响应模式转变为主动项目经理模式。它通过三个定时任务驱动代理持续工作：① 自驱动执行循环（每次心跳触发，约30分钟），自动检查待办、执行任务、记录结果；② 进度汇报（白天按设定间隔主动汇报，夜间静默攒到白天），包含晨报、周期汇报、晚报和紧急汇报四种格式；③ 长期记忆维护（每6小时提炼日志到 MEMORY.md，清理过时信息）。
使用流程：先运行 init.sh 初始化工作空间，配置 HEARTBEAT.md 设定项目目标和汇报间隔，依赖 todo-management skill 进行任务追踪。代理会自主决策技术方案、任务优先级、迭代方向，仅在需要外部资源或方向性变更时才上报人类。
显著优点
真正的自主性：不同于需要人类逐轮指导的代理，此框架让代理具备"永不空转"原则——每次心跳必须推进项目，自主创建新任务，达标前永不停止。这种设计显著降低人类监督成本，适合长期运行的编码、研究、优化类项目。
结构化记忆体系：区分原始日志（memory/YYYY-MM-DD.md）和提炼记忆（MEMORY.md），6小时自动维护机制确保代理不会"失忆"，同时避免上下文膨胀。记忆条目包含里程碑、教训、关键数据、配置变更、决策记录五类结构化信息。
灵活的汇报机制：白天/夜间双模式设计，高频项目可设2小时间隔，低频项目可设4-6小时，夜间仅重大事件才打扰人类，平衡了信息透明度与打扰频率。
潜在缺点与局限性
初始化门槛较高：需要正确配置 HEARTBEAT.md、IDENTITY.md、SOUL.md 等多个文件，且必须完整复制核心规则（不能"同上"），新用户容易遗漏导致代理行为异常。
依赖外部 skill：强制依赖 todo-management，若该 skill 未正确安装或数据库损坏，整个工作流会中断。
自主决策的边界模糊：虽然文档列出了"可以自主决定"和"必须上报"的清单，但实际项目中技术方案选择与方向性变更的界限可能模糊，代理可能过度自主或过度保守。
故障恢复依赖人工判断：虽然提供了从 memory 和 git log 恢复的流程，但代理本身无法自动判断"是否需要重做"，中断后可能需要人类介入评估状态。
适合人群
- 需要 AI 代理长期自主运行数小时至数天的场景（如代码重构、量化策略回测优化、文献综述）
- 希望降低同步沟通成本、接受异步汇报模式的用户
- 具备一定技术背景、能正确配置身份文件和工作空间的开发者
常规风险
无限循环风险：若项目目标设定不清或代理陷入局部最优，可能在不产生实质进展的方向上持续迭代。缓解：设置明确的终止条件和关键指标，定期人工审查 MEMORY.md。
记忆污染风险：自动提炼可能丢失关键细节，或保留已过时假设。缓解：定期人工审核 MEMORY.md，对比原始日志验证。
汇报遗漏风险：report-state.json 丢失或损坏可能导致汇报间隔计算错误。缓解：将状态文件纳入 git 跟踪。
安全风险：代理具备文件写入、任务创建、自主决策等权限，若身份文件（SOUL.md 等）被恶意篡改，可能导致代理执行有害操作。建议仅在可信环境中运行，核心规则文件设为只读。