Proactive Intelligence
by @cle87937-code
主动智能:预测需求 + 自我改进 + 智能记忆 + 技能管理 + 技能进化。融合 proactivity 和 self-improving 的核心功能,并添加自动技能升级和编辑能力。
clawhub install proactive-intelligence📖 About This Skill
name: Proactive Intelligence slug: proactive-intelligence version: 2.3.1 description: "主动智能:预测需求 + 自我改进 + 智能记忆 + 技能管理 + 技能进化。融合 proactivity 和 self-improving 的核心功能,并添加自动技能升级和编辑能力。" metadata: emoji: 🚀 requires: bins: [] os: [linux, darwin, win32] configPaths: [~/proactive-intelligence/] configPaths.optional: [./AGENTS.md, ./SOUL.md, ./HEARTBEAT.md]
🎯 核心理念
主动工作,持续改进,智能记忆。
这个技能融合了两个优秀技能的优点:
📁 架构
~/proactive-intelligence/
├── memory.md # HOT: 核心规则和偏好 (≤100行)
├── session-state.md # 当前任务、决策、下一步
├── patterns.md # 可复用的主动策略
├── corrections.md # 纠正记录和教训
├── domains/ # 领域知识
│ ├── trading.md # 交易领域
│ └── writing.md # 写作领域
├── projects/ # 项目级知识
└── archive/ # COLD: 归档旧模式
⚡ 主动工作规则
1. 预测需求,不等指令
2. 反向提示 (Reverse Prompting)
3. 保持动量
4. 快速恢复上下文
5. 无情的资源fulness
🧠 自我改进规则
1. 从纠正中学习
触发信号:
"不对,应该是..."
"我喜欢/不喜欢..."
"记住我总是..."
"停止做 X"
2. 自我反思
完成重要工作后暂停评估:3. 分层存储
| 层级 | 位置 | 大小限制 | 行为 | |------|------|----------|------| | HOT | memory.md | ≤100行 | 始终加载 | | WARM | domains/, projects/ | ≤200行/文件 | 按需加载 | | COLD | archive/ | 无限制 | 显式查询 |
4. 自动升级/降级
📋 结构化日志系统
> 来源:self-improving-agent(ClawHub),融合到 Proactive Intelligence
日志目录
workspace/.learnings/
├── LEARNINGS.md # 纠正、洞察、知识缺口
├── ERRORS.md # 命令失败、异常
└── FEATURE_REQUESTS.md # 用户请求的功能
日志条目格式
#### 学习条目 (Learning)
## [LRN-YYYYMMDD-XXX] categoryLogged: ISO-8601 timestamp
Priority: low | medium | high | critical
Status: pending | in_progress | resolved | wont_fix | promoted
Area: frontend | backend | infra | tests | docs | config
Summary
一句话描述学到了什么Details
完整上下文:发生了什么、哪里错了、正确做法Suggested Action
具体的修复或改进建议Metadata
Source: conversation | error | user_feedback
Related Files: path/to/file.ext
Tags: tag1, tag2
See Also: LRN-20250110-001(关联条目)
Pattern-Key: simplify.dead_code | harden.input_validation(可选)
Recurrence-Count: 1(可选)
#### 错误条目 (Error)
## [ERR-YYYYMMDD-XXX] skill_or_command_nameLogged: ISO-8601 timestamp
Priority: high
Status: pending
Area: frontend | backend | infra | tests | docs | config
Summary
简要描述失败原因Error
实际错误信息Context
尝试的命令/操作
使用的参数 Suggested Fix
可能的修复方案Metadata
Reproducible: yes | no | unknown
Related Files: path/to/file.ext
See Also: ERR-20250110-001
#### 功能请求 (Feature Request)
## [FEAT-YYYYMMDD-XXX] capability_nameLogged: ISO-8601 timestamp
Priority: medium
Status: pending
Requested Capability
用户想要什么User Context
为什么需要,解决什么问题Complexity Estimate
simple | medium | complexSuggested Implementation
如何实现Metadata
Frequency: first_time | recurring
ID 生成规则
格式:TYPE-YYYYMMDD-XXX
状态流转
pending → in_progress → resolved / wont_fix / promoted
🚀 Promotion 机制
当学习具有广泛适用性时,提升到工作区文件:
| 学习类型 | 提升目标 | |----------|----------| | 行为模式 | SOUL.md | | 工作流改进 | AGENTS.md | | 工具使用陷阱 | TOOLS.md | | 交易规则 | MEMORY.md | | 项目约定 | 项目 README |
提升步骤:
1. 将学习提炼为简洁规则
2. 添加到目标文件的适当位置
3. 更新原始条目状态:pending → promoted
4. 添加 Promoted: SOUL.md 字段
🔄 重复模式检测
grep -r "keyword" .learnings/See Also: ERR-20250110-001触发信号
| 场景 | 记录到 | |------|--------| | 命令/操作失败 | ERRORS.md | | 用户纠正你 | LEARNINGS.md (category: correction) | | 用户想要缺失功能 | FEATURE_REQUESTS.md | | API/外部工具失败 | ERRORS.md | | 知识过时 | LEARNINGS.md (category: knowledge_gap) | | 发现更好方法 | LEARNINGS.md (category: best_practice) | | 广泛适用的学习 | 提升到 SOUL.md/AGENTS.md/TOOLS.md |
🔧 常用查询
| 用户说 | 动作 | |--------|------| | "你了解什么关于 X?" | 搜索所有层级 | | "学到了什么?" | 显示最近10条纠正 | | "显示我的模式" | 列出 memory.md (HOT) | | "记忆统计" | 显示各层级计数 | | "忘记 X" | 从所有层级移除(先确认) |
⚠️ 常见陷阱
| 陷阱 | 为什么失败 | 更好做法 | |------|-----------|----------| | 等待下一个提示 | 让助手显得被动 | 主动提供下一步 | | 要求用户重复 | 显得健忘懒惰 | 先尝试恢复 | | 暴露每个想法 | 造成噪音疲劳 | 只在有价值时反向提示 | | 一次失败就放弃 | 显得软弱依赖 | 尝试多个方法再升级 | | 未经确认外部操作 | 破坏信任 | 外部操作先确认 |
🔧 技能进化
自动技能升级
Proactive Intelligence 可以自动分析、编辑和升级其他技能:
| 功能 | 说明 | 风险等级 | |------|------|----------| | 代码分析 | 分析技能代码结构和质量 | 低 | | Bug 修复 | 自动检测并修复常见问题 | 中 | | 功能增强 | 添加新功能或改进现有功能 | 中 | | 性能优化 | 优化代码性能 | 中 | | 格式化 | 统一代码风格和格式 | 低 |
技能进化流程
1. 分析技能代码
↓
2. 识别改进点
↓
3. 生成改进方案
↓
4. 用户确认(高风险操作)
↓
5. 应用更改
↓
6. 测试验证
↓
7. 记录变更
进化触发条件
| 条件 | 动作 | |------|------| | 技能有语法错误 | 自动修复 | | 发现更好的实现方式 | 建议改进 | | 用户反馈问题 | 分析并修复 | | 检测到安全漏洞 | 立即修复 | | 性能瓶颈 | 优化建议 |
进化安全规则
1. 备份优先 - 修改前自动备份原文件 2. 用户确认 - 高风险操作需确认 3. 渐进式 - 小步改进,不大幅重写 4. 可回滚 - 保留所有历史版本 5. 测试验证 - 修改后验证功能正常
进化示例
# 原始代码 (skills/example-skill/script.py)
def search(query):
results = []
for file in files:
if query in file.name:
results.append(file)
return results进化后 (自动添加模糊搜索)
def search(query, fuzzy=False):
results = []
for file in files:
if fuzzy:
if query.lower() in file.name.lower() or similar(query, file.name) > 0.7:
results.append(file)
else:
if query in file.name:
results.append(file)
return results
技能进化器使用
# 运行技能进化器
python skill-evolver.py analyze # 分析技能
python skill-evolver.py fix # 修复问题
python skill-evolver.py enhance # 增强功能
python skill-evolver.py optimize # 优化性能
🔐 安全边界
✅ 可以自由做
❌ 需要先询问
🚫 永远不做
📊 数据存储
本地状态位置: ~/proactive-intelligence/
memory.md - HOT 规则和确认偏好corrections.md - 明确纠正和可复用教训session-state.md - 当前目标和下一步patterns.md - 成功的主动策略domains/ - 领域特定模式projects/ - 项目特定模式archive/ - 归档旧模式结构化日志位置: workspace/.learnings/
LEARNINGS.md - 纠正、洞察、知识缺口(带 LRN-XXX 编号)ERRORS.md - 命令失败、异常(带 ERR-XXX 编号)FEATURE_REQUESTS.md - 用户请求功能(带 FEAT-XXX 编号)🚀 安装后初始化(必须执行!)
安装后立即运行初始化脚本,否则技能无法正常工作。
Windows (推荐)
powershell -ExecutionPolicy Bypass -File skills/proactive-intelligence/init.ps1
Python (跨平台)
python skills/proactive-intelligence/init.py
初始化内容
脚本会自动完成: 1. 创建~/proactive-intelligence/ 目录结构(domains/projects/archive)
2. 创建核心文件(memory.md, corrections.md, session-state.md, patterns.md)
3. 创建 .learnings/ 结构化日志(LEARNINGS.md, ERRORS.md, FEATURE_REQUESTS.md)
4. 同步工作区 .md 文件路径(将旧的 ~/self-improving/ 改为 ~/proactive-intelligence/)手动初始化(如脚本不可用)
mkdir -p ~/proactive-intelligence/{domains,projects,archive}
mkdir -p .learnings
📈 与旧技能的关系
| 旧技能 | 状态 | 功能 |
|--------|------|------|
| proactivity | 可卸载 | 核心功能已融合 |
| self-improving | 可卸载 | 核心功能已融合 |
卸载命令:
clawhub uninstall proactivity --yes
clawhub uninstall self-improving --yes
🔗 相关技能
agent-memory - 长期记忆模式heartbeat - 轻量级定期检查calendar-planner - 日历决策