Waza/health技能详解：诊断Claude Code环境的6层框架

【免费下载链接】waza 🥷 Engineering habits you already know, turned into skills Claude can run. 项目地址: https://gitcode.com/gh_mirrors/cl/waza

Waza/health是GitHub加速计划（cl/waza）项目中的核心诊断工具，它通过6层框架为Claude Code环境提供全面的健康检查，帮助开发者快速识别并解决环境配置、安全风险和性能优化等问题。无论是新手还是有经验的用户，都能通过这个强大的工具确保Claude在最佳状态下运行。

一、Context Layer：上下文环境检查

Context Layer是健康检查的第一层，主要关注Claude运行时的上下文环境配置。这一层通过检查CLAUDE.md文件、rules规则目录、技能描述以及MCP服务器配置等，确保系统启动时的上下文环境符合最佳实践。

在这一层中，Waza/health会验证CLAUDE.md文件是否简洁可执行、是否包含构建测试命令，以及是否存在嵌套CLAUDE.md文件导致的上下文不可预测问题。同时，它还会检查rules目录下的语言特定规则是否正确分离，避免与CLAUDE.md文件内容重复。

对于技能描述，Waza/health要求其长度不超过12个单词，并清晰说明使用场景。MCP服务器配置检查则包括评估令牌开销、服务器连接状态以及环境变量设置等，确保不会因为服务器配置问题导致上下文压力或任务失败。

二、Skill Security & Quality：技能安全与质量检查

Skill Security & Quality层专注于技能的安全性和质量评估，是保障系统安全运行的关键环节。这一层通过严格的安全检查、质量评估和来源验证，确保所有技能都符合安全标准和质量要求。

安全检查主要针对六大风险点：提示注入、数据泄露、破坏性命令、硬编码凭证、代码混淆和安全覆盖。例如，它会扫描技能中是否存在试图绕过安全检查的指令，或者可能导致数据泄露的HTTP POST请求。

质量检查则关注技能元数据的完整性、描述的准确性、内容的简洁性以及文件引用的有效性。来源验证则通过检查符号链接来源、版本信息和归属信息，确保技能的可追溯性和可靠性。

三、Context Effectiveness：上下文有效性检查

Context Effectiveness层从规则执行、上下文压力和冗余内容三个维度评估上下文的有效性。这一层帮助用户优化上下文配置，提高Claude的响应效率和准确性。

规则执行检查通过分析对话历史中的用户更正，识别规则设计中的漏洞。上下文压力检查则关注对话中出现的压缩信号，如"对话已压缩"、"上下文限制"等提示，帮助用户识别并减轻上下文压力。

冗余内容检查则通过识别钩子覆盖的规则、重叠的技能描述和跨文件重复内容，帮助用户精简上下文，提高系统性能。

四、Control + Verification Layer：控制与验证层

Control + Verification Layer是系统的控制中心，通过钩子配置、工具权限管理、凭证保护和模型验证等手段，确保系统的稳定运行和安全防护。

钩子检查确保所有钩子都符合 schema 规范，并能够提供快速反馈。工具权限管理则识别并标记危险操作，如sudo命令、强制删除根路径等。凭证保护检查确保项目范围内的秘密不会被提交或共享。

模型验证则检查设置文件中的模型ID是否符合规范，避免因模型名称错误导致的会话失败。此外，这一层还通过三层次防御一致性检查，确保关键规则在意图层、知识层和控制层都得到有效实施。

五、Behavior Pattern Audit：行为模式审计

Behavior Pattern Audit层通过分析最近的对话记录，识别系统行为中的问题模式。这一层帮助用户发现并纠正长期存在的问题，提高系统的可靠性和用户体验。

规则违反检查识别直接违反NEVER/ALWAYS规则的行为。重复更正检查则发现至少在两次对话中出现的相同问题，提示用户需要改进相关规则或流程。

缺失模式检查帮助识别在对话中得到强化但未在CLAUDE.md中记录的项目特定行为。技能使用频率分析则建议将不常用的技能归档，以减少上下文负担。

六、MCP Configuration：MCP配置检查

MCP Configuration层专注于MCP服务器的配置优化，确保其高效、安全地运行。这一层检查包括服务器数量控制、文件系统访问配置和性能优化建议等。

服务器数量检查确保启用的MCP服务器数量不会影响性能。文件系统访问配置检查则确保MCP服务器有适当的目录访问权限。性能优化建议则包括识别并断开空闲服务器，以回收上下文资源。

通过这6层框架，Waza/health为Claude Code环境提供了全面的健康诊断。无论是环境配置、安全风险还是性能优化，Waza/health都能帮助用户快速识别问题并提供解决方案。要开始使用Waza/health，只需克隆项目仓库：git clone https://gitcode.com/gh_mirrors/cl/waza，然后按照文档中的说明运行健康检查脚本。

通过定期运行Waza/health，开发者可以确保Claude始终在最佳状态下运行，提高开发效率并减少潜在风险。无论是个人项目还是团队协作，Waza/health都是保障Claude Code环境健康的必备工具。

【免费下载链接】waza 🥷 Engineering habits you already know, turned into skills Claude can run. 项目地址: https://gitcode.com/gh_mirrors/cl/waza