self-evolve-framework 1.0.7 → 1.0.8

package/README.md

@@ -45,13 +45,15 @@ npx self-evolve-framework init --skip-impeccable
 │   ├── self-evolve.mdc    ← 编排层（always 激活）
 │   └── ponytail.mdc       ← 代码最小化原则
 ├── skills/
-│   └── skillopt-sleep/
-│       └── SKILL.md       ← 离线进化分析
+│   ├── skillopt-sleep/
+│   │   └── SKILL.md       ← 离线进化分析
+│   └── impeccable/
+│       └── SKILL.md       ← 设计质量审计
 CLAUDE.md                  ← 追加自我进化章节
 ```
 
-安装过程还会自动运行 `npx impeccable install` 安装 [Impeccable](https://impeccable.style) 设计质量检查工具（可用 `--skip-impeccable` 跳过）。
-首次使用前请在 CodeBuddy 对话中运行 `/impeccable init` 创建设计上下文。<!-- 命令由 Impeccable 技能处理 -->
+> 可选：用 `--skip-impeccable` 跳过 Impeccable skill 安装。
+> 首次使用前在 CodeBuddy 对话中输入 `impeccable init` 创建设计上下文。
 
 ## 使用
 
@@ -78,7 +80,7 @@ impeccable polish          → 页面润色
 
 ### 设计上下文
 
-Impeccable 首次使用前运行 `/impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`。<!-- 该命令由 Impeccable 技能处理 -->
+在 CodeBuddy 对话中输入 `impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`，让后续审计更精准。
 
 ## 前提
 
@@ -91,13 +93,15 @@ Impeccable 首次使用前运行 `/impeccable init` 生成 `PRODUCT.md` 和 `DES
 ```
 self-evolve-framework/
 ├── package.json          # npm 包配置
-├── bin/cli.js            # CLI 安装工具（含 Impeccable 自动安装）
+├── bin/cli.js            # CLI 安装工具
 ├── template/
 │   ├── rules/
 │   │   ├── 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,7 +33,7 @@ function showHelp() {
   选项:
     --project <path>      指定目标项目路径（默认当前目录）
     --skip-claude-md      跳过更新 CLAUDE.md
-    --skip-impeccable     跳过安装 Impeccable 设计质量工具
+    --skip-impeccable     跳过复制 Impeccable skill
     --dry-run             预览要复制的文件，不实际写入
 
   示例:
@@ -58,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)
@@ -69,25 +74,6 @@ 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")

package/package.json

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

package/template/rules/self-evolve.mdc

@@ -43,7 +43,7 @@ self-evolve.mdc（编排层 — 当前文件）
 2. Rust：在 src-tauri 目录运行 cargo check（如果存在）
    → 失败 → 分析错误 → 修复 → 重试 cargo check → 最多 3 次
 3. ★ 设计质量：如果修改涉及前端文件（html/css/jsx/tsx/vue/svelte），
-   运行 npx impeccable detect（如果已安装）
+   调用 impeccable skill 检查设计质量（对话中输入 `impeccable detect`）
    → 发现 P0/P1 问题 → 修复 → 重新检测
    → P2/P3 问题 → 记入记忆，下次会话再处理
 4. 全部通过 → 进入步骤 4
@@ -119,13 +119,13 @@ self-evolve.mdc（编排层 — 当前文件）
 
 ## 🔧 Impeccable 设计质量规则
 
-> 当项目已安装 [Impeccable](https://impeccable.style) 时，每次前端修改自动触发设计审计。
+> 技能位于 `.codebuddy/skills/impeccable/SKILL.md`。每次前端修改自动触发设计审计。
 
 ### 自动审计触发条件
 
 ```
 触发时机：步骤 3（自动验证）中检测到前端文件改动
-运行命令：npx impeccable detect
+执行方式：对话中输入 impeccable detect 调用 skill
 质量分级：
   P0（阻断）→ 立即修复
   P1（严重）→ 立即修复
@@ -146,7 +146,7 @@ self-evolve.mdc（编排层 — 当前文件）
 
 ### 设计上下文
 
-首次使用前运行 `/impeccable init`，生成 `PRODUCT.md` 和 `DESIGN.md` 作为设计上下文，让审计更精准。
+首次使用前运行 `impeccable init`，生成 `PRODUCT.md` 和 `DESIGN.md` 作为设计上下文，让审计更精准。
 
 ## 记忆存储路径
 

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

@@ -16,7 +16,7 @@ AI 从以下来源收集项目数据：
 - 已知问题列表
 - 现有规则集（`.codebuddy/rules/`）
 - 设计上下文（`PRODUCT.md`、`DESIGN.md`，如果存在）
-- 前端文件的设计质量报告（如果安装了 Impeccable，运行 `npx impeccable detect` 或读取历史记录）
+- 前端文件的设计质量报告（如果安装了 Impeccable skill，调用 `impeccable detect` 检查项目前端设计质量）
 
 ### 阶段 2：Mine — 挖掘模式
 分析收集到的数据，识别：