| name | autonomous-agent-harness |
| description | 将 Claude Code 转变为具有持久记忆、定时操作、计算机使用和任务队列的完全自主代理系统。通过利用 Claude Code 的原生定时任务、调度、MCP 工具和记忆，取代独立的代理框架（Hermes、AutoGPT）。当用户需要持续自主操作、定时任务或自我导向的代理循环时使用。 |
| origin | ECC |
自主代理框架
仅使用原生功能和 MCP 服务器，将 Claude Code 转变为持久化、自我导向的代理系统。
同意与安全边界
自主操作必须由用户明确请求并划定范围。除非用户已批准该能力以及当前设置的目标工作空间，否则不得创建计划、调度远程代理、写入持久化内存、使用计算机控制、发布外部内容、修改第三方资源或处理私人通信。
在启用定期或事件驱动操作之前，优先使用预演计划和本地队列文件。将凭据、私有工作空间导出、个人数据集和账户特定自动化排除在可复用的 ECC 工件之外。
何时激活
- 用户需要一个持续运行或按计划运行的代理
- 设置定期触发的自动化工作流
- 构建一个跨会话记住上下文的个人 AI 助手
- 用户说“每天运行这个”、“定期检查这个”、“持续监控”
- 希望复制 Hermes、AutoGPT 或类似自主代理框架的功能
- 需要计算机使用与计划执行相结合
架构
┌──────────────────────────────────────────────────────────────┐
│ Claude Code 运行时 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │ 定时任务 │ │ 远程调度 │ │ 记忆存储 │ │ 计算机使用 │ │
│ │ 调度器 │ │ 代理 │ │ │ │ │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ECC 技能 + 代理层 │ │
│ │ │ │
│ │ skills/ agents/ commands/ hooks/ │ │
│ └──────────────────────────────────────────────────────┘ │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ MCP 服务器层 │ │
│ │ │ │
│ │ memory github exa supabase browser-use │ │
│ └──────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
核心组件
1. 持久化内存
使用 Claude Code 的内置内存系统，并通过 MCP 内存服务器增强以处理结构化数据。
内置内存（~/.claude/projects/*/memory/）：
- 用户偏好、反馈、项目上下文
- 存储为带有前置元数据的 Markdown 文件
- 在会话启动时自动加载
MCP 内存服务器（结构化知识图谱）：
内存模式：
# 短期：当前会话上下文
使用 TodoWrite 进行会话内任务追踪
# 中期：项目记忆文件
写入 ~/.claude/projects/*/memory/ 以实现跨会话回忆
# 长期：MCP 知识图谱
使用 mcp__memory__create_entities 创建永久结构化数据
使用 mcp__memory__create_relations 进行关系映射
使用 mcp__memory__add_observations 添加关于已知实体的新事实
2. 计划操作（定时任务）
使用 Claude Code 的计划任务创建定期代理操作。
设置定时任务：
# Via MCP tool
mcp__scheduled-tasks__create_scheduled_task({
name: "daily-pr-review",
schedule: "0 9 * * 1-5", # 工作日上午9点
prompt: "Review all open PRs in affaan-m/everything-claude-code. For each: check CI status, review changes, flag issues. Post summary to memory.",
project_dir: "/path/to/repo"
})
# Via claude -p (程序化模式)
echo "Review open PRs and summarize" | claude -p --project /path/to/repo
有用的定时任务模式：
| 模式 | 计划 | 用例 |
|---|
| 每日站会 | 0 9 * * 1-5 | 审查 PR、问题、部署状态 |
| 每周回顾 | 0 10 * * 1 | 代码质量指标、测试覆盖率 |
| 每小时监控 | 0 * * * * | 生产健康、错误率检查 |
| 夜间构建 | 0 2 * * * | 运行完整测试套件、安全扫描 |
| 会前准备 | */30 * * * * | 为即将到来的会议准备上下文 |
3. 调度 / 远程代理
远程触发 Claude Code 代理以进行事件驱动的工作流。
调度模式：
curl -X POST "https://api.anthropic.com/dispatch" \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-d '{"prompt": "Build failed on main. Diagnose and fix.", "project": "/repo"}'
claude -p "Analyze the output of the security scan and create issues for findings"
4. 计算机使用
利用 Claude 的计算机使用 MCP 进行物理世界交互。
能力：
- 浏览器自动化（导航、点击、填写表单、截图）
- 桌面控制（打开应用、输入、鼠标控制）
- 超越 CLI 的文件系统操作
在框架内的用例：
- Web UI 的自动化测试
- 表单填写和数据录入
- 基于截图的监控
- 多应用工作流
5. 任务队列
管理一个跨会话边界的持久化任务队列。
实现：
# 通过记忆实现任务持久化
将任务队列写入 ~/.claude/projects/*/memory/task-queue.md
# 任务格式
---
name: task-queue
type: project
description: 用于自主操作的持久化任务队列
---
## 活跃任务
- [ ] PR #123: 审查并在CI通过后批准
- [ ] 监控部署：每30分钟检查一次 /health，持续2小时
- [ ] 调研：在AI工具领域寻找5个潜在客户
## 已完成
- [x] 每日站会：审查了3个PR，2个问题
替换 Hermes
| Hermes 组件 | ECC 等效组件 | 如何实现 |
|---|
| 网关/路由器 | Claude Code 调度 + 定时任务 | 计划任务触发代理会话 |
| 内存系统 | Claude 内存 + MCP 内存服务器 | 内置持久化 + 知识图谱 |
| 工具注册表 | MCP 服务器 | 动态加载的工具提供者 |
| 编排 | ECC 技能 + 代理 | 技能定义指导代理行为 |
| 计算机使用 | 计算机使用 MCP | 原生浏览器和桌面控制 |
| 上下文管理器 | 会话管理 + 内存 | ECC 2.0 会话生命周期 |
| 任务队列 | 内存持久化任务列表 | TodoWrite + 内存文件 |
设置指南
步骤 1：配置 MCP 服务器
确保这些在 ~/.claude.json 中：
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@anthropic/memory-mcp-server"]
},
"scheduled-tasks": {
"command": "npx",
"args": ["-y", "@anthropic/scheduled-tasks-mcp-server"]
},
"computer-use": {
"command": "npx",
"args": ["-y", "@anthropic/computer-use-mcp-server"]
}
}
}
步骤 2：创建基础定时任务
claude -p "Create a scheduled task: every weekday at 9am, review my GitHub notifications, open PRs, and calendar. Write a morning briefing to memory."
claude -p "Create a scheduled task: every Sunday at 8pm, extract patterns from this week's sessions and update the learned skills."
步骤 3：初始化内存图谱
claude -p "Create memory entities for: me (user profile), my projects, my key contacts. Add observations about current priorities."
步骤 4：启用计算机使用（可选）
授予计算机使用 MCP 浏览器和桌面控制所需的权限。
示例工作流
自主 PR 审查员
Cron: 工作时间内每30分钟执行一次
1. 检查关注仓库的新PR
2. 对每个新PR：
- 在本地拉取分支
- 运行测试
- 使用代码审查代理审查变更
- 通过GitHub MCP发布审查评论
3. 更新审查状态到记忆库
个人研究代理
Cron: 每天上午6点执行
1. 检查内存中保存的搜索查询
2. 对每个查询运行Exa搜索
3. 总结新发现
4. 与昨日结果进行对比
5. 将摘要写入内存
6. 标记高优先级项目供晨间审阅
会议准备代理
触发条件：每个日历事件前30分钟
1. 读取日历事件详情
2. 搜索记忆中关于参会者的背景信息
3. 提取与参会者近期的邮件/Slack讨论记录
4. 准备谈话要点和议程建议
5. 将准备文档写入记忆
约束
- 定时任务在隔离的会话中运行——除非通过内存，否则它们不与交互式会话共享上下文。
- 计算机使用需要明确的权限授予。不要假设可以访问。
- 远程调度可能有速率限制。设计定时任务时使用适当的间隔。
- 内存文件应保持简洁。归档旧数据，而不是让文件无限增长。
- 始终验证计划任务是否成功完成。在定时任务提示中添加错误处理。
