self-evolve-framework 1.0.6 → 1.0.8

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
 ```
 
 ## 安装了什么
@@ -32,18 +45,23 @@ npx self-evolve-framework init --skip-claude-md
 │   ├── self-evolve.mdc    ← 编排层（always 激活）
 │   └── ponytail.mdc       ← 代码最小化原则
 ├── skills/
-│   └── skillopt-sleep/
-│       └── SKILL.md       ← 离线进化分析
+│   ├── skillopt-sleep/
+│   │   └── SKILL.md       ← 离线进化分析
+│   └── impeccable/
+│       └── SKILL.md       ← 设计质量审计
 CLAUDE.md                  ← 追加自我进化章节
 ```
 
+> 可选：用 `--skip-impeccable` 跳过 Impeccable skill 安装。
+> 首次使用前在 CodeBuddy 对话中输入 `impeccable init` 创建设计上下文。
+
 ## 使用
 
 ### 每日自动生效
 
 self-evolve rule 在每个对话中 always 激活：
-- **改代码前** → Ponytail 检查 + CodeGraph 影响评估
-- **改代码后** → 自动 `npm run build` + `cargo check` 验证
+- **改代码前** → Ponytail 检查 + CodeGraph 影响评估 + 核心边界审计
+- **改代码后** → 自动 `npm run build` + `cargo check` 验证 + Impeccable 设计审计
 - **验证失败** → 分析修复 → 记录到记忆 → ≥2 次同模式 → 自动写规则
 - **会话结束** → 超 7 天未审计 → 提醒
 
@@ -55,8 +73,15 @@ self-evolve rule 在每个对话中 always 激活：
 skillopt-sleep dry-run    → 每日健康检查，5 秒出报告
 skillopt-sleep run        → 周改进提案
 skillopt-sleep adopt      → 采纳建议
+impeccable audit           → 设计质量技术审计
+impeccable critique        → 设计评审
+impeccable polish          → 页面润色
 ```
 
+### 设计上下文
+
+在 CodeBuddy 对话中输入 `impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`，让后续审计更精准。
+
 ## 前提
 
 - CodeBuddy IDE（VSCode 系）
@@ -71,10 +96,12 @@ self-evolve-framework/
 ├── bin/cli.js            # CLI 安装工具
 ├── template/
 │   ├── rules/
-│   │   ├── self-evolve.mdc
+│   │   ├── self-evolve.mdc   ← 编排层（含 Impeccable 集成）
 │   │   └── ponytail.mdc
 │   └── skills/
-│       └── skillopt-sleep/
-│           └── SKILL.md
+│       ├── skillopt-sleep/
+│       │   └── SKILL.md      ← 离线进化引擎（含设计质量分析）
+│       └── impeccable/
+│           └── SKILL.md      ← 设计质量审计 skill
 └── README.md
 ```

package/bin/cli.js

