cognitive-loop（认知循环）

🧠 Cognitive Loop - 认知闭环 Skill

概述

认知闭环是 OpenClaw Agent 的核心执行引擎，实现高自主性的「思考 - 行动 - 反思」闭环。

⚠️ 安全使用指南

使用前请务必：

1. 审核代码：检查 GitHub 仓库源代码
2. 沙箱执行：首次使用时在沙箱环境中测试
3. 路径限制：仅允许写入 memory/ 子目录
4. 禁止自主执行：复杂操作需用户确认

四大核心模块

激活条件

收到以下类型任务时必须激活：

1. 开发任务：前端页面、后端 API、数据库设计、DevOps 部署
2. 多步骤任务：需要拆解为多个子任务、有依赖关系
3. TDD/测试任务：用户明确要求测试驱动开发
4. 重构优化：性能优化、代码重构、架构调整
5. 复杂需求：需求模糊或涉及多个功能模块

安装方式

方式一：npm 安装（推荐）

npm install cognitive-agent

方式二：ClawHub 安装

openclaw skills install cognitive-loop

方式三：源码安装

git clone https://github.com/World-peace001/cognitive-agent.git
cd cognitive-agent
npm install

激活方式

重要：必须先审核代码

首次使用时，请：

1. 检查 GitHub 仓库的源代码
2. 确认 npm 包的完整性
3. 在沙箱环境中测试

激活方式

当收到符合激活条件的任务时：

1. 用户确认：必须获得用户明确同意
2. 代码审核：自行或让用户审核将执行的代码
3. 沙箱执行：建议在沙箱环境中首次运行

推荐的闭环模式

// 伪代码示例 - 实际使用需先安装 cognitive-agent 包
import CognitiveOrchestrator from 'cognitive-agent';

const orchestrator = new CognitiveOrchestrator();

const result = await orchestrator.闭环(
  '任务描述',
  async (task, context) => {
    // 执行实际任务
    return { status: 'success' };
  }
);

闭环执行流程

用户需求
    │
    ▼
┌────────┐ → 任务理解 → 策略选择 → 执行计划
│ 规划器 │
└────────┘
    │
    ▼
┌────────┐ → 执行 → 进度追踪 → 异常处理
│ 执行监控│
└────────┘
    │
    ▼
┌────────┐ → 评估结果 → 经验入库 → 优化建议
│ 反思器 │
└────────┘
    │
    ▼
┌────────┐ → 测试生成 → 覆盖率验证 → 闭环修复
│ 测试器 │
└────────┘

记忆系统

经验自动保存到 memory/ 目录（沙箱限制）：

memory/
├── patterns/     # 可复用执行模式
├── lessons/     # 失败教训
├── successes/   # 成功案例
└── knowledge/   # 知识积累

自主能力等级

项目信息

• GitHub: https://github.com/World-peace001/cognitive-agent
• npm: https://www.npmjs.com/package/cognitive-agent
• ClawHub: https://clawhub.ai/skills/cognitive-loop
• 版本: 1.0.0

安全声明

本 Skill 已通过基础安全审核，但用户/代理在使用前应：

1. 自行审核源代码
2. 使用沙箱环境测试
3. 限制持久化路径
4. 监控内存使用

许可

MIT License