self-evolve-framework 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# Self-Evolve Framework
+
+> 可复用的 CodeBuddy 自我进化飞轮 — Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析
+
+## 安装
+
+```bash
+# 方式 1：npx（推荐，零安装）
+npx self-evolve-framework init
+
+# 方式 2：全局安装
+npm install -g self-evolve-framework
+self-evolve init
+
+# 方式 3：项目依赖
+npm install --save-dev self-evolve-framework
+npx self-evolve init
+```
+
+### 选项
+
+```bash
+# 指定项目路径
+npx self-evolve-framework init --project ./my-app
+
+# 预览模式（不写入任何文件）
+npx self-evolve-framework init --dry-run
+
+# 跳过 CLAUDE.md 更新
+npx self-evolve-framework init --skip-claude-md
+```
+
+## 安装了什么
+
+```
+.codebuddy/
+├── rules/
+│   ├── self-evolve.mdc    ← 编排层（always 激活）
+│   └── ponytail.mdc       ← 代码最小化原则
+├── skills/
+│   └── skillopt-sleep/
+│       └── SKILL.md       ← 离线进化分析
+CLAUDE.md                  ← 追加自我进化章节
+```
+
+## 使用
+
+### 每日自动生效
+
+self-evolve rule 在每个对话中 always 激活：
+- **改代码前** → Ponytail 检查 + CodeGraph 影响评估
+- **改代码后** → 自动 `npm run build` + `cargo check` 验证
+- **验证失败** → 分析修复 → 记录到记忆 → ≥2 次同模式 → 自动写规则
+- **会话结束** → 超 7 天未审计 → 提醒
+
+### 按需检查
+
+```bash
+/skillopt dry-run    # 每日健康检查，5 秒出报告
+/skillopt run        # 周改进提案
+/skillopt adopt      # 采纳建议
+```
+
+## 前提
+
+- CodeBuddy IDE（VSCode 系）
+- 项目根目录下有 `.codebuddy/` 目录（自动创建）
+- 需要 CodeGraph MCP 服务器支持（可选，但推荐）
+
+## 文件结构
+
+```
+self-evolve-framework/
+├── package.json          # npm 包配置
+├── bin/cli.js            # CLI 安装工具
+├── template/
+│   ├── rules/
+│   │   ├── self-evolve.mdc
+│   │   └── ponytail.mdc
+│   └── skills/
+│       └── skillopt-sleep/
+│           └── SKILL.md
+└── README.md
+```

