Skip to content

Latest commit

 

History

History
138 lines (101 loc) · 5.33 KB

File metadata and controls

138 lines (101 loc) · 5.33 KB

no-no-debug

AI 编程助手的自我进化系统

v1.3.0 — 定期审查终于真正自动了。 之前版本承诺「每 3 天自动触发审查」, 但实际没有任何强制机制 —— 审查只在手动输入指令时才会运行,tracker 会无限期 过时。v1.3.0 新增 hooks/review_reminder.py,一个 UserPromptSubmit hook, 在每条消息时检查 tracker,超期就自动提醒 AI 启动审查。从 v1.2.0 升级只需一步, 见 CHANGELOG.md

解决什么问题

写代码 10 分钟,debug 2 小时。

这个 skill 补上 AI 缺失的跨 session 错误记忆,做到三件事:

  1. 大幅减少 debug 时间
  2. 提高代码质量
  3. 建立自我进化机制

持续迭代,用得越久,错误越少。

工作机制

1. 实时记录(自动)

AI 被纠正、代码报错、部署失败、测试不通过时,自动写入本地 error_log.md,带时间戳。不需要你说"记下来"。

2. 三道门(每次改代码时)

改之前:这会影响什么? 改之后:真的验证了吗? 部署前:用非管理员账号测了吗?

静默运行,不产生输出。

3. 定期审查(每 3 天自动触发)

读取 error_log.md,按维度分类统计,更新 error_tracker.md,输出进化报告。 审查频率可配置:1 天 / 3 天(默认)/ 7 天。

4. 规则沉淀

新类型的错误 → 自动创建预防规则。 重复犯的错误 → 计数器累加,规则强化。 连续 4 个周期未犯 → 标记为已根治。

规则跨 session 持久化,不会丢失。

5. 确认机制

以下情况必须先跟用户确认,不能直接动手:

  • 新功能开发(不是 bug 修复)
  • 涉及数据库、环境、部署的变更
  • 发布到外部平台
  • 用户提出新想法或新方向时

6. 自动 Hook

安装时自动配置 Claude Code hook:

  • 命令报错 → 自动记录到 error_log.md
  • 编辑文件后 → 自动提醒验证
  • 用户纠正时 → 自动记录纠正内容
  • 审查过期 → 自动提醒启动 Mechanism 3 审查

追踪维度

维度 追踪什么
数据准确性 展示的数字/公式是否与代码一致
环境安全 配置变更是否影响了登录或数据库
预见性 权限、迁移、缓存问题是否在部署前发现
用户视角 功能是否从用户角度走得通
验证完整性 修复后是否做了端到端验证
记忆一致性 是否读取了已有的记录而不是重复询问
工具判断 失败的工具是否及时更换
审查覆盖 总结/复盘是否完整,无遗漏
操作精准 修改是否产生了非预期的副作用
先查后做 遇到不熟悉的工具/版本时,是否先查文档再动手
简洁性 3 行能解决的问题是否写了 300 行
回归意识 修一个 bug 是否引入了新 bug
风格一致性 是否遵循项目已有的代码风格和架构
独立判断 用户前提有误时是否敢于指出而不是盲目执行
真实环境验证 修复是否用真实生产命令验证,而不是沙箱/简化测试
跨 agent 采信 另一个 agent 说"通过"时,是否独立复测而不是盲信
人类将要犯的蠢 还没犯,但迟早会犯的那些
AI 将要犯的蠢 同上,但是 AI 版本

实测数据

周期 错误数 说明
第 1 周 29 基线,识别出 10 个维度
第 2 周 6 规则开始生效
第 3 周 ~0 持续运行中

安装

Claude Code(推荐,完整体验含自动 hook)

claude skill add summerliuuu/no-no-debug

零配置,首次运行自动初始化追踪文件和 hook。

手动安装或从 v1.1.0 升级时,还需要把 hook 脚本复制过去:

mkdir -p ~/.claude/hooks
cp hooks/user_prompt_filter.py ~/.claude/hooks/
cp hooks/post_tool_failure.sh ~/.claude/hooks/
cp hooks/review_reminder.py ~/.claude/hooks/
chmod +x ~/.claude/hooks/post_tool_failure.sh

然后把 SKILL.md → Mechanism 6 里的 PostToolUseFailure / UserPromptSubmit 配置块合并进 ~/.claude/settings.json

前置依赖:shipped 的 hook 用到 python3(UserPromptSubmit 过滤器)和 jq(PostToolUseFailure 解析器)。macOS 和主流 Linux 发行版默认都带;缺失时对应 hook 会优雅降级 —— python3 缺失时纠正检测静默跳过,jq 缺失时会在 log 里写一次 jq_not_installed 标记。想要完整覆盖可以 brew install jq(macOS)或用你系统的包管理器装一下。

ChatGPT / Cursor / Copilot / 其他 AI 助手

  1. 复制 SKILL.md 的内容
  2. 粘贴到你的系统提示词或自定义指令中
  3. 核心功能(三道门、定期审查、规则沉淀)立即生效
  4. 自动 hook 仅限 Claude Code,其他工具依赖 AI 自觉遵守 SKILL.md 中的规则

兼容

  • Claude Code — 完整体验,含自动 hook 和一行安装
  • 其他 AI 编程助手(ChatGPT、Cursor、Copilot 等)— 将 SKILL.md 内容粘贴到系统提示词即可使用核心功能
  • 任何项目、任何语言
  • 推荐搭配 claude-mem(用于 session 搜索)

感谢你在安装时为这个项目点了 Star。

📕 小红书 @Summer的AI日常 — AI 编程实战记录


License

MIT — @summerliuuu