self-evolve-framework 1.0.5 → 1.0.7

package/README.md

@@ -4,6 +4,16 @@
 >
 > ⚠️ 此包专为 [CodeBuddy](https://www.codebuddy.ai) 设计，依赖 `.codebuddy/rules/` 和 `.codebuddy/skills/` 目录结构，非 CodeBuddy 环境无效。
 
+## 由来
+
+维护了两个项目，各自打磨了一套 Skill 规则。每次改进都要在两边重复复制粘贴，很快变得难以同步。直到 AI 建议："为什么不打包成 npm 包？"
+
+于是有了 Self-Evolve Framework。
+
+一套规则，`npx` 即用，两边同步，不再需要手动搬运。
+
+这本质上是一个私人工具箱——觉得好用的 Skill、好用的规则，会持续往里集成。方便自己，也顺手方便别人。
+
 ## 安装
 
 ```bash
@@ -22,6 +32,9 @@ npx self-evolve-framework init --dry-run
 
 # 跳过 CLAUDE.md 更新
 npx self-evolve-framework init --skip-claude-md
+
+# 跳过 Impeccable 设计质量工具安装
+npx self-evolve-framework init --skip-impeccable
 ```
 
 ## 安装了什么
@@ -37,13 +50,16 @@ npx self-evolve-framework init --skip-claude-md
 CLAUDE.md                  ← 追加自我进化章节
 ```
 
+安装过程还会自动运行 `npx impeccable install` 安装 [Impeccable](https://impeccable.style) 设计质量检查工具（可用 `--skip-impeccable` 跳过）。
+首次使用前请在 CodeBuddy 对话中运行 `/impeccable init` 创建设计上下文。<!-- 命令由 Impeccable 技能处理 -->
+
 ## 使用
 
 ### 每日自动生效
 
 self-evolve rule 在每个对话中 always 激活：
-- **改代码前** → Ponytail 检查 + CodeGraph 影响评估
-- **改代码后** → 自动 `npm run build` + `cargo check` 验证
+- **改代码前** → Ponytail 检查 + CodeGraph 影响评估 + 核心边界审计
+- **改代码后** → 自动 `npm run build` + `cargo check` 验证 + Impeccable 设计审计
 - **验证失败** → 分析修复 → 记录到记忆 → ≥2 次同模式 → 自动写规则
 - **会话结束** → 超 7 天未审计 → 提醒
 
@@ -55,8 +71,15 @@ self-evolve rule 在每个对话中 always 激活：
 skillopt-sleep dry-run    → 每日健康检查，5 秒出报告
 skillopt-sleep run        → 周改进提案
 skillopt-sleep adopt      → 采纳建议
+impeccable audit           → 设计质量技术审计
+impeccable critique        → 设计评审
+impeccable polish          → 页面润色
 ```
 
+### 设计上下文
+
+Impeccable 首次使用前运行 `/impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`。<!-- 该命令由 Impeccable 技能处理 -->
+
 ## 前提
 
 - CodeBuddy IDE（VSCode 系）
@@ -68,13 +91,13 @@ skillopt-sleep adopt      → 采纳建议
 ```
 self-evolve-framework/
 ├── package.json          # npm 包配置
-├── bin/cli.js            # CLI 安装工具
+├── bin/cli.js            # CLI 安装工具（含 Impeccable 自动安装）
 ├── template/
 │   ├── rules/
-│   │   ├── self-evolve.mdc
+│   │   ├── self-evolve.mdc   ← 编排层（含 Impeccable 集成）
 │   │   └── ponytail.mdc
 │   └── skills/
 │       └── skillopt-sleep/
-│           └── SKILL.md
+│           └── SKILL.md      ← 离线进化引擎（含设计质量分析）
 └── README.md
 ```

package/bin/cli.js

@@ -33,12 +33,13 @@ function showHelp() {
   选项:
     --project <path>      指定目标项目路径（默认当前目录）
     --skip-claude-md      跳过更新 CLAUDE.md
+    --skip-impeccable     跳过安装 Impeccable 设计质量工具
     --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
+    npx self-evolve-framework init --skip-claude-md --skip-impeccable --dry-run
   `)
 }
 
@@ -46,6 +47,7 @@ async function init(args) {
   const baseDir = resolve(args["--project"] || process.cwd())
   const dryRun = !!args["--dry-run"]
   const skipClaudeMd = !!args["--skip-claude-md"]
+  const skipImpeccable = !!args["--skip-impeccable"]
 
   console.log(`📍 项目路径: ${baseDir}`)
   console.log(`🧪 ${dryRun ? "DRY RUN — 不写入文件" : "执行中..."}\n`)
@@ -67,6 +69,25 @@ async function init(args) {
     count++
   }
 
+  // 安装 Impeccable 设计质量工具
+  if (!skipImpeccable) {
+    if (!dryRun) {
+      try {
+        console.log("\n📐 正在安装 Impeccable（设计质量检查工具）...")
+        const { execSync } = await import("child_process")
+        execSync("npx --yes impeccable install", { cwd: baseDir, stdio: "inherit" })
+        console.log("  ✅ Impeccable 安装完成")
+        console.log("  ℹ️  运行 /impeccable init 创建设计上下文（DESIGN.md + PRODUCT.md）")
+        count++
+      } catch {
+        console.log("  ⚠️  Impeccable 安装失败（网络问题？），可稍后手动运行 npx impeccable install")
+      }
+    } else {
+      console.log("  🔍 将安装  Impeccable（npx impeccable install）")
+      count++
+    }
+  }
+
   // 更新 CLAUDE.md
   if (!skipClaudeMd) {
     const claudePath = resolve(baseDir, "CLAUDE.md")
@@ -74,7 +95,7 @@ async function init(args) {
 ## 自我进化（always 激活）
 
 统一由 \`.codebuddy/rules/self-evolve.mdc\` 编排。
-调度 Ponytail（代码最小化）+ CodeGraph（依赖分析）+ Skillopt-Sleep（离线进化）
+调度 Ponytail（代码最小化）+ CodeGraph（依赖分析）+ Skillopt-Sleep（离线进化）+ Impeccable（设计质量）
 → 形成 **post-edit 验证 → 错误记忆 → 规则推荐** 闭环。
 `
     if (existsSync(claudePath)) {
@@ -102,6 +123,7 @@ async function init(args) {
     console.log("\n📖 使用指南（在 CodeBuddy 对话中输入）：")
     console.log("  skillopt-sleep dry-run  → 每日健康检查")
     console.log("  skillopt-sleep run      → 周改进提案")
+    console.log("  impeccable audit/critique  → 设计质量审查")
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "self-evolve-framework",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "CodeBuddy 自我进化飞轮 — 仅适用于 CodeBuddy IDE。Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析",
   "type": "module",
   "bin": {

package/template/rules/self-evolve.mdc

@@ -13,6 +13,8 @@ alwaysApply: true
 self-evolve.mdc（编排层 — 当前文件）
   ├── ponytail.mdc       → 代码最小化检查（每个操作前）
   ├── CodeGraph MCP       → 依赖图分析（重构/调 bug 时）
+  ├── 核心边界审计        → 删/改功能前确认承重墙（本文件内联）
+  ├── Impeccable           → 设计质量审计（前端修改后自动触发）
   └── skillopt-sleep      → 离线进化分析（按需调）
        ↓
   post-edit 验证闭环 ← ⭐ 核心
@@ -24,21 +26,28 @@ self-evolve.mdc（编排层 — 当前文件）
 
 ### 步骤 1：前置检查（修改前）
 ```
-┌─ 修改范围 > 3 个文件？──→ 调 Ponytail 约束 → 询问用户是否可缩小
-└─ 重构/修复 bug？─────→ 调 CodeGraph MCP → 评估影响范围
+┌─ 修改范围 > 3 个文件？──────→ 调 Ponytail 约束 → 询问用户是否可缩小
+├─ 重构/修复 bug？─────────→ 调 CodeGraph MCP → 评估影响范围
+└─ ★ 删/重构功能代码？──────→ 核心边界审计 → 问"这段代码影响哪条用户路径？删了谁兜底？"
 ```
 
 ### 步骤 2：执行修改
 按 Ponytail 原则写最少代码。
 
+**核心边界约束**：如果涉及功能删减，确保受影响的核心路径有替代方案兜底，并在注释或 commit 信息中注明承重墙依据。
+
 ### 步骤 3：自动验证（修改后）
 ```
 1. 前端：运行 npm run build
    → 失败 → 分析错误 → 修复 → 重试 build → 最多 3 次
 2. Rust：在 src-tauri 目录运行 cargo check（如果存在）
    → 失败 → 分析错误 → 修复 → 重试 cargo check → 最多 3 次
-3. 全部通过 → 进入步骤 4
-4. 3 次仍失败 → 停止，向用户报告错误并请求协助
+3. ★ 设计质量：如果修改涉及前端文件（html/css/jsx/tsx/vue/svelte），
+   运行 npx impeccable detect（如果已安装）
+   → 发现 P0/P1 问题 → 修复 → 重新检测
+   → P2/P3 问题 → 记入记忆，下次会话再处理
+4. 全部通过 → 进入步骤 4
+5. 3 次仍失败 → 停止，向用户报告错误并请求协助
 ```
 
 ### 步骤 4：写入记忆
@@ -55,6 +64,11 @@ self-evolve.mdc（编排层 — 当前文件）
 
 同类型错误出现 ≥2 次 → 自动创建规则：
   create .codebuddy/rules/{pattern-name}.mdc
+
+涉及核心功能路径的修改，额外记录：
+  - 受影响路径
+  - 兜底方案
+  - 当前依赖方（谁在调用/依赖这段代码）
 ```
 
 ### 步骤 5：会话结束检查
@@ -63,6 +77,25 @@ self-evolve.mdc（编排层 — 当前文件）
   → 超过 7 天 → 提示："项目已 {N} 天未审计，需要跑 skillopt-sleep 吗？"
 ```
 
+## 🔧 核心边界审计规则
+
+> 删改功能代码前必经的一道门——不是阻止删，而是确保删之前知道不能丢什么。
+
+### 审计步骤
+
+```
+1. 定位：这段代码影响哪些用户可见的功能路径？
+2. 溯源：谁在调用/依赖这段代码？→ 调 codegraph_callers
+3. 兜底：如果没有这段代码，受影响的功能还有没有其他实现路径？
+4. 结论：
+   ✅ 有兜底 → 可以删，commit 信息注明兜底方案
+   ⚠️ 无兜底 → 不能直接删，先补兜底或向用户说明风险
+```
+
+### 关键词触发
+
+`删除`、`弃用`、`移除`、`deprecated`、`不再需要`、`改接口`、`重构`
+
 ## 🔧 CodeGraph MCP 使用规则
 
 | 场景 | 必须调用的工具 |
@@ -84,6 +117,37 @@ self-evolve.mdc（编排层 — 当前文件）
 | `skillopt-sleep run` | 每周总结时（生成周改进提案） |
 | `skillopt-sleep adopt` | 审阅后采纳建议 |
 
+## 🔧 Impeccable 设计质量规则
+
+> 当项目已安装 [Impeccable](https://impeccable.style) 时，每次前端修改自动触发设计审计。
+
+### 自动审计触发条件
+
+```
+触发时机：步骤 3（自动验证）中检测到前端文件改动
+运行命令：npx impeccable detect
+质量分级：
+  P0（阻断）→ 立即修复
+  P1（严重）→ 立即修复
+  P2（一般）→ 记入记忆，下次会话处理
+  P3（建议）→ 记入记忆，下次会话处理
+```
+
+### 按需审查
+
+在 CodeBuddy 对话中输入：
+
+| 命令 | 作用 |
+|------|------|
+| `impeccable audit` | 五维度技术质量检查 |
+| `impeccable critique` | 设计评审（评分 + 角色测试） |
+| `impeccable polish` | 最终润色打磨 |
+| `impeccable detect` | 自动检测反模式 |
+
+### 设计上下文
+
+首次使用前运行 `/impeccable init`，生成 `PRODUCT.md` 和 `DESIGN.md` 作为设计上下文，让审计更精准。
+
 ## 记忆存储路径
 
 ```text

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

@@ -15,6 +15,8 @@ AI 从以下来源收集项目数据：
 - 构建/编译错误记录（从 `.codebuddy/memory/`）
 - 已知问题列表
 - 现有规则集（`.codebuddy/rules/`）
+- 设计上下文（`PRODUCT.md`、`DESIGN.md`，如果存在）
+- 前端文件的设计质量报告（如果安装了 Impeccable，运行 `npx impeccable detect` 或读取历史记录）
 
 ### 阶段 2：Mine — 挖掘模式
 分析收集到的数据，识别：
@@ -22,6 +24,8 @@ AI 从以下来源收集项目数据：
 - **代码异嗅**：循环依赖、过度耦合、重复代码
 - **缺失约束**：重复发生但无规则防范的问题
 - **优化机会**：可简化的逻辑、可合并的文件
+- **★ 核心边界**：识别模块间的契约接口、关键用户路径和其依赖方，标记"改/删前必须审慎"的承重区域
+- **★ 设计异嗅**：分析 Impeccable 检测报告中的 P0/P1 反复出现的问题模式，识别设计约束缺失或 DESIGN.md 与实现不一致的区域
 
 ### 阶段 3：Replay — 回放验证
 对每个发现的问题：
@@ -35,6 +39,7 @@ AI 从以下来源收集项目数据：
 - **更新规则**：现有规则描述模糊或过时
 - **删除规则**：不再相关或从未被触发的规则
 - **优化 memory**：合并重复的错误模式记录
+- **★ 边界标记**：涉及核心功能路径的删除/修改建议，加 ⚠️ 标签要求人工确认，不可自动采纳
 
 ### 阶段 5：Stage — 暂存
 所有建议先写入 `.codebuddy/memory/skillopt-staging/` 目录，**不修改任何活文件**。