Proactive Agent Skill

概述

主动扫描代码库，无需用户明确询问就发现潜在问题、技术债务和改进机会，生成优先级行动清单。

依赖

• MCP 服务器:

  filesystem

  （扫描文件），

  sqlite-kl8

  （检查数据库健康状态）

扫描维度

1. 代码质量扫描

# 搜索 TODO / FIXME / HACK / DEPRECATED / BUG 标记
grep -r "TODO\|FIXME\|HACK\|DEPRECATED\|BUG\|XXX" backend/src/ --include="*.py"

# 搜索空 except 块（吞噬异常的危险模式）
grep -n "except.*pass" backend/src/

# 搜索硬编码的秘密或凭据
grep -rn "password\|api_key\|secret\|token" backend/src/ --include="*.py"

2. 科学一致性扫描（KL8 特有）

扫描是否有新引入的伪科学模式：

• 检查是否有新的

  np.mean(np.log(...))

  作为李雅普诺夫
• 检查是否有新引入的

  phi

  、

  golden

  、

  spatial_distance

  等伪科学关键词
• 检查融合层权重是否仍合计等于 1.0

3. 测试健康扫描

# 运行所有测试，找出失败项
cd backend && python -m pytest tests/ -v --tb=short 2>&1

4. 数据库健康扫描

通过

sqlite-kl8

MCP 服务器检查：

• backtest.db

  中最新记录时间戳
• 是否有孤立记录或异常数据

5. 依赖安全扫描

# 检查已知漏洞
pip-audit -r requirements.txt

输出格式

## 主动发现的问题 [日期]

### 🔴 高优先级（需立即处理）
- [ ] backend/src/core/xxx.py:45 — FIXME: 除零风险
- [ ] 测试覆盖率: select2_decision.py 仅 23%

### 🟡 中优先级（本周内）
- [ ] backend/src/services/gui_service.py — TODO: 添加错误处理

### 🟢 低优先级（技术债务）
- [ ] chaos_features.py 的 `complexity` 字段已改名，需更新调用者

触发条件

• 用户请求: "扫描一下系统"、"有什么问题"、"主动检查"
• 定期: 每次完成重大功能后自动触发一次