[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-BayramAnnakov--claude-reflect":3,"tool-BayramAnnakov--claude-reflect":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":79,"owner_email":80,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":93,"forks":94,"last_commit_at":95,"license":96,"difficulty_score":24,"env_os":97,"env_gpu":98,"env_ram":98,"env_deps":99,"category_tags":104,"github_topics":105,"view_count":24,"oss_zip_url":111,"oss_zip_packed_at":111,"status":17,"created_at":112,"updated_at":113,"faqs":114,"releases":145},9973,"BayramAnnakov\u002Fclaude-reflect","claude-reflect","A self-learning system for Claude Code that captures corrections, positive feedback, and preferences — then syncs them to CLAUDE.md and AGENTS.md.","claude-reflect 是一款专为 Claude Code 设计的自学习系统，旨在让 AI 助手在长期协作中“越用越懂你”。它主要解决了传统 AI 无法跨会话记忆用户偏好、纠正指令及工作习惯的痛点，避免用户重复修正相同错误。\n\n该工具的核心功能包括“永久记忆”与“技能发现”。当你纠正 Claude 的代码建议或表达偏好时，claude-reflect 会自动捕获这些反馈，经人工确认后同步至 CLAUDE.md 和 AGENTS.md 配置文件，确保 AI 在未来会话中永久记住这些规则。此外，它能智能分析历史会话记录，识别重复性的工作模式（如频繁的代码审查或部署流程），并主动建议将其转化为可复用的自定义命令，从而将临时操作固化为持久技能。\n\n技术亮点在于其支持多语言理解纠正内容，并具备跨项目模式识别能力，能在 macOS、Linux 和 Windows 全平台上原生运行。\n\nclaude-reflect 非常适合依赖 Claude Code 进行日常开发的程序员、技术团队及 AI 工作流研究者使用。对于希望减少重复沟通成本、构建个性化且具备持续进化能力的 AI 编程环境的开发者而言","claude-reflect 是一款专为 Claude Code 设计的自学习系统，旨在让 AI 助手在长期协作中“越用越懂你”。它主要解决了传统 AI 无法跨会话记忆用户偏好、纠正指令及工作习惯的痛点，避免用户重复修正相同错误。\n\n该工具的核心功能包括“永久记忆”与“技能发现”。当你纠正 Claude 的代码建议或表达偏好时，claude-reflect 会自动捕获这些反馈，经人工确认后同步至 CLAUDE.md 和 AGENTS.md 配置文件，确保 AI 在未来会话中永久记住这些规则。此外，它能智能分析历史会话记录，识别重复性的工作模式（如频繁的代码审查或部署流程），并主动建议将其转化为可复用的自定义命令，从而将临时操作固化为持久技能。\n\n技术亮点在于其支持多语言理解纠正内容，并具备跨项目模式识别能力，能在 macOS、Linux 和 Windows 全平台上原生运行。\n\nclaude-reflect 非常适合依赖 Claude Code 进行日常开发的程序员、技术团队及 AI 工作流研究者使用。对于希望减少重复沟通成本、构建个性化且具备持续进化能力的 AI 编程环境的开发者而言，这是一个能显著提升效率的实用插件。","# claude-reflect\n\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FBayramAnnakov\u002Fclaude-reflect?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fstargazers)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.6.0-blue?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Freleases)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green?style=flat-square)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Tests](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-160%20passing-brightgreen?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Factions)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect#platform-support)\n\nA self-learning system for Claude Code that captures corrections and discovers workflow patterns — turning them into permanent memory and reusable skills.\n\n## What it does\n\n### 1. Learn from Corrections\n\nWhen you correct Claude (\"no, use gpt-5.1 not gpt-5\"), it remembers forever.\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│  You correct    │ ──► │  Hook captures  │ ──► │  \u002Freflect adds  │\n│  Claude Code    │     │  to queue       │     │  to CLAUDE.md   │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n      (automatic)            (automatic)            (manual review)\n```\n\n### 2. Discover Workflow Patterns (NEW in v2)\n\nAnalyzes your session history to find repeating tasks that could become reusable commands.\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│  Your past      │ ──► │ \u002Freflect-skills │ ──► │   Generates     │\n│  sessions       │     │ finds patterns  │     │   \u002Fcommands     │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n    (68 sessions)         (AI-powered)            (you approve)\n```\n\nExample: You've asked \"review my productivity\" 12 times → suggests creating `\u002Fdaily-review`\n\n## Key Features\n\n| Feature | What it does |\n|---------|--------------|\n| **Permanent Memory** | Corrections sync to CLAUDE.md — Claude remembers across sessions |\n| **Skill Discovery** | Finds repeating patterns in your history → generates commands |\n| **Multi-language** | AI understands corrections in any language |\n| **Skill Improvement** | Corrections during `\u002Fdeploy` improve the deploy skill itself |\n\n## Installation\n\n```bash\n# Add the marketplace\nclaude plugin marketplace add bayramannakov\u002Fclaude-reflect\n\n# Install the plugin\nclaude plugin install claude-reflect@claude-reflect-marketplace\n\n# IMPORTANT: Restart Claude Code to activate the plugin\n```\n\nAfter installation, **restart Claude Code** (exit and reopen). Then hooks auto-configure and commands are ready.\n\n> **First run?** When you run `\u002Freflect` for the first time, you'll be prompted to scan your past sessions for learnings.\n\n### Prerequisites\n\n- [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) CLI installed\n- Python 3.6+ (included on most systems)\n\n### Platform Support\n\n- **macOS**: Fully supported\n- **Linux**: Fully supported\n- **Windows**: Fully supported (native Python, no WSL required)\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `\u002Freflect` | Process queued learnings with human review |\n| `\u002Freflect --scan-history` | Scan ALL past sessions for missed learnings |\n| `\u002Freflect --dry-run` | Preview changes without applying |\n| `\u002Freflect --targets` | Show detected config files (CLAUDE.md, AGENTS.md) |\n| `\u002Freflect --review` | Show queue with confidence scores and decay status |\n| `\u002Freflect --dedupe` | Find and consolidate similar entries in CLAUDE.md |\n| `\u002Freflect --include-tool-errors` | Include tool execution errors in scan |\n| `\u002Freflect-skills` | Discover skill candidates from repeating patterns |\n| `\u002Freflect-skills --days N` | Analyze last N days (default: 14) |\n| `\u002Freflect-skills --project \u003Cpath>` | Analyze specific project |\n| `\u002Freflect-skills --all-projects` | Scan all projects for cross-project patterns |\n| `\u002Freflect-skills --dry-run` | Preview patterns without generating skill files |\n| `\u002Fskip-reflect` | Discard all queued learnings |\n| `\u002Fview-queue` | View pending learnings without processing |\n\n## How It Works\n\n![claude-reflect in action](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FBayramAnnakov_claude-reflect_readme_a0deea525271.jpg)\n\n### Two-Stage Process\n\n**Stage 1: Capture (Automatic)**\n\nHooks run automatically to detect and queue corrections:\n\n| Hook | Trigger | Purpose |\n|------|---------|---------|\n| `session_start_reminder.py` | Session start | Shows pending learnings reminder |\n| `capture_learning.py` | Every prompt | Detects correction patterns and queues them |\n| `check_learnings.py` | Before compaction | Backs up queue and informs user |\n| `post_commit_reminder.py` | After git commit | Reminds to run \u002Freflect after completing work |\n\n**Stage 2: Process (Manual)**\n\nRun `\u002Freflect` to review and apply queued learnings to CLAUDE.md.\n\n### Detection Methods\n\nClaude-reflect uses a **hybrid detection approach**:\n\n**1. Regex patterns (real-time capture)**\n\nFast pattern matching during sessions detects:\n\n- **Corrections**: `\"no, use X\"` \u002F `\"don't use Y\"` \u002F `\"actually...\"` \u002F `\"that's wrong\"`\n- **Positive feedback**: `\"Perfect!\"` \u002F `\"Exactly right\"` \u002F `\"Great approach\"`\n- **Explicit markers**: `\"remember:\"` — highest confidence\n\n**2. Semantic AI validation (during \u002Freflect)**\n\nWhen you run `\u002Freflect`, an AI-powered semantic filter:\n- **Multi-language support** — understands corrections in any language\n- **Better accuracy** — filters out false positives from regex\n- **Cleaner learnings** — extracts concise, actionable statements\n\nExample: A Spanish correction like `\"no, usa Python\"` is correctly detected even though it doesn't match English patterns.\n\nEach captured learning has a **confidence score** (0.60-0.95). The final score is the higher of regex and semantic confidence.\n\n### Human Review\n\nWhen you run `\u002Freflect`, Claude presents a summary table with options:\n- **Apply** - Accept the learning and add to CLAUDE.md\n- **Edit before applying** - Modify the learning text first\n- **Skip** - Don't apply this learning\n\n### Multi-Target Sync\n\nApproved learnings are synced to:\n- `~\u002F.claude\u002FCLAUDE.md` (global - applies to all projects)\n- `.\u002FCLAUDE.md` (project-specific)\n- `.\u002F**\u002FCLAUDE.md` (subdirectories - auto-discovered)\n- `.\u002F.claude\u002Fcommands\u002F*.md` (skill files - when correction relates to a skill)\n- `AGENTS.md` (if exists - works with Codex, Cursor, Aider, Jules, Zed, Factory)\n\nRun `\u002Freflect --targets` to see which files will be updated.\n\n### Skill Discovery\n\nRun `\u002Freflect-skills` to discover repeating patterns in your sessions that could become reusable skills:\n\n```\n\u002Freflect-skills                 # Analyze current project (last 14 days)\n\u002Freflect-skills --days 30       # Analyze last 30 days\n\u002Freflect-skills --all-projects  # Analyze all projects (slower)\n\u002Freflect-skills --dry-run       # Preview patterns without generating files\n```\n\n**Features:**\n- **AI-powered detection** — uses reasoning, not regex, to find patterns\n- **Semantic similarity** — detects same intent across different phrasings\n- **Project-aware** — groups patterns by project, suggests correct location\n- **Smart assignment** — asks where each skill should go (project vs global)\n- **Generates skill files** — creates draft skills in `.claude\u002Fcommands\u002F`\n\n**How it works:**\n\nThe skill discovers patterns by analyzing your session history semantically. Different phrasings of the same intent are recognized:\n\n```\nSession 1: \"review my productivity for today\"\nSession 2: \"how was my focus this afternoon?\"\nSession 3: \"check my ActivityWatch data\"\nSession 4: \"evaluate my work hours\"\n```\n\nClaude reasons: *\"These 4 requests have the same intent - reviewing productivity data. The workflow is: fetch time tracking data → categorize activities → calculate focus score. This is a strong candidate for \u002Fdaily-review.\"*\n\n**Example output:**\n```\n════════════════════════════════════════════════════════════\nSKILL CANDIDATES DISCOVERED\n════════════════════════════════════════════════════════════\n\nFound 2 potential skills from analyzing 68 sessions:\n\n1. \u002Fdaily-review (High) — from my-productivity-tools\n   → Review productivity using time tracking data\n   Evidence: 15 similar requests\n   Corrections learned: \"use local timezone\", \"chat apps can be work\"\n\n2. \u002Fdeploy-app (High) — from my-webapp\n   → Deploy application with pre-flight checks\n   Evidence: 10 similar requests\n   Corrections learned: \"always run tests first\"\n\n════════════════════════════════════════════════════════════\n\nWhich skills should I generate?\n> [1] \u002Fdaily-review, [2] \u002Fdeploy-app\n\nWhere should each skill be created?\n┌──────────────────────┬─────────────────────────┐\n│ \u002Fdaily-review        │ my-productivity-tools   │\n│ \u002Fdeploy-app          │ my-webapp               │\n└──────────────────────┴─────────────────────────┘\n\nSkills created:\n  ~\u002Fprojects\u002Fmy-productivity-tools\u002F.claude\u002Fcommands\u002Fdaily-review.md\n  ~\u002Fprojects\u002Fmy-webapp\u002F.claude\u002Fcommands\u002Fdeploy-app.md\n```\n\n**Generated skill file example:**\n\n```markdown\n---\ndescription: Deploy application with pre-flight checks\nallowed-tools: Bash, Read, Write\n---\n\n## Context\nDeployment scripts in .\u002Fscripts\u002Fdeploy\u002F\n\n## Your Task\nDeploy the application to the specified environment.\n\n### Steps\n1. Run test suite\n2. Build production assets\n3. Deploy to target environment\n4. Verify deployment health\n\n### Guardrails\n- Always run tests before deploying\n- Never deploy to production on Fridays\n- Check for pending migrations\n\n---\n*Generated by \u002Freflect-skills from 10 session patterns*\n```\n\n### Skill Improvement Routing\n\nWhen you correct Claude while using a skill (e.g., `\u002Fdeploy`), the correction can be routed back to the skill file itself:\n\n```\nUser: \u002Fdeploy\nClaude: [deploys without running tests]\nUser: \"no, always run tests before deploying\"\n\n→ \u002Freflect detects this relates to \u002Fdeploy\n→ Offers to add learning to .claude\u002Fcommands\u002Fdeploy.md\n→ Skill file updated with new step\n```\n\nThis makes skills smarter over time, not just CLAUDE.md.\n\n## Upgrading\n\n### From v2.0.x or earlier\n\nIf you see errors like \"Duplicate hooks file detected\" or \"No such file or directory\" after updating, you need to clear the plugin cache. This is due to known Claude Code caching issues:\n- [#14061](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F14061) - `\u002Fplugin update` doesn't invalidate cache\n- [#15369](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F15369) - Uninstall doesn't clear cached files\n\n```bash\n# 1. Uninstall the plugin\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\n\n# 2. Clear both caches (required!)\nrm -rf ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fclaude-reflect-marketplace\nrm -rf ~\u002F.claude\u002Fplugins\u002Fcache\u002Fclaude-reflect-marketplace\n\n# 3. Exit Claude Code completely (restart terminal or close app)\n\n# 4. Reinstall\nclaude plugin install claude-reflect@claude-reflect-marketplace\n```\n\n### Standard Update\n\nFor normal updates (when no cache issues):\n\n```bash\n# Use the \u002Fplugin menu in Claude Code\n\u002Fplugin\n# Select \"Update now\" for claude-reflect\n```\n\n## Uninstall\n\n```bash\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\n```\n\n## File Structure\n\n```\nclaude-reflect\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json         # Plugin manifest (auto-registers hooks)\n├── commands\u002F\n│   ├── reflect.md          # Main command\n│   ├── reflect-skills.md   # Skill discovery\n│   ├── skip-reflect.md     # Discard queue\n│   └── view-queue.md       # View queue\n├── hooks\u002F\n│   └── hooks.json          # Auto-configured when plugin installed\n├── scripts\u002F\n│   ├── lib\u002F\n│   │   ├── reflect_utils.py      # Shared utilities\n│   │   └── semantic_detector.py  # AI-powered semantic analysis\n│   ├── capture_learning.py       # Hook: detect corrections\n│   ├── check_learnings.py        # Hook: pre-compact check\n│   ├── post_commit_reminder.py   # Hook: post-commit reminder\n│   ├── compare_detection.py      # Compare regex vs semantic detection\n│   ├── extract_session_learnings.py\n│   ├── extract_tool_errors.py\n│   ├── extract_tool_rejections.py\n│   └── legacy\u002F                   # Bash scripts (deprecated)\n├── tests\u002F                  # Test suite\n└── SKILL.md                # Skill context for Claude\n```\n\n## Features\n\n### Historical Scan\n\nFirst time using claude-reflect? Run:\n\n```bash\n\u002Freflect --scan-history\n```\n\nThis scans all your past sessions for corrections you made, so you don't lose learnings from before installation.\n\n### Smart Filtering\n\nClaude filters out:\n- Questions (not corrections)\n- One-time task instructions\n- Context-specific requests\n- Vague\u002Fnon-actionable feedback\n\nOnly reusable learnings are kept.\n\n### Duplicate Detection\n\nBefore adding a learning, existing CLAUDE.md content is checked. If similar content exists, you can:\n- Merge with existing entry\n- Replace the old entry\n- Skip the duplicate\n\n### Semantic Deduplication\n\nOver time, CLAUDE.md can accumulate similar entries. Run `\u002Freflect --dedupe` to:\n- Find semantically similar entries (even with different wording)\n- Propose consolidated versions\n- Clean up redundant learnings\n\nExample:\n```\nBefore:\n  - Use gpt-5.1 for complex tasks\n  - Prefer gpt-5.1 for reasoning\n  - gpt-5.1 is better for hard problems\n\nAfter:\n  - Use gpt-5.1 for complex reasoning tasks\n```\n\n## Tips\n\n1. **Use explicit markers** for important learnings:\n   ```\n   remember: always use venv for Python projects\n   ```\n\n2. **Run \u002Freflect after git commits** - The hook reminds you, but make it a habit\n\n3. **Historical scan on new machines** - When setting up a new dev environment:\n   ```\n   \u002Freflect --scan-history --days 90\n   ```\n\n4. **Project vs Global** - Model names and general patterns go global; project-specific conventions stay in project CLAUDE.md\n\n5. **Discover skills monthly** - Run `\u002Freflect-skills --days 30` monthly to find automation opportunities you might have missed\n\n6. **Skills get smarter** - When you correct Claude during a skill, that correction can be routed back to the skill file itself via `\u002Freflect`\n\n7. **Extend session retention** - Claude Code deletes local sessions after 30 days by default. Since claude-reflect relies on session history for `\u002Freflect --scan-history` and `\u002Freflect-skills`, extend this in `~\u002F.claude\u002Fsettings.json`:\n   ```json\n   { \"cleanupPeriodDays\": 99999 }\n   ```\n\n## Contributing\n\nPull requests welcome! Please read the contributing guidelines first.\n\n## License\n\nMIT\n","# claude-reflect\n\n[![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FBayramAnnakov\u002Fclaude-reflect?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fstargazers)\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.6.0-blue?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Freleases)\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green?style=flat-square)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![测试](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-160%20passing-brightgreen?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Factions)\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square)](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect#platform-support)\n\n一个针对 Claude Code 的自学习系统，能够捕捉修正并发现工作流模式——将其转化为永久记忆和可重用技能。\n\n## 它的作用\n\n### 1. 从修正中学习\n\n当你纠正 Claude（“不，用 gpt-5.1 而不是 gpt-5”）时，它会永远记住这一点。\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│  你纠正       │ ──► │  挂钩捕获       │ ──► │  \u002Freflect 添加   │\n│  Claude Code    │     │  到队列         │     │  到 CLAUDE.md    │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n      (自动)            (自动)            (手动审核)\n```\n\n### 2. 发现工作流模式（v2 中的新功能）\n\n分析你的会话历史，找出可以转化为可重用命令的重复性任务。\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│  你的过去      │ ──► │ \u002Freflect-skills │ ──► │   生成          │\n│  会话          │     │ 寻找模式        │     │   \u002Fcommands      │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n    (68 次会话)         (AI 驱动)            (由你批准)\n```\n\n示例：你曾 12 次询问“检查我的生产力”→ 建议创建 `\u002Fdaily-review`。\n\n## 核心特性\n\n| 特性 | 作用 |\n|---------|--------------|\n| **永久记忆** | 修正会同步到 CLAUDE.md — Claude 在不同会话间都能记住 |\n| **技能发现** | 从你的历史中找到重复模式 → 生成命令 |\n| **多语言支持** | AI 能理解任何语言的修正 |\n| **技能提升** | 在 `\u002Fdeploy` 过程中的修正会直接提升部署技能 |\n\n## 安装\n\n```bash\n# 添加市场\nclaude plugin marketplace add bayramannakov\u002Fclaude-reflect\n\n# 安装插件\nclaude plugin install claude-reflect@claude-reflect-marketplace\n\n# 重要提示：重启 Claude Code 以激活插件\n```\n\n安装完成后，请 **重启 Claude Code**（退出并重新打开）。随后挂钩将自动配置，命令即可使用。\n\n> **首次运行？** 当你第一次运行 `\u002Freflect` 时，系统会提示扫描过去的会话以获取学习内容。\n\n### 先决条件\n\n- 已安装 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) CLI\n- Python 3.6+（大多数系统已自带）\n\n### 平台支持\n\n- **macOS**：完全支持\n- **Linux**：完全支持\n- **Windows**：完全支持（原生 Python，无需 WSL）\n\n## 命令\n\n| 命令 | 描述 |\n|---------|-------------|\n| `\u002Freflect` | 处理待处理的学习内容，并进行人工审核 |\n| `\u002Freflect --scan-history` | 扫描所有过去的会话，查找遗漏的学习内容 |\n| `\u002Freflect --dry-run` | 预览更改而不实际应用 |\n| `\u002Freflect --targets` | 显示检测到的配置文件（CLAUDE.md、AGENTS.md） |\n| `\u002Freflect --review` | 显示带有置信度分数和衰减状态的待处理列表 |\n| `\u002Freflect --dedupe` | 查找并合并 CLAUDE.md 中相似条目 |\n| `\u002Freflect --include-tool-errors` | 将工具执行错误也纳入扫描范围 |\n| `\u002Freflect-skills` | 从重复模式中发现潜在技能 |\n| `\u002Freflect-skills --days N` | 分析最近 N 天的内容（默认为 14 天） |\n| `\u002Freflect-skills --project \u003Cpath>` | 分析特定项目 |\n| `\u002Freflect-skills --all-projects` | 扫描所有项目以寻找跨项目模式 |\n| `\u002Freflect-skills --dry-run` | 预览模式而不生成技能文件 |\n| `\u002Fskip-reflect` | 忽略所有待处理的学习内容 |\n| `\u002Fview-queue` | 查看待处理的学习内容，但不进行处理 |\n\n## 工作原理\n\n![claude-reflect 实际操作](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FBayramAnnakov_claude-reflect_readme_a0deea525271.jpg)\n\n### 两阶段流程\n\n**阶段 1：捕获（自动）**\n\n挂钩会自动运行，检测并排队修正：\n\n| 挂钩 | 触发条件 | 目的 |\n|------|---------|---------|\n| `session_start_reminder.py` | 会话开始 | 显示待处理学习提醒 |\n| `capture_learning.py` | 每次提示 | 检测修正模式并将其排队 |\n| `check_learnings.py` | 压缩前 | 备份队列并通知用户 |\n| `post_commit_reminder.py` | Git 提交后 | 提醒在完成工作后运行 \u002Freflect |\n\n**阶段 2：处理（手动）**\n\n运行 `\u002Freflect` 来审查并应用待处理的学习内容到 CLAUDE.md 中。\n\n### 检测方法\n\nClaude-reflect 使用 **混合检测方法**：\n\n**1. 正则表达式模式（实时捕获）**\n\n在会话过程中快速匹配模式，检测以下内容：\n\n- **修正**：“不，用 X” \u002F “不要用 Y” \u002F “实际上……” \u002F “那不对”\n- **正面反馈**：“完美！” \u002F “完全正确” \u002F “很棒的方法”\n- **显式标记**：“记住：” — 置信度最高\n\n**2. 语义 AI 验证（在 \u002Freflect 运行时）**\n\n当你运行 `\u002Freflect` 时，AI 驱动的语义过滤器会：\n- **多语言支持** — 能理解任何语言的修正\n- **更高的准确率** — 过滤掉正则表达式误报\n- **更干净的学习内容** — 提取简洁、可操作的语句\n\n例如：西班牙语修正“no, usa Python”即使不符合英语模式，也能被正确检测到。\n\n每个捕获的学习内容都有一个 **置信度分数**（0.60–0.95）。最终分数取正则表达式和语义置信度中的较高值。\n\n### 人工审核\n\n当你运行 `\u002Freflect` 时，Claude 会显示一个汇总表格，提供以下选项：\n- **应用** - 接受该学习内容并添加到 CLAUDE.md\n- **修改后再应用** - 先修改学习内容文本\n- **跳过** - 不应用此学习内容\n\n### 多目标同步\n\n经批准的学习内容会被同步到：\n- `~\u002F.claude\u002FCLAUDE.md`（全局 — 应用于所有项目）\n- `.\u002FCLAUDE.md`（项目专用）\n- `.\u002F**\u002FCLAUDE.md`（子目录 — 自动发现）\n- `.\u002F.claude\u002Fcommands\u002F*.md`（技能文件 — 当修正与技能相关时）\n- `AGENTS.md`（如果存在 — 与 Codex、Cursor、Aider、Jules、Zed、Factory 等兼容）\n\n运行 `\u002Freflect --targets` 可查看哪些文件会被更新。\n\n### 技能发现\n\n运行 `\u002Freflect-skills` 来发现你对话中可能成为可复用技能的重复模式：\n\n```\n\u002Freflect-skills                 # 分析当前项目（最近14天）\n\u002Freflect-skills --days 30       # 分析最近30天\n\u002Freflect-skills --all-projects  # 分析所有项目（较慢）\n\u002Freflect-skills --dry-run       # 预览模式而不生成文件\n```\n\n**功能：**\n- **AI驱动检测** — 使用推理而非正则表达式来寻找模式\n- **语义相似性** — 能够识别不同表述中的相同意图\n- **项目感知** — 按项目对模式进行分组，并建议正确的存放位置\n- **智能分配** — 询问每个技能应该放在哪个项目或全局目录下\n- **生成技能文件** — 在 `.claude\u002Fcommands\u002F` 中创建技能草稿\n\n**工作原理：**\n\n该工具通过语义分析你的会话历史来发现模式。它能够识别出表达相同意图的不同说法：\n\n```\n会话1: “查看我今天的生产力”\n会话2: “今天下午我的专注度如何？”\n会话3: “检查我的ActivityWatch数据”\n会话4: “评估我的工作时长”\n```\n\nClaude会这样推理：“这4个请求具有相同的意图——查看生产力数据。其工作流程是：获取时间追踪数据 → 对活动进行分类 → 计算专注度得分。这非常适合作为 \u002Fdaily-review 技能。”\n\n**示例输出：**\n```\n════════════════════════════════════════════════════════════\n发现的技能候选\n════════════════════════════════════════════════════════════\n\n从68次会话中发现了2个潜在技能：\n\n1. \u002Fdaily-review（高）— 来自 my-productivity-tools\n   → 使用时间追踪数据查看生产力\n   证据：15次类似请求\n   学到的修正：”使用本地时区”，“聊天应用也算工作”\n\n2. \u002Fdeploy-app（高）— 来自 my-webapp\n   → 带预检步骤部署应用\n   证据：10次类似请求\n   学到的修正：”一定要先跑测试”\n\n════════════════════════════════════════════════════════════\n\n我应该生成哪些技能？\n> [1] \u002Fdaily-review，[2] \u002Fdeploy-app\n\n每个技能应该创建在哪里？\n┌──────────────────────┬─────────────────────────┐\n│ \u002Fdaily-review        │ my-productivity-tools   │\n│ \u002Fdeploy-app          │ my-webapp               │\n└──────────────────────┴─────────────────────────┘\n\n已创建的技能：\n  ~\u002Fprojects\u002Fmy-productivity-tools\u002F.claude\u002Fcommands\u002Fdaily-review.md\n  ~\u002Fprojects\u002Fmy-webapp\u002F.claude\u002Fcommands\u002Fdeploy-app.md\n```\n\n**生成的技能文件示例：**\n\n```markdown\n---\ndescription: 带预检步骤部署应用\nallowed-tools: Bash, Read, Write\n---\n\n## 上下文\n部署脚本位于 .\u002Fscripts\u002Fdeploy\u002F\n\n## 你的任务\n将应用部署到指定环境。\n\n### 步骤\n1. 运行测试套件\n2. 构建生产资源\n3. 部署到目标环境\n4. 验证部署状态\n\n### 守护机制\n- 始终在部署前运行测试\n- 周五绝不部署到生产环境\n- 检查是否有未完成的迁移\n\n---\n*由 \u002Freflect-skills 根据10次会话模式生成*\n```\n\n### 技能改进路由\n\n当你在使用某个技能时纠正Claude（例如 `\u002Fdeploy`），这些纠正信息可以被反馈回技能文件本身：\n\n```\n用户：\u002Fdeploy\nClaude：[未经测试就部署]\n用户：“不对，部署前一定要先跑测试”\n\n→ \u002Freflect 检测到这与 \u002Fdeploy 相关\n→ 提供将学习内容添加到 .claude\u002Fcommands\u002Fdeploy.md 的选项\n→ 技能文件更新，加入新步骤\n```\n\n这样一来，技能会随着时间不断变得更智能，而不仅仅是 CLAUDE.md 文件。\n\n## 升级\n\n### 从 v2.0.x 或更早版本升级\n\n如果你在更新后遇到“检测到重复的钩子文件”或“没有这样的文件或目录”等错误，你需要清除插件缓存。这是由于 Claude Code 已知的缓存问题所致：\n- [#14061](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F14061) — `\u002Fplugin update` 不会失效缓存\n- [#15369](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F15369) — 卸载不会清除缓存文件\n\n```bash\n# 1. 卸载插件\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\n\n# 2. 清除两个缓存（必须！）\nrm -rf ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fclaude-reflect-marketplace\nrm -rf ~\u002F.claude\u002Fplugins\u002Fcache\u002Fclaude-reflect-marketplace\n\n# 3. 完全退出 Claude Code（重启终端或关闭应用）\n\n# 4. 重新安装\nclaude plugin install claude-reflect@claude-reflect-marketplace\n```\n\n### 标准更新\n\n对于正常更新（无缓存问题的情况）：\n\n```bash\n# 使用 Claude Code 中的 \u002Fplugin 菜单\n\u002Fplugin\n# 选择 “立即更新” 以更新 claude-reflect\n```\n\n## 卸载\n\n```bash\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\n```\n\n## 文件结构\n\n```\nclaude-reflect\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json         # 插件清单（自动注册钩子）\n├── commands\u002F\n│   ├── reflect.md          # 主命令\n│   ├── reflect-skills.md   # 技能发现\n│   ├── skip-reflect.md     # 跳过队列\n│   └── view-queue.md       # 查看队列\n├── hooks\u002F\n│   └── hooks.json          # 插件安装时自动配置\n├── scripts\u002F\n│   ├── lib\u002F\n│   │   ├── reflect_utils.py      # 共享工具\n│   │   └── semantic_detector.py  # AI驱动的语义分析\n│   ├── capture_learning.py       # 钩子：检测纠正\n│   ├── check_learnings.py        # 钩子：预压缩检查\n│   ├── post_commit_reminder.py   # 钩子：提交后提醒\n│   ├── compare_detection.py      # 比较正则表达式与语义检测\n│   ├── extract_session_learnings.py\n│   ├── extract_tool_errors.py\n│   ├── extract_tool_rejections.py\n│   └── legacy\u002F                   # Bash脚本（已弃用）\n├── tests\u002F                  # 测试套件\n└── SKILL.md                # Claude 的技能上下文\n```\n\n## 功能\n\n### 历史扫描\n\n首次使用 claude-reflect？运行：\n\n```bash\n\u002Freflect --scan-history\n```\n\n这将扫描你过去的所有会话，找出你曾经做出的纠正，以免丢失安装前的学习内容。\n\n### 智能过滤\n\nClaude 会过滤掉：\n- 问题（不是纠正）\n- 一次性任务指示\n- 特定上下文的请求\n- 模糊或不可操作的反馈\n\n只有可复用的学习内容才会被保留。\n\n### 重复检测\n\n在添加学习内容之前，系统会检查现有的 CLAUDE.md 内容。如果发现类似内容，你可以：\n- 合并到现有条目\n- 替换旧条目\n- 跳过重复内容\n\n### 语义去重\n\n随着时间推移，CLAUDE.md 可能会积累许多相似的内容。运行 `\u002Freflect --dedupe` 可以：\n- 找到语义上相似的条目（即使措辞不同）\n- 提出整合后的版本\n- 清理冗余的学习内容。\n\n例如：\n```\n修改前：\n  - 复杂任务使用 gpt-5.1\n  - 推理任务优先使用 gpt-5.1\n  - gpt-5.1 更适合解决难题\n\n修改后：\n  - 复杂推理任务使用 gpt-5.1\n```\n\n## 小贴士\n\n1. **使用明确的标记**来标注重要的学习内容：\n   ```\n   记住：Python 项目始终使用 venv\n   ```\n\n2. **在 Git 提交后运行 \u002Freflect** - 钩子会提醒你，但最好养成习惯。\n\n3. **在新机器上进行历史扫描** - 当设置新的开发环境时：\n   ```\n   \u002Freflect --scan-history --days 90\n   ```\n\n4. **项目级与全局级** - 模型名称和通用模式应放在全局；项目特有的约定则保留在项目的 CLAUDE.md 文件中。\n\n5. **每月发现技能** - 每月运行 `\u002Freflect-skills --days 30`，以找出可能遗漏的自动化机会。\n\n6. **技能会变得更智能** - 当你在使用某个技能时纠正 Claude 的错误时，可以通过 `\u002Freflect` 将修正反馈回该技能文件本身。\n\n7. **延长会话保留时间** - 默认情况下，Claude Code 会在 30 天后删除本地会话。由于 claude-reflect 依赖会话历史来进行 `\u002Freflect --scan-history` 和 `\u002Freflect-skills` 操作，因此可以在 `~\u002F.claude\u002Fsettings.json` 中将其延长：\n   ```json\n   { \"cleanupPeriodDays\": 99999 }\n   ```\n\n## 贡献\n\n欢迎提交 Pull 请求！请先阅读贡献指南。\n\n## 许可证\n\nMIT","# claude-reflect 快速上手指南\n\n**claude-reflect** 是一个专为 Claude Code 设计的自学习系统。它能自动捕获你对 AI 的纠正指令，将其转化为永久记忆（写入 `CLAUDE.md`），并能分析历史会话模式，自动生成可复用的技能命令。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **核心依赖**：已安装 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) CLI。\n*   **运行环境**：Python 3.6+（大多数现代操作系统默认已包含）。\n*   **支持平台**：\n    *   macOS（完全支持）\n    *   Linux（完全支持）\n    *   Windows（完全支持，使用原生 Python，无需 WSL）\n\n## 安装步骤\n\n通过 Claude Code 插件市场进行安装，操作简单快捷：\n\n1.  **添加市场源**\n    ```bash\n    claude plugin marketplace add bayramannakov\u002Fclaude-reflect\n    ```\n\n2.  **安装插件**\n    ```bash\n    claude plugin install claude-reflect@claude-reflect-marketplace\n    ```\n\n3.  **激活插件（重要）**\n    安装完成后，必须**完全重启 Claude Code**（退出并重新打开终端或应用），以便自动配置钩子（Hooks）和加载命令。\n\n> **提示**：首次运行 `\u002Freflect` 时，系统会提示你扫描过去的会话以提取潜在的学习内容。\n\n## 基本使用\n\n安装重启后，插件会自动在后台运行。以下是两个最核心的使用场景：\n\n### 1. 从纠正中学习 (Learn from Corrections)\n\n当你在使用 Claude Code 时纠正它的错误，插件会自动捕获这些瞬间。\n\n*   **操作示例**：\n    你在对话中输入：`\"no, use gpt-5.1 not gpt-5\"` 或 `\"实际上，请使用 Python 而不是 Node.js\"`。\n*   **处理流程**：\n    1.  系统自动将纠正内容加入队列。\n    2.  运行以下命令审查并应用这些知识：\n        ```bash\n        \u002Freflect\n        ```\n    3.  Claude 会展示待处理的纠正列表，你可以选择 **Apply**（应用）、**Edit**（编辑后应用）或 **Skip**（跳过）。\n    4.  确认后的内容将被永久写入 `CLAUDE.md`，未来的会话中将不再犯同样错误。\n\n### 2. 发现工作流模式 (Discover Workflow Patterns)\n\n如果你反复执行类似的任务，插件可以帮你将其封装为专用命令。\n\n*   **操作示例**：\n    假设你过去多次询问过“检查我的生产力数据”或“回顾今日工作重点”。\n*   **执行命令**：\n    ```bash\n    \u002Freflect-skills\n    ```\n*   **结果**：\n    系统会分析最近 14 天的会话历史，识别重复模式，并建议生成新的技能文件（例如 `\u002Fdaily-review`）。你只需确认即可在 `.claude\u002Fcommands\u002F` 目录下生成对应的命令文件，实现一键复用复杂工作流。\n\n### 常用辅助命令\n\n| 命令 | 说明 |\n| :--- | :--- |\n| `\u002Fview-queue` | 查看当前待处理的纠正队列，不进行处理 |\n| `\u002Freflect --dry-run` | 预览变更但不实际应用到文件 |\n| `\u002Freflect-skills --days 30` | 分析过去 30 天的会话以发现技能模式 |\n| `\u002Fskip-reflect` | 丢弃所有排队等待的学习内容 |","资深后端工程师李明正在使用 Claude Code 重构一个遗留的微服务项目，他需要频繁调整代码风格并执行重复的部署检查流程。\n\n### 没有 claude-reflect 时\n- 每次纠正 Claude 生成的代码风格（如“不要用 var，请用 let\"），下次会话中模型依然会犯同样的错误，需反复口头指令。\n- 项目特有的部署前检查步骤（如“先运行 lint 再构建 Docker 镜像”）每次都要重新详细描述，无法形成自动化记忆。\n- 重复性的操作模式（如每周三次的数据清洗脚本生成）散落在历史对话中，难以提炼为可复用的快捷命令。\n- 团队协作时，新成员无法直接继承李明在过往会话中积累的偏好和修正经验，导致沟通成本高昂。\n- 随着项目迭代，早期的错误修正记录丢失，导致模型在某些已知陷阱上反复“踩坑”。\n\n### 使用 claude-reflect 后\n- 李明对代码风格的每一次纠正都会被自动捕获并经 `\u002Freflect` 确认后写入 `CLAUDE.md`，模型从此永久记住偏好，不再重犯。\n- 复杂的部署流程经过几次交互后，被识别为固定模式并转化为专属技能，后续只需输入简短指令即可触发完整流程。\n- `\u002Freflect-skills` 自动分析过去两周的会话，发现李明频繁请求“生成单元测试”，主动建议创建 `\u002Fgen-tests` 命令供一键调用。\n- 所有积累的经验都同步至项目配置文件，新成员接入环境后，Claude 立即具备与李明明相同的上下文理解和编码习惯。\n- 系统自动去重并优化记忆条目，确保模型在面对历史已知问题时能直接调用修正后的逻辑，显著提升一次通过率。\n\nclaude-reflect 将零散的交互修正转化为持久的团队资产，让 AI 助手真正实现了从“一次性工具”到“成长型伙伴”的跨越。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FBayramAnnakov_claude-reflect_5fe37261.png","BayramAnnakov","Bayram Annakov","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FBayramAnnakov_eb1ae686.jpg","Founder & CEO @onsa.ai\r\n","onsa.ai","Seattle, WA, USA","bayram.annakov@gmail.com","Bayka","https:\u002F\u002Fonsa.ai","https:\u002F\u002Fgithub.com\u002FBayramAnnakov",[85,89],{"name":86,"color":87,"percentage":88},"Python","#3572A5",95.5,{"name":90,"color":91,"percentage":92},"Shell","#89e051",4.5,917,68,"2026-04-19T20:22:14","MIT","macOS, Linux, Windows","未说明",{"notes":100,"python":101,"dependencies":102},"该工具是 Claude Code 的插件，需先安装 Claude Code CLI。支持原生 Windows（无需 WSL）。安装后必须重启 Claude Code 才能激活插件。主要依赖本地会话历史和配置文件（如 CLAUDE.md），未提及需要额外的重型 AI 模型或 GPU 加速。","3.6+",[103],"Claude Code CLI",[36,13,27],[106,107,108,109,110],"claude-code","claude-skills","memory","productivity","self-learning",null,"2026-03-27T02:49:30.150509","2026-04-20T12:54:00.804790",[115,120,125,130,135,140],{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},44788,"修改 CLAUDE.md 文件是否总是需要人工审核？能否自动保存？","是的，人工审核（Human-in-the-loop）是 claude-reflect 的核心设计原则，旨在防止 CLAUDE.md 文件出现“上下文腐烂”（context rot）。虽然自动保存看似方便，但积累噪音的风险远大于其便利性。当前工作流确保每一条学习记录都是经过有意策划的。这是既定设计（by design），目前没有提供自动保存的设置。","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F8",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},44789,"安装插件后出现 'Duplicate hooks file detected' 错误怎么办？","该问题已在 v2.1.1 版本中修复。错误原因是 `hooks\u002Fhooks.json` 会被 Claude Code 自动加载，如果在 `plugin.json` 中显式声明会导致重复加载错误。\n\n解决方法是更新插件到最新版本：\n```bash\nclaude plugin update claude-reflect@claude-reflect-marketplace\n```","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F9",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},44790,"如何查看和管理项目中的多个 CLAUDE.md 文件（包括子目录中的文件）？","该功能已在 v2.2.0 中实现。插件现在可以自动发现子目录中的 CLAUDE.md 文件，并根据学习上下文自动建议目标文件。\n\n你可以运行以下命令查看所有已发现的 CLAUDE.md 文件：\n```bash\n\u002Freflect --targets\n```\n系统会自动建议选择最合适的文件进行修改。","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F11",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},44791,"CLAUDE.md 文件过大影响模型表现怎么办？有行数限制提醒吗？","已在 v2.3.3 版本中增加大小感知功能。最佳实践建议文件保持在 150 行以内。\n\n运行 `\u002Freflect --targets` 时会显示：\n- 每个文件的当前行数\n- ✓ 标记：低于 150 行（健康）\n- ⚠️ 标记：超过 150 行（需要注意）\n- 如果超过阈值，会自动建议运行 `--dedupe` 来合并相似条目。\n\n示例输出：\n```\n  .\u002FCLAUDE.md (project)                 156 lines  ⚠️\n⚠️  .\u002FCLAUDE.md exceeds 150 lines\n    Tip: Run \u002Freflect --dedupe to consolidate similar entries\n```","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F12",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},44792,"如何使用该技能反思现有的技能和代理（Agents）？","在 v2.2.1 版本中实现了相关功能：\n\n1. **技能发现 (`\u002Freflect-skills`)**：通过会话历史进行 AI 驱动的模式检测，识别重复的工作流和意图集群，并生成技能文件草稿供用户批准。\n2. **技能改进路由 (在 `\u002Freflect` 中)**：检测调用技能后的修正行为，AI 会判断修正是否与技能工作流相关，并提供将学到的内容路由到技能文件而不是（或除了）CLAUDE.md 的选项。","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F10",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},44793,"运行 `\u002Freflect --scan-history` 时 API 调用成本过高或触发速率限制怎么办？","这是因为语义分析默认使用了昂贵的模型（如 Opus）。可以通过指定更便宜的模型来优化成本。\n\n解决方案：\n1. 使用 `--model` 标志指定模型（推荐使用 sonnet 或 haiku）：\n   ```bash\n   \u002Freflect --scan-history --model sonnet\n   ```\n2. 语义分析任务（如文本分类、模式匹配）使用 Sonnet 即可达到类似效果，但成本仅为 Opus 的约 1\u002F10。","https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fissues\u002F16",[146,151,156,161,166,171,176,181,186,191,196,201,206,211],{"id":147,"version":148,"summary_zh":149,"released_at":150},352278,"v3.0.0-rc.1","## 新功能\n\n与 Claude Code 的全部 6 层内存实现完全集成——`\u002Freflect` 现在能够发现、路由并跨完整内存层级进行去重。\n\n### 新的内存目标\n\n| 目标 | 路径 | 描述 |\n|--------|------|-------------|\n| **项目规则** | `.claude\u002Frules\u002F*.md` | 模块化规则，可选 `paths:` 前置元数据用于路径范围限定 |\n| **用户规则** | `~\u002F.claude\u002Frules\u002F*.md` | 全局模块化规则 |\n| **CLAUDE.local.md** | `.\u002FCLAUDE.local.md` | 个人学习记录（已加入 .gitignore） |\n| **自动记忆** | `~\u002F.claude\u002Fprojects\u002F\u003Cproject>\u002Fmemory\u002F*.md` | 低置信度暂存区 |\n\n### 新特性\n\n- **层级感知路由** — 守护规则路由至 `.claude\u002Frules\u002Fguardrails.md`，模型偏好设置全局生效，低置信度内容则转入自动记忆区\n- **`\u002Freflect --organize`** — 分析内存层级结构并建议重新组织（如文件过度膨胀、放置层级错误、主题分散及可提升为更高层级的内容）\n- **跨层级重复检测** — 第 4 步现会搜索所有内存层级\n- **自动记忆丰富化** — 低置信度条目将被路由至自动记忆区，以待后续提升\n- **规则文件映射** — 根据学习类型推荐合适的规则文件，并提供 YAML 前置元数据指导\n\n### 新工具函数 (`reflect_utils.py`)\n\n- `_parse_rule_frontmatter()` — 基于行的 YAML 解析器（无需 PyYAML 依赖）\n- `get_project_folder_name()` \u002F `get_auto_memory_path()` — 自动记忆路径编码\n- `read_auto_memory()` \u002F `suggest_auto_memory_topic()` — 读取并分类自动记忆内容\n- `read_all_memory_entries()` — 跨层级读取器，用于去重\n- `find_claude_files()` — 扩展支持 `local`、`rule`、`user-rule` 类型\n- `suggest_claude_file(learning_type=)` — 增强了路由参数功能\n\n### 测试\n\n- 197 个测试通过（其中 33 个新增于 `test_memory_hierarchy.py`，另有 4 个用于保持向后兼容性）\n- 在 6 个真实仓库中进行了测试，覆盖所有层级共 971 条记录\n\n### 破坏性变更\n\n无——完全向后兼容。`find_claude_files()` 现在会在返回现有类型的同时，也包含新类型。`suggest_claude_file()` 接受可选的 `learning_type` 参数。\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.6.0...v3.0.0-rc.1","2026-02-13T04:53:23",{"id":152,"version":153,"summary_zh":154,"released_at":155},352279,"v2.6.0","## 新增功能\n\n- **会话保留警告** — SessionStart 钩子会在未配置 `cleanupPeriodDays` 时发出警告。Claude Code 默认会在 30 天后删除会话，这会影响 `\u002Freflect --scan-history` 和 `\u002Freflect-skills` 命令。一旦用户在 `~\u002F.claude\u002Fsettings.json` 中添加 `{\"cleanupPeriodDays\": 99999}`，该警告就会消失。\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.5.1...v2.6.0","2026-02-13T00:47:13",{"id":157,"version":158,"summary_zh":159,"released_at":160},352280,"v2.5.1","## 修复\n- **误报过滤** - 系统内容（`\u003Ctask-notification>`、`\u003Csystem-reminder>`、会话续写）不再触发错误的模式匹配 (#15)\n  - 在模式检测之前添加了 `should_include_message()` 过滤器\n  - 添加了 `MAX_CAPTURE_PROMPT_LENGTH`（500 字）限制 — 实际修正内容通常较短，而系统内容较长\n  - 显式标记的 `remember:` 可绕过长度限制\n\n## 变更\n- 将 `_should_include_message` 公开为 `should_include_message()`（保留向后兼容的别名）\n- 测试用例数量从 141 个增加到 160 个\n\n---\n\n感谢 @DmitryBMsk 的贡献！","2026-02-04T22:18:46",{"id":162,"version":163,"summary_zh":164,"released_at":165},352281,"v2.5.0","## 新增功能\n\n**会话开始提醒** - 当你开始一个新的 Claude Code 会话时，如果队列中存在待处理的学习内容，你会看到一条有用提醒。\n\n### 功能\n- 显示最多 5 条带有置信度分数的待处理学习内容\n- 在会话开始时出现——正是运行和反思的最佳时机\n- 可通过设置环境变量 `CLAUDE_REFLECT_REMINDER=false` 来禁用\n\n### 贡献者\n感谢 @xqliu 的贡献！(#13)\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.4.0...v2.5.0","2026-01-25T21:21:43",{"id":167,"version":168,"summary_zh":169,"released_at":170},352282,"v2.4.0","## 新功能\n\n- **捕获反馈** - 在记录学习成果时，会钩取输出确认信息\n- **视图队列中的置信度** - 显示分数、模式及相对时间戳  \n- **护栏模式检测** - 以高置信度检测“不要做X”的约束条件\n- **矛盾检测** - 在 --dedupe 中查找冲突的 CLAUDE.md 条目\n\n## 测试\n141 个测试通过（新增 15 个测试）\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.3.3...v2.4.0","2026-01-23T19:18:08",{"id":172,"version":173,"summary_zh":174,"released_at":175},352283,"v2.3.3","## 功能\n\n- `\u002Freflect --targets` 中的 **CLAUDE.md 大小感知**：\n  - 显示每个 CLAUDE.md 文件的行数\n  - 对于少于 150 行的文件显示 ✓ 标记（健康）\n  - 对于超过 150 行的文件显示 ⚠️ 标记（需要清理）\n  - 当超过阈值时自动推荐使用 `--dedupe`\n\n## 修复\n\n- 使用 Python 实现跨平台行数统计（支持 Windows）\n\n解决 #12","2026-01-11T10:10:36",{"id":177,"version":178,"summary_zh":179,"released_at":180},352284,"v2.3.2","## 修复\n\n- **Windows 路径一致性**：在所有平台上对 `relative_path` 使用正斜杠\n\n此前，`find_claude_files()` 会返回操作系统原生的路径分隔符，导致 Windows 上的路径不一致（例如 `.\u002Fsrc\\CLAUDE.md` 而不是 `.\u002Fsrc\u002FCLAUDE.md`）。","2026-01-11T09:33:19",{"id":182,"version":183,"summary_zh":184,"released_at":185},352285,"v2.3.1","## 变更内容\n\n### Bug 修复\n- `\u002Freflect-skills` 现在会在提出技能候选之前检查已存在的命令。\n- 在输出中显示“现有技能（模式匹配）”部分。\n- 避免在已存在 `\u002Fcampaign-analytics` 等命令时重复提议。\n\n### v2.3.0 变更（已包含）\n- 修正了命令目录：`.\u002Fcommands\u002F` → `.claude\u002Fcommands\u002F`。\n- 默认扫描当前项目（使用 `--all-projects` 可进行跨项目扫描）。\n- 新增项目分配步骤——询问每个技能应归属的项目。\n- 新增验证步骤，以确保技能创建后能够正常工作。\n- 使用现有的提取脚本以提升处理速度。\n- 通过 TodoWrite 跟踪进度，提高可见性。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.2.1...v2.3.1","2026-01-11T09:28:08",{"id":187,"version":188,"summary_zh":189,"released_at":190},352286,"v2.2.1","## 错误修复\n\n### 严重：会话消息提取\n- 修复了 `extract_user_messages()`，使其能够处理字符串格式的内容\n- 会话文件现在可以使用 `{\"content\": \"text\"}` 而不是 `{\"content\": [...]}` 格式\n- 此问题曾导致 `\u002Freflect-skills` 无法分析会话历史\n\n### 高：降低误报率\n- 添加了结构化的 FALSE_POSITIVE_PATTERNS，用于过滤掉非修正类消息：\n  - 以 `?` 结尾的问题\n  - 任务请求的开场白（如“请帮忙”、“你能吗”、“我需要”）\n  - 错误描述（如“无法”、“未能”）\n  - 缺陷报告（如“无法工作”、“坏了”）\n\n### 改进：基于长度的置信度调整\n- 短消息（少于80个字符）的置信度提升0.10\n- 长消息（超过150个字符）的置信度降低\n- 这有助于区分直接的修正内容与上下文较重的任务请求\n\n## 设计理念\n目前的模式检测采用**结构化信号**进行语言无关的过滤：\n- 消息长度\n- 标点符号（如问号）\n- 句子结构模式\n\n英文正则表达式模式作为快速的第一道筛选。非英文的修正内容则会在 `\u002Freflect` 运行时通过语义过滤捕获。\n\n## 测试\n- 126项测试通过\n- 新增8项测试，用于误报过滤及字符串内容处理\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fcompare\u002Fv2.2.0...v2.2.1","2026-01-11T07:23:06",{"id":192,"version":193,"summary_zh":194,"released_at":195},352287,"v2.2.0","## 新功能\n\n### 技能发现（`\u002Freflect-skills`）\n全新的人工智能驱动命令，可分析你的会话历史，发现可能转化为可复用技能的重复模式。\n\n- **AI 驱动检测** — 使用推理而非正则表达式来查找模式\n- **语义相似性** — 能够识别不同表述中的相同意图\n- **生成技能文件** — 在 `.\u002Fcommands\u002F` 目录下创建技能草稿\n\n### 技能改进路由\n当你在使用某个技能时纠正 Claude（例如 `\u002Fdeploy`），纠正内容可以直接反馈到该技能文件中：\n\n```\n用户：\u002Fdeploy\nClaude：[直接部署，未运行测试]\n用户：“不对，部署前一定要先运行测试”\n\n→ \u002Freflect 检测到这与 \u002Fdeploy 相关\n→ 提供将学习内容添加到 commands\u002Fdeploy.md 的选项\n→ 技能文件更新，新增步骤\n```\n\n### 子目录 CLAUDE.md 支持 (#11)\n现在可以发现并支持向子目录中的 CLAUDE.md 文件写入内容：\n\n- 自动发现 `.\u002F**\u002FCLAUDE.md` 文件\n- 根据学习内容智能推荐目标文件\n- 排除 node_modules、.git、venv 等目录\n\n## 完整变更日志\n- 功能：新增 AI 驱动的技能发现命令 `\u002Freflect-skills`\n- 功能：为 \u002Freflect 工作流添加技能改进路由\n- 功能：支持子目录 CLAUDE.md 的发现 (#11)\n- 测试：新增 9 个用于文件发现功能的测试\n- 文档：更新 README 和 SKILL.md 以适配新功能\n\n**119 项测试通过**","2026-01-11T06:29:25",{"id":197,"version":198,"summary_zh":199,"released_at":200},352288,"v2.1.1","## v2.1.1 - Installation Bug Fix\n\n### Fixed\n- **Plugin installation error** (#9) - Removed duplicate hooks declaration from plugin.json\n  - The `hooks\u002Fhooks.json` file is auto-loaded by Claude Code\n  - Explicitly declaring it in the manifest caused \"Duplicate hooks file detected\" error\n  - Thanks to @kaiyo655 for reporting!\n\n### Upgrade\n\n```bash\n# Update from marketplace\nclaude plugin update claude-reflect@claude-reflect-marketplace\n\n# Or reinstall\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\nclaude plugin install claude-reflect@claude-reflect-marketplace\n```\n\n---\nCloses #9","2026-01-07T06:12:24",{"id":202,"version":203,"summary_zh":204,"released_at":205},352289,"v2.1.0","## v2.1.0 - Tool Error Extraction & Workflow Tracking\n\nThis release adds two improvements to claude-reflect:\n\n### New Features\n\n#### Tool Error Extraction (#6)\nScan session files for **repeated tool execution errors** that reveal project-specific issues and convert them into CLAUDE.md guidelines.\n\n**What it extracts:**\n- Connection errors → \"Check .env for service URLs\"\n- Environment undefined → \"Load .env before accessing variables\"\n- Supabase\u002FPostgres\u002FRedis errors → \"Check config\"\n- Module not found → \"Verify project structure\"\n\n**What it excludes:**\n- Claude Code guardrails (already known to Claude)\n- Global Claude behavior (bash quoting, EISDIR)\n- One-off errors (only 2+ occurrences)\n\n**Usage:**\n```bash\n\u002Freflect --scan-history --include-tool-errors\n```\n\n#### Mandatory TodoWrite Tracking\nThe `\u002Freflect` workflow now uses **TodoWrite** to track all 10+ phases, preventing steps from being skipped.\n\n**Why this matters:**\n- Complex workflows stay on track\n- Real-time visibility into progress\n- Each step acts as a checkpoint\n\n### Files Changed\n- `commands\u002Freflect.md` - Added TodoWrite initialization + tool error step\n- `scripts\u002Fextract_tool_errors.py` - New CLI wrapper\n- `scripts\u002Flib\u002Freflect_utils.py` - Error extraction functions\n- `scripts\u002Flib\u002Fsemantic_detector.py` - Error validation\n- `tests\u002Ftest_tool_errors.py` - 20 new tests\n\n### Stats\n- 1,019 lines added\n- 130 tests total (all passing)\n\n---\nGenerated with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code)\n","2026-01-05T02:21:41",{"id":207,"version":208,"summary_zh":209,"released_at":210},352290,"v2.0.0","## 🎉 Major Release: v2.0.0\n\nThis release brings **Windows support** and **AI-powered semantic detection** to claude-reflect.\n\n### ✨ Highlights\n\n#### 🪟 Windows Support (#1)\n- All bash scripts rewritten in Python for cross-platform compatibility\n- Works natively on Windows (no WSL required)\n- GitHub Actions CI tests on Windows, macOS, and Linux\n\n#### 🌍 Multi-Language Support (#2, #3)\n- AI-powered semantic detection via `claude -p`\n- Understands corrections in **any language** (Spanish, Russian, French, etc.)\n- Hybrid detection: regex patterns (fast, real-time) + semantic AI (accurate, during \u002Freflect)\n- Filters out false positives for cleaner learnings\n\n#### 🔧 Bug Fixes\n- UserPromptSubmit hook now properly registered for automatic capture\n- Legacy bash scripts preserved in `scripts\u002Flegacy\u002F` for reference\n\n### 📊 Stats\n- **26 files changed**\n- **3,051 lines added**\n- **90 unit tests** (all passing on Windows, macOS, Linux)\n\n### 🚀 Upgrade\n\n```bash\n# Update from marketplace\nclaude plugin update claude-reflect@claude-reflect-marketplace\n\n# Or reinstall\nclaude plugin uninstall claude-reflect@claude-reflect-marketplace\nclaude plugin install claude-reflect@claude-reflect-marketplace\n```\n\n### 📋 Full Changelog\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002FBayramAnnakov\u002Fclaude-reflect\u002Fblob\u002Fmain\u002FCHANGELOG.md)\n\n---\nCloses #1, #2, #3","2026-01-04T22:22:36",{"id":212,"version":213,"summary_zh":214,"released_at":215},352291,"v1.4.0","Add confidence scoring, positive patterns, AGENTS.md sync, semantic deduplication","2026-01-03T23:49:17"]