/ 目录 / 演练场 / claude-reflect
← 全部服务器 ↗ GitHub
● 社区 BayramAnnakov ⚡ 即开即用

claude-reflect

作者 BayramAnnakov · BayramAnnakov/claude-reflect

Claude Code 悄悄学习你的纠正方式——捕获规则、偏好和认可，然后将其写入 CLAUDE.md / AGENTS.md。

claude-reflect 在 Claude Code 会话后台运行，监视你纠正、表扬或重述偏好的时机。它将这些提炼为持久规则，并更新 CLAUDE.md 和 AGENTS.md，让后续会话继承这些规则。这是手动维护指令文件的轻量替代方案。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： claude-reflect

无需手动维护，让 CLAUDE.md 自动演进

👤 讨厌维护文档的独立开发者 ⏱ ~5 min beginner

何时使用： 你希望 CLAUDE.md 能跟上你的偏好，而不需要成为一项写作负担。

步骤
  1. 正常工作
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ 已复制
    → Skill 在后台悄悄捕获——你感觉不到
  2. 每日结束时审查
    Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ 已复制
    → 5–10 条候选规则，附带来源（哪次会话、哪个 prompt）
  3. 提交差异
    Apply approved rules and commit CLAUDE.md.✓ 已复制
    → 整洁的 git diff；规则现在生效

结果： CLAUDE.md 随你成长，无需手动维护成本。

注意事项
  • Skill 将一次性的临时上下文捕获为持久规则 — 始终审查每日候选项；拒绝任何仅适用于特定情境的规则
搭配使用： filesystem

从集体纠正中建立团队 AI 规范

👤 正在统一 AI 工作流的技术负责人 ⏱ ~60 min intermediate

何时使用： 多名开发者都在对 Claude 的相同问题进行纠正；你想建立共享规则集。

步骤
  1. 收集每位开发者的草稿
    Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ 已复制
    → 分支中有 N 条待审规则
  2. 合并会话
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ 已复制
    → 共识规则集
  3. 推广
    Merge to main. New AGENTS.md applies to everyone.✓ 已复制
    → 团队使用相同基线；各自的本地规则保留

结果： 自下而上的规范统一，无需流程委员会。

注意事项
  • 话多的开发者主导；安静的人的规律被遗漏 — 确保每个人都运行 skill；按反射事件加权，而非按文件编辑次数
搭配使用： github

审计并清理 CLAUDE.md 中的过时规则

👤 长期使用 CLAUDE.md 的用户 ⏱ ~25 min intermediate

何时使用： 你的 CLAUDE.md 现在有 600 行，Claude 的上下文已经臃肿。

步骤
  1. 评分相关性
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ 已复制
    → 每条规则的得分
  2. 提出删除建议
    Suggest 30 rules to remove (stale or obsolete).✓ 已复制
    → 带理由的删除列表
  3. 差异对比并提交
    Apply approved removals; commit with message 'reflect: prune stale rules'.✓ 已复制
    → 更精简的 CLAUDE.md

结果： CLAUDE.md 变得真正有人读，而非随意扫一眼。

注意事项
  • 删除了一条「没被应用是因为 Claude 一直在遵守它」的规则 — 拿不准时保留——但标注「最后验证时间」，以便下个季度复查

组合

与其他 MCP 搭配，撬动十倍杠杆

claude-reflect-skill + pro-workflow-skill

pro-workflow 用于显式捕获，claude-reflect 用于被动捕获——双通道学习

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ 已复制
claude-reflect-skill + github

通过 PR 审查规则变更

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
watch_session — 始终在线的后台进程 0
review_candidates since? 每日/每周审批循环 0
consolidate scope? 定期去重 / 矛盾解决 0
score_rules — 清理前的审计 0
apply_to_files approved_ids[], files[] 将已审批的候选项写入 CLAUDE.md / AGENTS.md 0

成本与限制

运行它的成本

API 配额
无——本地
每次调用 Token 数
后台捕获免费；审查/整合在配置了本地 LLM 时使用
费用
免费
提示
保守地审批候选项——质量优于数量

安全

权限、密钥、影响范围

最小权限： filesystem-write
凭据存储： Skill 状态在 .claude/reflect/ 中；如需共享可提交到仓库
数据出站： 默认无

故障排查

常见错误与修复

没有候选项被捕获

确认 skill 在 CLAUDE.md 前言中被调用；检查 .claude/reflect/log 中是否有条目

候选项全是噪音

收紧触发灵敏度；只从明确的纠正中捕获，而非普通聊天

AGENTS.md 与 CLAUDE.md 产生漂移

定期运行整合；工具设计为保持同步，但手动编辑会导致分歧

审批 prompt 太多压力大

每天用 --limit 5 运行审查；养成习惯，而不是一次处理 50 条

替代方案

claude-reflect 对比其他方案

替代方案何时用它替代权衡
pro-workflow-skill你偏好显式捕获和 worktree 编排更手动；对并行工作更有力
Manual CLAUDE.md curation你足够自律，可以自己编写规则经常被忽略；依赖意志力

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills