Agent Autopilot

核心用法

Agent Autopilot 是一套面向子代理的自治工作流框架，核心机制是通过 HEARTBEAT.md 配置文件驱动心跳循环。代理按固定间隔（通常10-30分钟）自动检查待办任务，选取高优先级项执行，完成后更新状态并向上级汇报，形成永不停歇的自主迭代闭环。

显著优点

1. 零监护运行：配置铁律规则后，代理可独立完成编码、研究、优化等长期项目，大幅降低人工督导成本
2. 结构化产出：强制要求 memory 日志记录和分层汇报机制，确保过程可追溯、结果可量化
3. 故障自愈设计：内置从 memory 和 git 历史恢复任务的流程，中断后可无缝续跑
4. 敏捷决策：赋予代理技术选型、优先级排序、子任务创建的自主权，实现数据驱动的小步快跑

潜在局限性

• 依赖配套生态：必须预装 todo-management skill，且需正确配置工作空间目录结构，初始化门槛较高
• 决策边界模糊："方向性变更"与"技术方案选择"的界定依赖人工预设，复杂场景可能误判上报时机
• 长期记忆成本：每日 memory 追加 + 定期提炼 MEMORY.md，高频执行会产生大量日志维护负担
• 无限循环风险："永不停止"设定若缺乏明确的终止条件检测，可能导致资源空转

适合人群

• 需要7×24小时持续运行的后台任务（量化策略优化、数据爬虫、A/B测试迭代）
• 多代理协作场景中的"项目经理"角色代理
• 追求"设定目标即可放手"的自动化重度用户

常规风险

• 权限失控：自主创建任务和调用工具的权限若未严格沙箱化，可能引发越权操作
• 汇报噪音：高频心跳产生的汇报流可能淹没关键信息，需配合汇报规则中的"重大进展"过滤机制
• 状态漂移：todo.db 损坏或 memory 记录不完整时，重建任务可能丢失上下文或产生重复劳动

核心用法

agent-autopilot 是一套用于配置自驱动 Agent 工作流的文档型技能，本身不包含可执行的危险代码。其核心用途是指导用户为子 Agent 建立类似"项目经理"的自治能力，使其能够在无需持续人工干预的情况下自主推进项目（编程、研究、优化等）。

关键配置流程：
1. 初始化环境：通过 init.sh 脚本创建标准目录结构（skills/、memory/），并关联 todo-management 技能
2. 配置 HEARTBEAT.md：这是自驱动的核心引擎，定义执行循环（检查待办→执行→记录→汇报→循环）和决策铁律（不问方向、自主决策、达标前永不停止）
3. 集成任务管理：所有工作必须通过 todo 列表跟踪，Agent 在每次心跳时自动检查 pending/in_progress 任务
4. 建立汇报机制：采用三层汇报结构（Agent→茄子→老大），要求带时间戳的具体数据汇报，关键节点主动上报
5. Memory 记录：每日执行记录写入 memory/YYYY-MM-DD.md，定期提炼长期记忆到 MEMORY.md

典型应用场景：

• 需要长时间运行的编码 Agent（如量化策略优化）
• 需要自主迭代的研究任务
• 需要结构化进度跟踪的复杂项目

显著优点

• 完全自主运行：明确"永不停止"机制，Agent 在目标达成前持续自动推进，无需人工催促
• 结构化治理：强制使用 todo 管理 + Memory 记录 + 分级汇报，避免"黑箱执行"
• 故障恢复机制：从 memory/ 日志和 todo.db 双重保障可恢复性
• 决策边界清晰：明确区分"可自主决定"（技术方案、优先级）与"必须上报"（方向变更、资源需求）
• 零代码风险：纯文档型技能，无外部网络调用、无第三方依赖

潜在缺点与局限性

• 强依赖 todo-management：若依赖技能未安装或版本不兼容，整个工作流失效
• 路径遍历风险：init.sh 接收用户输入的工作空间路径，缺乏输入验证，存在潜在路径遍历问题（需用户自行确保路径安全）
• 过度自治风险："不问老大方向"的铁律在复杂场景下可能导致方向偏差累积
• Heartbeat 频率刚性：依赖 OpenClaw 的固定间隔（10-30分钟），难以针对紧急任务动态调整
• 汇报噪音：频繁的心跳循环可能产生过多汇报消息，需用户自行设定合理的汇报阈值

适合人群

• 需要 7×24 自动化任务执行 的开发者（如量化交易、数据爬取、持续集成）
• 需要 多阶段复杂项目 自主推进的研究人员
• 熟悉命令行操作、能自行验证脚本安全性的技术用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行风险 | 极低 | 纯文档型，无危险函数或恶意代码 |

| 数据泄露风险 | 极低 | 不收集敏感数据，所有记录本地存储 |

| 网络攻击风险 | 无 | 零外部网络调用 |

| 依赖风险 | 中 | 强依赖 `todo-management` 技能，需验证其来源可信度 |

| 配置风险 | 中 | 错误的 HEARTBEAT.md 配置可能导致 Agent 行为失控 |

使用建议：首次使用前应在隔离环境测试 init.sh，验证 todo-management 技能来源，并严格审查 HEARTBEAT.md 中的"铁律"条款是否符合项目需求。