skill-auto-evolve

name	skill-auto-evolve
description	Automatically fix, enhance, and optimize other skills when problems occur. Use when a skill fails or produces unexpected results. Prevents similar issues in the future.

Skill Auto-Evolve

这个 skill 用于自动修复、增强和优化其他 skill。当一个 skill 执行失败或产生意外结果时，自动分析问题并更新对应的 skill 文件。

触发条件

当出现以下情况时自动触发：

1. Skill 执行失败（返回错误）
2. Skill 执行超时
3. Skill 输出与预期不符
4. 用户明确表示某个 skill 有问题

工作流程

1. 问题诊断

首先确定问题类型：

错误类型	诊断方法
脚本超时	检查 timeout 配置，网络状态
依赖缺失	检查 node_modules，npm install
Cookie 过期	检查 cookies.json 的 expires 字段
选择器失效	检查目标网站 DOM 结构变化
参数错误	检查传入参数格式和内容
路径问题	检查相对/绝对路径

2. 问题记录

在 skill 目录下创建 issues/ 子目录，记录问题：

# issues/YYYY-MM-DD-issue-name.md

## 问题描述
[错误信息或现象]

## 诊断过程
[分析步骤]

## 根本原因
[根本原因]

## 修复方案
[解决方案]

## 验证结果
[修复后的测试结果]

3. Skill 更新

根据问题类型更新 SKILL.md：

## 已知问题与解决方案

### 问题：[问题名称]
**症状**：[错误表现]
**原因**：[根本原因]
**解决**：[修复方法]

### 问题：[问题名称]
...

4. 脚本修复

如果是脚本问题，直接修复脚本：

# 常见修复模式

# 1. 增加超时时间
timeout: 60000  # 从 30000 增加到 60000

# 2. 添加重试逻辑
async function retry(fn, times = 3) {
  for (let i = 0; i < times; i++) {
    try {
      return await fn()
    } catch (e) {
      if (i === times - 1) throw e
      await sleep(1000 * (i + 1))
    }
  }
}

# 3. 添加错误处理
try {
  // 操作
} catch (error) {
  console.error('详细错误:', error)
  await page.screenshot({ path: 'debug-error.png' })
  throw error
}

5. 验证修复

修复后运行测试验证：

# 重新执行失败的 skill
node [script].js [args]

# 检查输出
echo $?  # 0 表示成功

常见问题模板

Puppeteer 超时

// 修复方案：增加超时和重试
const browser = await puppeteer.launch({
  headless: false,  // 调试时设为 false
  args: ['--no-sandbox', '--disable-setuid-sandbox'],
  protocolTimeout: 120000,  // 增加协议超时
})

await page.goto(url, {
  waitUntil: 'networkidle2',
  timeout: 60000,  // 增加导航超时
})

Cookie 过期

// 检查 cookie 有效性
function checkCookieExpiry(cookies) {
  const now = Date.now() / 1000
  for (const cookie of cookies) {
    if (cookie.expires && cookie.expires < now) {
      console.warn(`Cookie ${cookie.name} 已过期`)
      return false
    }
  }
  return true
}

选择器失效

// 使用多个备选选择器
const selectors = [
  '.new-selector',
  '.old-selector',
  '[data-testid="target"]'
]

for (const selector of selectors) {
  try {
    await page.waitForSelector(selector, { timeout: 5000 })
    break
  } catch (e) {
    continue
  }
}

输出格式

修复完成后输出：

✅ Skill 已自动更新

📍 Skill: [skill-name]
🐛 问题: [问题描述]
🔧 修复: [修复内容]
📁 更新文件: [SKILL.md / script.js]

验证: [成功/失败]

使用方法

/skill-auto-evolve [失败的skill名称] [错误信息]

例如：

/skill-auto-evolve zhihu-publish "Navigation timeout of 30000 ms exceeded"