@@ -33,12 +33,13 @@ function showHelp() {
   选项:
     --project <path>      指定目标项目路径（默认当前目录）
     --skip-claude-md      跳过更新 CLAUDE.md
+    --skip-impeccable     跳过复制 Impeccable skill
     --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`)
@@ -56,6 +58,11 @@ async function init(args) {
     { src: "skills/skillopt-sleep", dest: ".codebuddy/skills/skillopt-sleep" },
   ]
 
+  // 默认复制 impeccable skill（除非 --skip-impeccable）
+  if (!skipImpeccable) {
+    dirs.push({ src: "skills/impeccable", dest: ".codebuddy/skills/impeccable" })
+  }
+
   let count = 0
   for (const { src, dest } of dirs) {
     const srcDir = resolve(TEMPLATE_DIR, src)
@@ -74,7 +81,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 +109,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.6",
+  "version": "1.0.8",
   "description": "CodeBuddy 自我进化飞轮 — 仅适用于 CodeBuddy IDE。Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析",
   "type": "module",
   "bin": {

package/template/rules/self-evolve.mdc

@@ -14,6 +14,7 @@ self-evolve.mdc（编排层 — 当前文件）
   ├── ponytail.mdc       → 代码最小化检查（每个操作前）
   ├── CodeGraph MCP       → 依赖图分析（重构/调 bug 时）
   ├── 核心边界审计        → 删/改功能前确认承重墙（本文件内联）
+  ├── Impeccable           → 设计质量审计（前端修改后自动触发）
   └── skillopt-sleep      → 离线进化分析（按需调）
        ↓
   post-edit 验证闭环 ← ⭐ 核心
@@ -41,8 +42,12 @@ self-evolve.mdc（编排层 — 当前文件）
    → 失败 → 分析错误 → 修复 → 重试 build → 最多 3 次
 2. Rust：在 src-tauri 目录运行 cargo check（如果存在）
    → 失败 → 分析错误 → 修复 → 重试 cargo check → 最多 3 次
-3. 全部通过 → 进入步骤 4
-4. 3 次仍失败 → 停止，向用户报告错误并请求协助
+3. ★ 设计质量：如果修改涉及前端文件（html/css/jsx/tsx/vue/svelte），
+   调用 impeccable skill 检查设计质量（对话中输入 `impeccable detect`）
+   → 发现 P0/P1 问题 → 修复 → 重新检测
+   → P2/P3 问题 → 记入记忆，下次会话再处理
+4. 全部通过 → 进入步骤 4
+5. 3 次仍失败 → 停止，向用户报告错误并请求协助
 ```
 
 ### 步骤 4：写入记忆
@@ -112,6 +117,37 @@ self-evolve.mdc（编排层 — 当前文件）
 | `skillopt-sleep run` | 每周总结时（生成周改进提案） |
 | `skillopt-sleep adopt` | 审阅后采纳建议 |
 
+## 🔧 Impeccable 设计质量规则
+
+> 技能位于 `.codebuddy/skills/impeccable/SKILL.md`。每次前端修改自动触发设计审计。
+
+### 自动审计触发条件
+
+```
+触发时机：步骤 3（自动验证）中检测到前端文件改动
+执行方式：对话中输入 impeccable detect 调用 skill
+质量分级：
+  P0（阻断）→ 立即修复
+  P1（严重）→ 立即修复
+  P2（一般）→ 记入记忆，下次会话处理
+  P3（建议）→ 记入记忆，下次会话处理
+```
+
+### 按需审查
+
+在 CodeBuddy 对话中输入：
+
+| 命令 | 作用 |
+|------|------|
+| `impeccable audit` | 五维度技术质量检查 |
+| `impeccable critique` | 设计评审（评分 + 角色测试） |
+| `impeccable polish` | 最终润色打磨 |
+| `impeccable detect` | 自动检测反模式 |
+
+### 设计上下文
+
+首次使用前运行 `impeccable init`，生成 `PRODUCT.md` 和 `DESIGN.md` 作为设计上下文，让审计更精准。
+
 ## 记忆存储路径
 
 ```text

package/template/skills/impeccable/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: impeccable
+description: AI 前端设计质量审计。检测 UI 反模式、可访问性、布局一致性。扫描 html/css/jsx/tsx/vue/svelte 文件。
+---
+
+# Impeccable — 前端设计质量审计
+
+> CodeBuddy 适配版（纯指令模式，底层调用 `npx impeccable` 执行）。
+
+## 核心命令
+
+通过在对话中输入以下命令触发。执行时会调用 `npx impeccable <command>` 底层 CLI。
+
+| 对话输入 | 作用 | 底层调用 |
+|----------|------|---------|
+| `impeccable audit` | 五维度技术质量检查（P0-P3 严重性分级） | `npx impeccable audit` |
+| `impeccable critique` | 设计评审（评分 + 可用性测试） | `npx impeccable critique` |
+| `impeccable polish` | 页面最终润色打磨 | `npx impeccable polish` |
+| `impeccable detect` | 自动检测反模式 | `npx impeccable detect` |
+| `impeccable layout` | 修复布局、间距和视觉节奏 | `npx impeccable layout` |
+| `impeccable typeset` | 修复排版问题 | `npx impeccable typeset` |
+| `impeccable colorize` | 为单色界面添加颜色 | `npx impeccable colorize` |
+| `impeccable clarify` | 重写混淆的 UX 文案 | `npx impeccable clarify` |
+| `impeccable distill` | 简化界面，去除多余元素 | `npx impeccable distill` |
+| `impeccable harden` | 使界面更健壮（处理边界情况） | `npx impeccable harden` |
+| `impeccable optimize` | 诊断并修复 UI 性能问题 | `npx impeccable optimize` |
+| `impeccable init` | 创建设计上下文（PRODUCT.md + DESIGN.md） | `npx impeccable init` |
+| `impeccable craft` | 设计并构建一个新功能 | `npx impeccable craft` |
+| `impeccable shape` | 生成设计简报 | `npx impeccable shape` |
+
+## 质量分级
+
+```
+P0（阻断）→ 修复后才能继续
+P1（严重）→ 当前会话修复
+P2（一般）→ 记入记忆，下次处理
+P3（建议）→ 记入记忆，下次处理
+```
+
+## 设计上下文
+
+`impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`。这两份文件作为设计上下文，能让后续审计更精准。
+
+## 在工作流中的位置
+
+详见 `.codebuddy/rules/self-evolve.mdc` 步骤 3（自动验证）：
+每次修改前端文件后，自动检查设计质量，仅当发现 P0/P1 问题才中断流程。

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

@@ -15,6 +15,8 @@ AI 从以下来源收集项目数据：
 - 构建/编译错误记录（从 `.codebuddy/memory/`）
 - 已知问题列表
 - 现有规则集（`.codebuddy/rules/`）
+- 设计上下文（`PRODUCT.md`、`DESIGN.md`，如果存在）
+- 前端文件的设计质量报告（如果安装了 Impeccable skill，调用 `impeccable detect` 检查项目前端设计质量）
 
 ### 阶段 2：Mine — 挖掘模式
 分析收集到的数据，识别：
@@ -23,6 +25,7 @@ AI 从以下来源收集项目数据：
 - **缺失约束**：重复发生但无规则防范的问题
 - **优化机会**：可简化的逻辑、可合并的文件
 - **★ 核心边界**：识别模块间的契约接口、关键用户路径和其依赖方，标记"改/删前必须审慎"的承重区域
+- **★ 设计异嗅**：分析 Impeccable 检测报告中的 P0/P1 反复出现的问题模式，识别设计约束缺失或 DESIGN.md 与实现不一致的区域
 
 ### 阶段 3：Replay — 回放验证
 对每个发现的问题：