/refine:Claude代码配置审计员
一种元技能,可以审计、评分和改进任何项目的Claude代码配置。它分析您的CLAUDE.md、技能、代理、钩子、MCP服务器和设置,然后提供一个带有可操作改进的评分报告卡。
为什么存在
大多数Claude Code项目的配置都很糟糕。一个典型的项目只有一个基本的CLAUDE.md,没有其他任何东西,忽略了10多个可用的配置杠杆(技能、子代理、钩子、MCP服务器、路径范围规则、设置、渐进式披露、自动记忆)。
配置质量直接决定输出质量。 一个写着“让它看起来不错”的提示会得到通用的输出。一个提示“带有大量负空间和尖锐橙色口音的豪华社论”得到了独特的输出。同样的原则也适用于项目配置。模糊的CLAUDE.md文件会产生模糊的CLAUDE行为。
灵感
这项技能源于分析为什么 /frontend-design 技能产生卓越的产出。答案是: 约束驱动的提示。
- 禁止违约:反模式(“永远不要做X”)比正面指示更有用
- 武力意图:行动前的强制思考(评分前扫描,实施前评分)
- 要具体:具体的指导,而不是模糊的愿望
- 提供参考资料:按需加载精心策划的知识,而不是将其倾倒在上下文中
这些技术与前30项技能相同 技能s.sh 用途:防止过早行动的阶段门控工作流,打破默认设置的明确反模式,以及执行前由面试驱动的上下文收集。
关键见解
最好的技能有一个公式: 特异性孕育质量。 系统调试技能有一个“铁律”,要求在没有根本原因调查的情况下不进行任何修复。头脑风暴技能有一个硬门,在用户批准设计之前会阻止实施。这些不可谈判的约束,而不是模糊的建议,是产生高质量产出的原因。
/refine 将这一理念应用于元层:Claude Code配置本身。它将从顶级社区技能、官方Anthropic文档和现实世界项目分析中学到的知识整合到一个交互式工作流程中。
为什么面试驱动
不同的项目类型需要不同的配置。独立开发人员的Python CLI需要与团队的React monorepo不同的钩子和技能。与其生成通用建议, /refine 就它发现的差距与你面谈,确保建议是针对项目类型的,而不是一刀切。
安装
npx skills add meetdave3/refine-skill用法
全面审计+实施
/refine运行所有4个阶段:扫描你的项目,对8个维度进行评分,就差距与你面谈,然后在你的批准下一次实施一个修复。
仅审核(无更改)
/refine audit扫描并评分您的项目。生成带有字母等级(a-F)的报告卡。未修改任何文件。
权宜之计
/refine quick扫描、评分、跳过面试,并实施前3个影响最大的修复。
它得分多少
| # | 维度 | 它测量什么 |
|---|---|---|
| 1 | CLAUDE.md质量 | 结构、特异性、反模式、技术栈文档 |
| 2 | 开发工作流程 | 测试/lint/build命令、斜线命令 |
| 3 | 技能覆盖 | 领域知识、设计体系、重复模式 |
| 4 | 代理架构 | 专业化、授权、团队结构 |
| 5 | 自动化(钩子) | PostToolUse测试、验证循环、停止钩子 |
| 6 | 工具集成 | MCP服务器、权限、外部工具访问 |
| 7 | 护栏 | 指定反模式、路径范围规则、安全网 |
| 8 | 上下文效率 | 渐进式披露、引用拆分、代币预算 |
每个维度得分为0-3。总计/24张映射到字母等级:
| 分数 | 等级 |
|---|---|
| 21-24 | A |
| 17-20 | B |
| 12-16 | C |
| 7-11 | D |
| 0-6 | F |
运作原理
第一阶段:扫描
运行一个自动扫描程序,检测您的项目类型(语言、框架、库),查找所有Claude配置文件,并检查Claude.md质量信号。
第二阶段:得分
使用扫描的证据对8个维度中的每一个进行评分。每一个分数都有具体的发现支持,从不猜测。
第三阶段:访谈
针对配置中发现的差距,最多可提出5个有针对性的问题。仅询问得分低于2的维度。跳过 quick 模式。
第四阶段:实施
生成按影响排序的特定更改(首先是CLAUDE.md,最后是设置)。每项更改在应用之前都会单独提交供您批准。
输出示例(审核模式)
## Score Report
| # | Dimension | Score | Evidence |
|---|----------------------|-------|---------------------------------------------|
| 1 | CLAUDE.md Quality | 2/3 | Good structure, missing anti-patterns |
| 2 | Development Workflow | 3/3 | All commands present and documented |
| 3 | Skills Coverage | 2/3 | 6 skills, but no reference files in 2 |
| 4 | Agent Architecture | 2/3 | 5 agents with clear specializations |
| 5 | Automation (Hooks) | 1/3 | Only test hook, no typecheck or lint hooks |
| 6 | Tool Integration | 0/3 | No MCP servers configured |
| 7 | Guard Rails | 2/3 | Anti-patterns in CLAUDE.md, not in skills |
| 8 | Context Efficiency | 2/3 | Good splitting, CLAUDE.md slightly long |
| | TOTAL | 14/24 | Grade: C |支持的项目类型
- JavaScript/TypeScript(React、Next.js、Vue、Svelte、Express、Hono、Fastify)
- Python(FastAPI、Django、Flask)
- 走
- 锈
- Ruby(Rails)
存储库结构
refine-skill/
├── README.md
├── LICENSE
├── CLAUDE.md
└── skills/
└── refine/
├── SKILL.md # 4-phase workflow orchestrator
├── scripts/
│ └── scan_project.sh # Automated project scanner
└── references/
├── scoring-rubric.md # 8-dimension scoring criteria
├── claude-md-patterns.md # CLAUDE.md templates + anti-patterns
├── skills-and-agents.md # Decision framework
├── hooks-and-automation.md # Hook recipes, MCP patterns
└── project-archetypes.md # Per-project-type configs许可证
麻省理工学院
