Self-Evolve Framework

CodeBuddy IDE 自我进化飞轮 — Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析

⚠️ 此包专为 CodeBuddy 设计，依赖 .codebuddy/rules/ 和 .codebuddy/skills/ 目录结构，非 CodeBuddy 环境无效。

由来

维护了两个项目，各自打磨了一套 Skill 规则。每次改进都要在两边重复复制粘贴，很快变得难以同步。直到 AI 建议："为什么不打包成 npm 包？"

于是有了 Self-Evolve Framework。

一套规则，npx 即用，两边同步，不再需要手动搬运。

这本质上是一个私人工具箱——觉得好用的 Skill、好用的规则，会持续往里集成。方便自己，也顺手方便别人。

安装

# npx（推荐，零安装）
npx self-evolve-framework

选项

# 指定项目路径
npx self-evolve-framework --project ./my-app

# 预览模式（不写入任何文件）
npx self-evolve-framework --dry-run

# 跳过 CLAUDE.md 更新
npx self-evolve-framework --skip-claude-md

# 跳过 Impeccable 设计质量工具安装
npx self-evolve-framework --skip-impeccable

CLI 命令

self-evolve              # 默认安装/升级
self-evolve auth         # 一键 GitHub 认证
self-evolve list         # 列出规则和技能
self-evolve help [cmd]   # 帮助

GitHub 令牌（可选）

修改了规则但不想丢失？设置令牌后，CLI 自动将你的修改提交为 GitHub issue。

1. 创建令牌

GitHub → 右上角头像 → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token

| 字段 | 值 | |------|---| | Token name | self-evolve | | Expiration | 自定义（建议 90 天） | | Repository access | Only select repositories → 13944709532/self-evolve-framework | | Permissions | Issues: Read & Write |

点 Generate token，复制生成的 github_pat_xxx...

2. 设置环境变量

# CMD
set GITHUB_TOKEN=github_pat_XXXX

# PowerShell
$env:GITHUB_TOKEN="github_pat_XXXX"

然后正常使用——检测到修改会自动提 issue：

self-evolve           # 有 token → 自动提 issue，无 token → 只报告

CLI 优先读 GITHUB_TOKEN（GitHub CLI 用户的常用变量），其次读 SELF_EVOLVE_TOKEN。

安装了什么

.codebuddy/
├── rules/
│   ├── self-evolve.mdc    ← 编排层（always 激活）
│   ├── ponytail.mdc       ← 代码最小化原则
│   └── knowledge/         ← 经验知识库（按语言/框架分目录）
│       ├── general.mdc      ← 跨语言通用约束（always）
│       ├── typescript.mdc   ← TS/JS 前端语言层（按需）
│       ├── vue.mdc          ← Vue 框架层（按需）
│       ├── ant-design-vue.mdc← ant-design-vue 组件库层（按需）
│       ├── svelte.mdc       ← Svelte 5 框架层（按需）
│       ├── tailwind.mdc     ← Tailwind CSS v4 框架层（按需）
│       ├── shadcn-svelte.mdc← shadcn-svelte 组件库层（按需）
│       ├── rust.mdc         ← Rust 后端层（按需）
│       └── tauri.mdc        ← Tauri 框架层（按需）
├── skills/
│   ├── skillopt-sleep/           ← 离线进化分析
│   ├── impeccable/               ← 设计质量审计
│   └── sync-docs/                ← 项目文档自动对齐
CLAUDE.md                         ← 追加自我进化章节

使用

每日自动生效

self-evolve rule 在每个对话中 always 激活：

• 改代码前 → Ponytail 检查 + CodeGraph 影响评估 + 核心边界审计
• 改代码后 → 自动 npm run build + cargo check 验证 + Impeccable 设计审计
• 验证失败 → 分析修复 → 记录到记忆 → ≥2 次同模式 → 自动写规则
• 会话结束 → 超 7 天未审计 → 提醒

按需检查

在 CodeBuddy 对话中输入以下内容触发：

skillopt-sleep dry-run    → 每日健康检查，5 秒出报告
skillopt-sleep run        → 周改进提案
skillopt-sleep adopt      → 采纳建议
impeccable audit           → 设计质量技术审计
impeccable critique        → 设计评审
impeccable polish          → 页面润色
sync-docs                  → 项目文档对齐

设计上下文

在 CodeBuddy 对话中输入 impeccable init 生成 PRODUCT.md 和 DESIGN.md，让后续审计更精准。

前提

• CodeBuddy IDE（VSCode 系）
• 项目根目录下有 .codebuddy/ 目录（自动创建）
• 需要 CodeGraph MCP 服务器支持（可选，但推荐）

文件结构

self-evolve-framework/
├── package.json          # npm 包配置
├── bin/
│   └── self-evolve.js    ← CLI 入口壳
├── src/cli/              ← CLI 命令中枢
│   ├── commands/init.js, list.js
│   └── utils.js
├── rules/                ← 规则（直接消费）
│   ├── self-evolve.mdc   ← 编排层
│   ├── ponytail.mdc      ← 代码最小化
│   └── knowledge/        ← 经验知识库
│       ├── general.mdc / typescript.mdc / vue.mdc / ...
│       ├── svelte.mdc / shadcn-svelte.mdc / tailwind.mdc
│       └── rust.mdc / tauri.mdc / ant-design-vue.mdc
├── skills/               ← 技能（直接消费）
│   ├── skillopt-sleep/   ← 离线进化引擎
│   ├── impeccable/       ← 设计质量审计
│   └── sync-docs/        ← 文档自动对齐
├── docs/
├── AGENTS.md / CLAUDE.md / LICENSE
└── README.md