package/bin/cli.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync } from "fs"
+import { join, resolve } from "path"
+import { fileURLToPath } from "url"
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url))
+const TEMPLATE_DIR = resolve(__dirname, "../template")
+
+const COMMANDS = {
+  init: {
+    desc: "安装自我进化飞轮到当前项目",
+    run: async (args) => init(args),
+  },
+  sync: {
+    desc: "从源项目同步配置到当前项目",
+    run: async (args) => sync(args),
+  },
+  help: {
+    desc: "显示帮助信息",
+    run: () => showHelp(),
+  },
+}
+
+function showHelp() {
+  console.log(`
+  self-evolve — CodeBuddy 自我进化飞轮安装工具
+
+  用法:
+    npx self-evolve-framework init       安装到当前项目
+    npx self-evolve-framework sync       从源项目同步
+
+  选项:
+    --project <path>      指定目标项目路径（默认当前目录）
+    --skip-claude-md      跳过更新 CLAUDE.md
+    --dry-run             预览要复制的文件，不实际写入
+
+  示例:
+    npx self-evolve-framework init
+    npx self-evolve-framework init --project ./my-app
+    npx self-evolve-framework init --skip-claude-md --dry-run
+  `)
+}
+
+async function init(args) {
+  const baseDir = resolve(args["--project"] || process.cwd())
+  const dryRun = !!args["--dry-run"]
+  const skipClaudeMd = !!args["--skip-claude-md"]
+
+  console.log(`📍 项目路径: ${baseDir}`)
+  console.log(`🧪 ${dryRun ? "DRY RUN — 不写入文件" : "执行中..."}\n`)
+
+  // 要复制的目录映射：{ 源相对路径 → 目标相对路径 }
+  const dirs = [
+    { src: "rules",  dest: ".codebuddy/rules" },
+    { src: "skills/skillopt-sleep", dest: ".codebuddy/skills/skillopt-sleep" },
+  ]
+
+  let count = 0
+  for (const { src, dest } of dirs) {
+    const srcDir = resolve(TEMPLATE_DIR, src)
+    const destDir = resolve(baseDir, dest)
+    if (!existsSync(srcDir)) continue
+    if (!dryRun) mkdirSync(destDir, { recursive: true })
+    console.log(`${dryRun ? "  🔍 将复制" : "  ✅ 复制"}  ${src}/  →  ${dest}/`)
+    if (!dryRun) cpSync(srcDir, destDir, { recursive: true, force: true })
+    count++
+  }
+
+  // 更新 CLAUDE.md
+  if (!skipClaudeMd) {
+    const claudePath = resolve(baseDir, "CLAUDE.md")
+    const selfEvolveSection = `
+## 自我进化（always 激活）
+
+统一由 \`.codebuddy/rules/self-evolve.mdc\` 编排。
+调度 Ponytail（代码最小化）+ CodeGraph（依赖分析）+ Skillopt-Sleep（离线进化）
+→ 形成 **post-edit 验证 → 错误记忆 → 规则推荐** 闭环。
+`
+    if (existsSync(claudePath)) {
+      const content = readFileSync(claudePath, "utf-8")
+      if (!content.includes("自我进化")) {
+        if (!dryRun) {
+          writeFileSync(claudePath, content.trimEnd() + "\n" + selfEvolveSection + "\n")
+        }
+        console.log(`${dryRun ? "  🔍 将添加" : "  ✅ 添加"}  自我进化章节 → CLAUDE.md`)
+        count++
+      } else {
+        console.log("  ⏭️  跳过  CLAUDE.md 已包含自我进化章节")
+      }
+    } else {
+      if (!dryRun) {
+        writeFileSync(claudePath, `# ${resolve(baseDir).split(/[/\\]/).pop()} 项目约束\n${selfEvolveSection}\n`)
+      }
+      console.log(`${dryRun ? "  🔍 将创建" : "  ✅ 创建"}  CLAUDE.md（含自我进化章节）`)
+      count++
+    }
+  }
+
+  console.log(`\n${dryRun ? `🔍 预览完成，共 ${count} 项操作` : `✅ 已完成 ${count} 项操作 — 下次对话即可生效`}`)
+  if (!dryRun) {
+    console.log("\n📖 使用指南：")
+    console.log("  /skillopt dry-run  → 每日健康检查")
+    console.log("  /skillopt run      → 周改进提案")
+  }
+}
+
+async function sync(args) {
+  // 从 self-evolve-framework 项目中读取默认配置
+  const baseDir = resolve(args["--project"] || process.cwd())
+  const srcDir = resolve(args["--from"] || TEMPLATE_DIR.replace(/template$/, ""))
+  console.log(`从 ${srcDir} 同步配置到 ${baseDir}`)
+  await init({ ...args, "--project": baseDir })
+}
+
+// 入口
+const cmd = process.argv[2] || "help"
+const fn = COMMANDS[cmd]
+if (!fn) {
+  console.error(`未知命令: ${cmd}\n`)
+  showHelp()
+  process.exit(1)
+}
+
+// 解析命令行参数
+const args = {}
+for (let i = 3; i < process.argv.length; i++) {
+  const arg = process.argv[i]
+  if (arg.startsWith("--")) {
+    const next = process.argv[i + 1]
+    if (next && !next.startsWith("--")) {
+      args[arg] = next
+      i++
+    } else {
+      args[arg] = true
+    }
+  }
+}
+
+fn.run(args).catch((err) => {
+  console.error("❌ 错误:", err.message)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "self-evolve-framework",
+  "version": "1.0.0",
+  "description": "CodeBuddy 自我进化飞轮 — Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析",
+  "type": "module",
+  "bin": {
+    "self-evolve": "bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/cli.js help"
+  },
+  "keywords": [
+    "codebuddy",
+    "self-evolution",
+    "ponytail",
+    "skillopt"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-username/self-evolve-framework.git"
+  },
+  "files": [
+    "bin/",
+    "template/"
+  ]
+}

package/template/rules/ponytail.mdc

@@ -0,0 +1,33 @@
+---
+description: Ponytail - 懒人高级开发者模式。写最少、最安全的代码。
+alwaysApply: true
+---
+
+## Ponytail 核心规则
+
+在写任何代码之前，先停在能解决问题的**最低台阶**上，按优先级检查：
+
+1. **这东西真的需要建吗？**（YAGNI）不需要就跳过
+2. **标准库已经提供了吗？** 直接用它
+3. **平台/框架原生功能能覆盖吗？** 直接用它
+4. **已安装的依赖能解决吗？** 直接用它
+5. **能一行搞定吗？** 就写一行
+6. **以上都不行？** 才写最少工作的代码
+
+## 执行规则
+
+- 不要创建未经明确要求的抽象
+- 能不引入新依赖就别引入
+- 不要写没人要的样板代码
+- 删除优于添加，无聊优于花哨，文件数量越少越好
+- 质疑复杂需求："你真的需要 X，还是 Y 可以覆盖？"
+- 当两种方法长度相同时，选边界情况更正确的那一个
+- 有意的简化用 `ponytail:` 注释标注，写明已知上限和升级路径
+
+## 不偷懒的地方（必须认真对待）
+
+- 输入校验
+- 错误处理
+- 安全性
+- 可访问性
+- 任何明确要求的事情

package/template/rules/self-evolve.mdc

@@ -0,0 +1,93 @@
+---
+description: 自我进化飞轮 — 统一调度 Ponytail/CodeGraph/Skillopt-Sleep，形成 post-edit 验证→错误记忆→规则推荐闭环
+alwaysApply: true
+---
+
+# Self-Evolve：自我进化框架
+
+> 此规则编排整个进化飞轮。具体约束（代码最小化、工具选择）委托给子规则。
+
+## 调度架构
+
+```
+self-evolve.mdc（编排层 — 当前文件）
+  ├── ponytail.mdc       → 代码最小化检查（每个操作前）
+  ├── CodeGraph MCP       → 依赖图分析（重构/调 bug 时）
+  └── skillopt-sleep      → 离线进化分析（按需调）
+       ↓
+  post-edit 验证闭环 ← ⭐ 核心
+```
+
+## 🔄 核心工作流：Post-Edit 验证闭环
+
+**每次修改代码后必须执行以下流程：**
+
+### 步骤 1：前置检查（修改前）
+```
+┌─ 修改范围 > 3 个文件？──→ 调 Ponytail 约束 → 询问用户是否可缩小
+└─ 重构/修复 bug？─────→ 调 CodeGraph MCP → 评估影响范围
+```
+
+### 步骤 2：执行修改
+按 Ponytail 原则写最少代码。
+
+### 步骤 3：自动验证（修改后）
+```
+1. 前端：运行 npm run build
+   → 失败 → 分析错误 → 修复 → 重试 build → 最多 3 次
+2. Rust：在 src-tauri 目录运行 cargo check（如果存在）
+   → 失败 → 分析错误 → 修复 → 重试 cargo check → 最多 3 次
+3. 全部通过 → 进入步骤 4
+4. 3 次仍失败 → 停止，向用户报告错误并请求协助
+```
+
+### 步骤 4：写入记忆
+```text
+每次验证失败，用 update_memory 记录：
+  title: "Error Pattern: {错误类型简写}"
+  action: create
+  knowledge: |
+    - 日期: YYYY-MM-DD
+    - 文件: <涉及文件>
+    - 错误: ...
+    - 修复: ...
+    - 归因: 类型不匹配 / 调用错误 / 约定遗漏
+
+同类型错误出现 ≥2 次 → 自动创建规则：
+  create .codebuddy/rules/{pattern-name}.mdc
+```
+
+### 步骤 5：会话结束检查
+```
+检查 memory 中上次 skillopt-sleep 审计日期
+  → 超过 7 天 → 提示："项目已 {N} 天未审计，需要跑 skillopt-sleep 吗？"
+```
+
+## 🔧 CodeGraph MCP 使用规则
+
+| 场景 | 必须调用的工具 |
+|------|--------------|
+| 重构前 | `codegraph_impact` 评估影响范围 |
+| 修复 bug 时 | `codegraph_callers` / `codegraph_callees` 追溯调用链 |
+| 文件间调用关系 | `codegraph_context` 获取跨文件上下文 |
+| 理解模块架构 | `codegraph_explore` 探索模块结构 |
+
+关键词触发：`重构`、`修改`、`影响`、`调用链`、`谁用了`、`谁调了`、`为什么报错`
+
+## 🔧 Skillopt-Sleep 使用规则
+
+> 技能位于 `.codebuddy/skills/skillopt-sleep/SKILL.md`。
+
+| 命令 | 什么时候调 |
+|------|-----------|
+| `/skillopt dry-run` | 每日开始工作时（≥5 秒报告项目健康度） |
+| `/skillopt run` | 每周总结时（生成周改进提案） |
+| `/skillopt adopt` | 审阅后采纳建议 |
+
+## 记忆存储路径
+
+```text
+update_memory                    → 跨会话长期记忆（错误模式、审计日期）
+.codebuddy/memory/YYYY-MM-DD.md  → 每日工作记忆
+.codebuddy/memory/skillopt-staging/ → skillopt-sleep 暂存
+```

package/template/skills/skillopt-sleep/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: skillopt-sleep
+description: 离线自我进化引擎。分析历史会话、发现重复模式、优化项目 memory 和规则。用 AI 指令替代外部脚本。
+---
+
+# SkillOpt-Sleep — 自我进化引擎
+
+> 此技能是 CodeBuddy 适配版（纯指令模式，不依赖外部脚本）。
+
+## 工作流程（6 阶段）
+
+### 阶段 1：Harvest — 收集信息
+AI 从以下来源收集项目数据：
+- 项目文件结构、代码模式
+- 构建/编译错误记录（从 `.codebuddy/memory/`）
+- 已知问题列表
+- 现有规则集（`.codebuddy/rules/`）
+
+### 阶段 2：Mine — 挖掘模式
+分析收集到的数据，识别：
+- **重复错误**：同一类 build/lint 错误出现次数
+- **代码异嗅**：循环依赖、过度耦合、重复代码
+- **缺失约束**：重复发生但无规则防范的问题
+- **优化机会**：可简化的逻辑、可合并的文件
+
+### 阶段 3：Replay — 回放验证
+对每个发现的问题：
+- 如果已有关联规则 → 检查规则是否被遵循
+- 如果没有规则 → 评估是否需要新规则
+- 如果有修复方案 → 验证方案是否仍适用
+
+### 阶段 4：Consolidate — 合并优化
+生成改进建议，只接受通过 Held-out 门控的比例：
+- **新增规则**：重复 ≥2 次且无规则防范的问题
+- **更新规则**：现有规则描述模糊或过时
+- **删除规则**：不再相关或从未被触发的规则
+- **优化 memory**：合并重复的错误模式记录
+
+### 阶段 5：Stage — 暂存
+所有建议先写入 `.codebuddy/memory/skillopt-staging/` 目录，**不修改任何活文件**。
+
+### 阶段 6：Adopt — 采用
+列出所有建议，由你逐条决定是否采纳：
+```
+📋 待采用清单
+  ✅ 新增 rules/promise-chain-check.mdc → 防止未捕获 async 错误
+  ✅ 更新 rules/self-evolve.mdc → 增加 cargo check 验证步骤
+  ❌ 删除 rules/old-node-format.mdc → 节点格式已统一
+```
+
+## 常用命令（AI 模拟）
+
+```text
+/skillopt dry-run   → 执行阶段 1-3，输出分析报告，不写任何文件
+/skillopt run       → 执行阶段 1-5，输出暂存清单
+/skillopt adopt     → 采纳暂存清单中的建议
+```
+
+## 触发建议
+
+- **每日一次**：工作开始时调 `/skillopt dry-run`，花 30 秒看报告
+- **周五总结**：调 `/skillopt run` 生成周改进提案
+- **出现相同错误 2 次后**：不用调，self-evolve rule 会自动触发单条规则创建