@huo15/openclaw-enhance 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# 🦞 龙虾增强包 (OpenClaw Enhancement Kit)
+
+> 非侵入式增强你的 OpenClaw Agent — 借鉴 Claude Code 的最佳实践
+
+## 功能模块
+
+| 模块 | 说明 | 工具 |
+|------|------|------|
+| **结构化记忆** | 按类型分类存储记忆（user/project/feedback/reference/decision） | `enhance_memory_store` `enhance_memory_search` `enhance_memory_review` |
+| **工具安全** | 可配置的工具调用拦截规则 + 审计日志 | `enhance_safety_log` `enhance_safety_rules` |
+| **提示词增强** | 自动注入任务分类、质量指引、记忆上下文 | 自动（通过 hook） |
+| **工作流自动化** | 触发词驱动的行为指令注入 | `enhance_workflow_define` `enhance_workflow_list` `enhance_workflow_delete` |
+| **仪表盘** | Web UI 查看记忆/安全/工作流状态 | `http://localhost:18789/enhance/` |
+
+## 增强技能
+
+| 技能 | 说明 |
+|------|------|
+| `plan-mode` | 结构化规划模式（借鉴 Claude Code Plan Agent） |
+| `explore-mode` | 深度探索模式（借鉴 Claude Code Explore Agent） |
+| `verify-mode` | 验证检查模式（借鉴 Claude Code Verification Agent） |
+| `memory-curator` | 记忆整理和优化 |
+
+## 安装
+
+```bash
+openclaw plugins install @huo15/openclaw-enhance
+```
+
+然后重启 OpenClaw：
+
+```bash
+openclaw restart
+```
+
+## 配置
+
+在 `openclaw.json` 中配置各模块：
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "enhance": {
+        "enabled": true,
+        "config": {
+          "memory": { "enabled": true, "autoCapture": true, "maxContextEntries": 5 },
+          "safety": {
+            "enabled": true,
+            "rules": [
+              { "tool": "exec", "pattern": "rm -rf *", "action": "block", "reason": "危险命令" }
+            ],
+            "defaultAction": "allow"
+          },
+          "prompt": { "enabled": true, "sections": ["qualityGuidelines", "memoryContext"] },
+          "workflows": { "enabled": true },
+          "dashboard": { "enabled": true }
+        }
+      }
+    }
+  }
+}
+```
+
+## 设计理念
+
+- **非侵入**: 不修改 OpenClaw 核心代码，完全通过插件 API
+- **模块化**: 每个模块可独立开关
+- **借鉴但不照搬**: 取 Claude Code 的精华，适配 OpenClaw 的架构
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,69 @@
+/**
+ * 龙虾增强包 (OpenClaw Enhancement Kit)
+ *
+ * 非侵入式增强插件：
+ * - 模块1: 结构化记忆系统（借鉴 Claude Code auto-memory）
+ * - 模块2: 工具安全守卫（借鉴 Claude Code 权限系统）
+ * - 模块3: 提示词增强（借鉴 Claude Code systemPromptSections）
+ * - 模块4: 工作流自动化（借鉴 Claude Code hooks 事件驱动）
+ * - 模块5: 增强仪表盘
+ */
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { registerStructuredMemory } from "./src/modules/structured-memory.js";
+import { registerToolSafety } from "./src/modules/tool-safety.js";
+import { registerPromptEnhancer } from "./src/modules/prompt-enhancer.js";
+import { registerWorkflowHooks } from "./src/modules/workflow-hooks.js";
+import { registerDashboard } from "./src/modules/dashboard.js";
+import type { EnhancePluginConfig } from "./src/types.js";
+
+export default definePluginEntry({
+  id: "enhance",
+  name: "龙虾增强包 (OpenClaw Enhancement Kit)",
+  description: "结构化记忆、工具安全守卫、提示词增强、工作流自动化、仪表盘",
+
+  register(api) {
+    const config = (api.pluginConfig ?? {}) as EnhancePluginConfig;
+
+    const modules: Array<{ name: string; enabled: boolean; load: () => void }> = [
+      {
+        name: "结构化记忆",
+        enabled: config.memory?.enabled !== false,
+        load: () => registerStructuredMemory(api, config.memory),
+      },
+      {
+        name: "工具安全",
+        enabled: config.safety?.enabled !== false,
+        load: () => registerToolSafety(api, config.safety),
+      },
+      {
+        name: "提示词增强",
+        enabled: config.prompt?.enabled !== false,
+        load: () => registerPromptEnhancer(api, config.prompt),
+      },
+      {
+        name: "工作流自动化",
+        enabled: config.workflows?.enabled !== false,
+        load: () => registerWorkflowHooks(api, config.workflows),
+      },
+      {
+        name: "仪表盘",
+        enabled: config.dashboard?.enabled !== false,
+        load: () => registerDashboard(api, config.dashboard),
+      },
+    ];
+
+    const loaded: string[] = [];
+    for (const mod of modules) {
+      if (mod.enabled) {
+        try {
+          mod.load();
+          loaded.push(mod.name);
+        } catch (err) {
+          api.logger.error(`[enhance] 模块「${mod.name}」加载失败:`, err);
+        }
+      }
+    }
+
+    api.logger.info(`[enhance] 龙虾增强包 v1.0.0 已加载，启用模块: ${loaded.join("、")}`);
+  },
+});

package/openclaw.plugin.json

@@ -0,0 +1,65 @@
+{
+  "id": "enhance",
+  "name": "龙虾增强包 (OpenClaw Enhancement Kit)",
+  "description": "非侵入式增强：结构化记忆、工具安全守卫、提示词增强、工作流自动化、仪表盘",
+  "version": "1.0.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "memory": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "autoCapture": { "type": "boolean", "default": true },
+          "maxContextEntries": { "type": "number", "default": 5 }
+        }
+      },
+      "safety": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "rules": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "tool": { "type": "string" },
+                "pattern": { "type": "string" },
+                "pathPattern": { "type": "string" },
+                "action": { "type": "string", "enum": ["block", "log", "allow"] },
+                "reason": { "type": "string" }
+              },
+              "required": ["tool", "action"]
+            },
+            "default": []
+          },
+          "defaultAction": { "type": "string", "enum": ["allow", "log"], "default": "allow" }
+        }
+      },
+      "prompt": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "sections": {
+            "type": "array",
+            "items": { "type": "string" },
+            "default": ["qualityGuidelines", "memoryContext"]
+          }
+        }
+      },
+      "workflows": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true }
+        }
+      },
+      "dashboard": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@huo15/openclaw-enhance",
+  "version": "1.0.0",
+  "description": "龙虾增强包 — 结构化记忆、工具安全、提示词增强、工作流自动化、仪表盘",
+  "type": "module",
+  "main": "index.ts",
+  "openclaw": {
+    "extensions": ["./index.ts"]
+  },
+  "bin": {
+    "openclaw-enhance-setup": "./scripts/setup.sh"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "enhance",
+    "memory",
+    "safety",
+    "agent"
+  ],
+  "author": "jobzhao15",
+  "license": "MIT",
+  "peerDependencies": {
+    "openclaw": ">=2026.2.24"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "typescript": "^5.5.0"
+  },
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "src/**/*",
+    "skills/**/*",
+    "templates/**/*",
+    "scripts/**/*"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jobzhao15/openclaw-enhance"
+  }
+}

package/scripts/setup.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+#
+# 龙虾增强包 — 一键安装脚本
+#
+# 用法:
+#   方式1: npx @huo15/openclaw-enhance setup
+#   方式2: bash <(curl -fsSL https://raw.githubusercontent.com/jobzhao15/openclaw-enhance/main/scripts/setup.sh)
+#
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+OPENCLAW_DIR="${OPENCLAW_HOME:-$HOME/.openclaw}"
+PLUGIN_ID="enhance"
+NPM_PACKAGE="@huo15/openclaw-enhance"
+
+echo -e "${CYAN}🦞 龙虾增强包 (OpenClaw Enhancement Kit) 安装程序${NC}"
+echo ""
+
+# ── 1. 检测 OpenClaw ──
+if [ ! -f "$OPENCLAW_DIR/openclaw.json" ]; then
+  echo -e "${RED}✗ 未检测到 OpenClaw 安装（$OPENCLAW_DIR/openclaw.json 不存在）${NC}"
+  echo "  请先安装 OpenClaw: https://openclaw.com"
+  exit 1
+fi
+echo -e "${GREEN}✓${NC} 检测到 OpenClaw: $OPENCLAW_DIR"
+
+# ── 2. 安装插件 ──
+echo ""
+echo -e "${CYAN}正在安装插件...${NC}"
+if command -v openclaw &>/dev/null; then
+  openclaw plugins install "$NPM_PACKAGE" || {
+    echo -e "${YELLOW}⚠ openclaw plugins install 失败，尝试手动安装...${NC}"
+    INSTALL_DIR="$OPENCLAW_DIR/extensions/openclaw-enhance"
+    mkdir -p "$INSTALL_DIR"
+    cd "$INSTALL_DIR"
+    npm init -y --silent 2>/dev/null || true
+    npm install "$NPM_PACKAGE" --silent
+    cd - >/dev/null
+  }
+else
+  echo -e "${YELLOW}⚠ 未找到 openclaw CLI，使用手动安装模式${NC}"
+  INSTALL_DIR="$OPENCLAW_DIR/extensions/openclaw-enhance"
+  mkdir -p "$INSTALL_DIR"
+  cd "$INSTALL_DIR"
+  npm init -y --silent 2>/dev/null || true
+  npm install "$NPM_PACKAGE" --silent
+  cd - >/dev/null
+fi
+echo -e "${GREEN}✓${NC} 插件已安装"
+
+# ── 3. 定位插件文件 ──
+PLUGIN_DIR=""
+for candidate in \
+  "$OPENCLAW_DIR/extensions/openclaw-enhance/node_modules/$NPM_PACKAGE" \
+  "$OPENCLAW_DIR/extensions/openclaw-enhance" \
+  "$(dirname "$(readlink -f "$0" 2>/dev/null || echo "$0")")/.."; do
+  if [ -f "$candidate/openclaw.plugin.json" ]; then
+    PLUGIN_DIR="$candidate"
+    break
+  fi
+done
+
+if [ -z "$PLUGIN_DIR" ]; then
+  echo -e "${YELLOW}⚠ 无法定位插件文件目录，跳过技能和模板安装${NC}"
+  echo "  你可以手动从 npm 包中复制 skills/ 和 templates/ 到工作区"
+else
+  # ── 4. 复制增强技能 ──
+  echo ""
+  echo -e "${CYAN}正在安装增强技能...${NC}"
+  SKILLS_DIR="$OPENCLAW_DIR/workspace/skills"
+  mkdir -p "$SKILLS_DIR"
+
+  for skill in plan-mode explore-mode verify-mode memory-curator; do
+    if [ -d "$PLUGIN_DIR/skills/$skill" ]; then
+      if [ -d "$SKILLS_DIR/$skill" ]; then
+        echo -e "  ${YELLOW}⚠ $skill 已存在，跳过${NC}"
+      else
+        cp -r "$PLUGIN_DIR/skills/$skill" "$SKILLS_DIR/"
+        echo -e "  ${GREEN}✓${NC} $skill"
+      fi
+    fi
+  done
+
+  # ── 5. 应用工作区模板补丁 ──
+  echo ""
+  echo -e "${CYAN}正在应用工作区增强...${NC}"
+  WS_DIR="$OPENCLAW_DIR/workspace"
+
+  for file in AGENTS.md SOUL.md; do
+    patch_file="$PLUGIN_DIR/templates/${file%.md}.enhance-patch.md"
+    target_file="$WS_DIR/$file"
+
+    if [ ! -f "$patch_file" ]; then
+      continue
+    fi
+
+    if [ ! -f "$target_file" ]; then
+      echo -e "  ${YELLOW}⚠ $target_file 不存在，跳过${NC}"
+      continue
+    fi
+
+    # 检查是否已经打过补丁
+    if grep -q "龙虾增强包补丁" "$target_file" 2>/dev/null; then
+      echo -e "  ${YELLOW}⚠ $file 已包含增强补丁，跳过${NC}"
+      continue
+    fi
+
+    # 备份并追加
+    cp "$target_file" "${target_file}.bak.$(date +%Y%m%d%H%M%S)"
+    cat "$patch_file" >> "$target_file"
+    echo -e "  ${GREEN}✓${NC} $file 已增强（备份: ${file}.bak.*）"
+  done
+fi
+
+# ── 6. 打印完成信息 ──
+echo ""
+echo -e "${GREEN}═══════════════════════════════════════════${NC}"
+echo -e "${GREEN}  🦞 龙虾增强包安装完成！${NC}"
+echo -e "${GREEN}═══════════════════════════════════════════${NC}"
+echo ""
+echo "  已安装模块:"
+echo "    📦 结构化记忆 (enhance_memory_store/search/review)"
+echo "    🛡️  工具安全守卫 (enhance_safety_log/rules)"
+echo "    ✨ 提示词增强 (自动注入)"
+echo "    🔄 工作流自动化 (enhance_workflow_define/list/delete)"
+echo "    📊 仪表盘 (http://localhost:18789/enhance/)"
+echo ""
+echo "  已安装技能:"
+echo "    📋 plan-mode — 结构化规划"
+echo "    🔍 explore-mode — 深度探索"
+echo "    ✅ verify-mode — 验证检查"
+echo "    🧠 memory-curator — 记忆整理"
+echo ""
+echo -e "  ${CYAN}重启 OpenClaw 使插件生效:${NC}"
+echo "    openclaw restart"
+echo ""
+echo -e "  ${CYAN}配置（可选）:${NC}"
+echo "    编辑 $OPENCLAW_DIR/openclaw.json → plugins.entries.enhance.config"
+echo ""

package/skills/explore-mode/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: explore-mode
+description: "深度探索模式 — 系统性调研代码库、系统或话题，只读不改。借鉴 Claude Code 的 Explore Agent。"
+homepage: https://github.com/jobzhao15/openclaw-enhance
+metadata: { "openclaw": { "emoji": "🔍", "requires": { "bins": [] } } }
+---
+
+# 探索模式 (Explore Mode)
+
+进入只读深度探索模式，在回答前系统性地调研。
+
+## 使用时机
+
+✅ **使用此技能当：**
+- "帮我了解一下这个项目的架构"
+- "这个功能是怎么实现的？"
+- "调查一下为什么会出这个 bug"
+- 需要全面理解一个不熟悉的代码库或系统
+
+❌ **不要使用当：**
+- 已经很了解要查的内容
+- 用户只是问一个简单的事实性问题
+
+## 探索流程
+
+### 1. 确定探索目标
+- 要回答什么问题？
+- 探索的范围是什么？（哪些目录/文件/系统）
+- 需要达到什么深度？
+
+### 2. 广度优先扫描
+- 先看目录结构，建立全局认知
+- 读 README、配置文件、入口文件
+- 识别主要模块和它们的关系
+
+### 3. 深度定向调研
+- 针对目标问题，深入相关模块
+- 跟踪关键调用链
+- 查看测试用例理解预期行为
+- 查看 git log 了解变更历史
+
+### 4. 输出探索报告
+结构化输出：
+
+```
+## 探索报告: [主题]
+
+### 概述
+一段话总结发现
+
+### 架构/实现
+- 关键文件和它们的职责
+- 核心数据流/调用链
+- 重要的设计决策
+
+### 发现
+- 发现1: ...
+- 发现2: ...
+
+### 回答
+[针对原始问题的直接回答]
+
+### 建议（可选）
+如果发现了问题或改进空间
+```
+
+## 核心原则
+- **只读不改** — 探索阶段不修改任何文件
+- **系统性** — 不要只看一个文件就下结论，要交叉验证
+- **记录路径** — 给出具体的文件路径和行号，方便用户定位
+- **区分事实和推测** — 明确标注哪些是从代码看到的，哪些是推断的

package/skills/memory-curator/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: memory-curator
+description: "记忆整理技能 — 审查结构化记忆，提取洞察，更新 MEMORY.md，清理过期条目。"
+homepage: https://github.com/jobzhao15/openclaw-enhance
+metadata: { "openclaw": { "emoji": "🧠", "requires": { "bins": [] } } }
+---
+
+# 记忆整理 (Memory Curator)
+
+定期整理和优化结构化记忆系统。
+
+## 使用时机
+
+✅ **使用此技能当：**
+- "整理一下记忆"、"清理过期记忆"
+- 定期维护（建议每周一次）
+- 记忆条目数量过多需要精简
+- 需要从记忆中提取总结更新到 MEMORY.md
+
+## 整理流程
+
+### 1. 审查当前状态
+```
+调用 enhance_memory_review action=stats 查看各类别统计
+调用 enhance_memory_review action=recent limit=30 查看最近记忆
+```
+
+### 2. 清理过期/无效记忆
+检查每条记忆是否仍然有效：
+- **project 类**: 项目状态可能已变化，验证后决定保留或删除
+- **feedback 类**: 用户反馈通常长期有效，谨慎删除
+- **user 类**: 用户信息通常稳定，少量更新
+- **reference 类**: 链接/资源可能已过期，检查后决定
+- **decision 类**: 决策通常长期有效，除非被推翻
+
+```
+调用 enhance_memory_review action=delete id=<过期记忆ID>
+```
+
+### 3. 合并重复记忆
+如果多条记忆说的是同一件事：
+1. 创建一条更完整的合并记忆
+2. 删除旧的重复条目
+
+### 4. 同步到 MEMORY.md
+将最重要的结构化记忆摘要写入 MEMORY.md：
+- 只写长期有效、高重要性的内容
+- 按类别组织
+- 保持简洁
+
+### 5. 输出整理报告
+
+```
+## 记忆整理报告
+
+### 统计
+- 整理前: XX 条
+- 删除: X 条（原因: ...）
+- 合并: X 条 → X 条
+- 新增: X 条
+- 整理后: XX 条
+
+### 操作记录
+1. 删除 #12: 过期的项目截止日期
+2. 合并 #15 + #18 → #23: 用户偏好
+3. ...
+
+### MEMORY.md 更新
+[是否更新了 MEMORY.md，更新了什么]
+```
+
+## 核心原则
+- **保守删除** — 不确定就保留，宁多勿少
+- **feedback 最珍贵** — 用户反馈是最难重新获取的记忆类型
+- **验证后再删** — 对 project 类记忆，先确认项目状态再决定
+- **MEMORY.md 是精华** — 只把最重要的同步过去，不要全量复制

package/skills/plan-mode/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: plan-mode
+description: "结构化规划模式 — 在执行复杂任务前先做系统性规划。借鉴 Claude Code 的 Plan Agent。"
+homepage: https://github.com/jobzhao15/openclaw-enhance
+metadata: { "openclaw": { "emoji": "📋", "requires": { "bins": [] } } }
+---
+
+# 规划模式 (Plan Mode)
+
+在执行复杂或多步骤任务前，进入结构化规划模式。
+
+## 使用时机
+
+✅ **使用此技能当：**
+- 用户请求涉及多个步骤的复杂任务
+- "帮我规划一下..."、"设计一个方案..."
+- 需要在动手前理清思路
+- 修改涉及多个文件或系统
+
+❌ **不要使用当：**
+- 简单的单步操作（改个名字、修个 typo）
+- 用户明确要求直接执行
+
+## 规划流程
+
+### 阶段一：理解需求
+1. **复述需求** — 用自己的话总结用户要做什么
+2. **识别约束** — 有什么限制条件？时间、兼容性、依赖？
+3. **提出澄清问题** — 如果有不确定的地方，先问清楚再规划
+
+### 阶段二：调研现状
+1. **读相关代码** — 理解现有实现，不要凭空设计
+2. **找可复用的** — 搜索已有的函数、工具、模式
+3. **识别风险** — 哪些地方可能出问题？
+
+### 阶段三：设计方案
+输出结构化方案：
+
+```
+## 背景
+为什么要做这个改动？解决什么问题？
+
+## 方案
+### 步骤 1: [描述]
+- 修改文件: path/to/file
+- 具体操作: ...
+- 复用已有: function_name from file
+
+### 步骤 2: [描述]
+...
+
+## 风险与回退
+- 风险1: ...  → 缓解措施: ...
+
+## 验证方式
+- [ ] 怎么确认改动正确？
+- [ ] 运行什么测试？
+```
+
+### 阶段四：确认执行
+- 将方案展示给用户
+- 等待用户确认后再开始执行
+- 执行过程中逐步标记完成
+
+## 核心原则
+- **先理解，再设计，最后执行** — 不要一上来就写代码
+- **方案要具体** — 具体到哪个文件哪个函数，不要泛泛而谈
+- **复用优先** — 能用已有的就不要重新造
+- **最小变更** — 只改需要改的，不顺手重构

package/skills/verify-mode/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: verify-mode
+description: "验证模式 — 检查工作成果、运行测试、验证假设。借鉴 Claude Code 的 Verification Agent。"
+homepage: https://github.com/jobzhao15/openclaw-enhance
+metadata: { "openclaw": { "emoji": "✅", "requires": { "bins": [] } } }
+---
+
+# 验证模式 (Verify Mode)
+
+系统性地验证工作成果或假设。
+
+## 使用时机
+
+✅ **使用此技能当：**
+- 完成一段代码修改后需要验证
+- "帮我检查一下这个改动有没有问题"
+- 需要运行测试并分析结果
+- 验证一个假设或排查一个 bug
+
+❌ **不要使用当：**
+- 只是普通的代码 review（直接 review 即可）
+- 改动很小且显而易见正确
+
+## 验证流程
+
+### 1. 确定验证目标
+- 要验证什么？（功能正确性 / 性能 / 安全 / 兼容性）
+- 成功标准是什么？
+- 已知的风险点？
+
+### 2. 静态检查
+- 读改动的代码，检查逻辑正确性
+- 检查边界条件和错误处理
+- 检查是否引入了安全漏洞（注入、XSS 等）
+- 检查是否破坏了已有接口或行为
+
+### 3. 动态验证
+- 运行已有的测试套件
+- 如果没有测试，手动构造测试场景
+- 检查构建是否通过
+- 如果有 linter/formatter，运行一下
+
+### 4. 输出验证报告
+
+```
+## 验证报告
+
+### 验证对象
+[简要描述被验证的改动/假设]
+
+### 检查清单
+- [x] 逻辑正确性: 通过/发现问题
+- [x] 边界条件: ...
+- [x] 测试结果: X pass / Y fail
+- [x] 构建状态: 通过/失败
+- [ ] 安全检查: ...
+
+### 发现的问题
+1. [问题描述 + 严重程度 + 建议修复方式]
+
+### 结论
+✅ 验证通过 / ⚠️ 有待修复的问题 / ❌ 验证失败
+```
+
+## 核心原则
+- **全面但聚焦** — 覆盖主要风险点，但不要检查无关的东西
+- **给出证据** — "测试 X 通过了"、"第 42 行可能有空指针"，不要泛泛地说"看起来没问题"
+- **区分严重程度** — 阻塞性问题 vs 建议性改进
+- **可操作** — 发现问题就给出具体修复建议