关键词

LLM开发助手智能代码辅助自动化开发工作流代码质量分析安全开发

项目简介

'claude-code-config' 仓库包含了 Grey Haven Studio 为 Claude Code LLM 客户端打造的完整生态系统，包括插件包、智能技能（Skills）和命令行工具。它通过一系列可插拔的“钩子”（Hooks）脚本，在 LLM 与代码交互的不同阶段（如提交用户 Prompt、执行工具、停止会话等）提供智能上下文增强、代码质量检查、安全验证、自动化工作流编排等功能。这些钩子以标准化的 JSON 消息进行通信，共同构成一个灵活、可扩展的 MCP 服务后端，旨在提升开发者在 LLM 驱动环境中的生产力。

主要功能点

  • 智能Prompt增强: 自动识别用户 Prompt 意图，并注入相关代码文件引用、测试覆盖、依赖信息、API 上下文和数据库上下文等，丰富 LLM 对项目背景的理解。
  • 代码质量与安全保障: 在代码修改或执行命令前，进行安全漏洞扫描、API 契约验证、代码风格检查、潜在性能回归检测，确保代码质量和安全性。
  • 自动化工作流与子Agent协调: 根据任务类型智能准备子 Agent 所需上下文，并在子 Agent 完成任务后进行结果处理和后续工作流的编排（例如，代码分析后自动触发代码重构或测试生成）。
  • 开发辅助与代码优化: 自动整理代码导入、查找相似代码模式以建议重构、生成测试数据、提供代码变更的非技术性解释（Code Narrator）和迁移建议。
  • 会话管理与工作完成验证: 在会话结束时，检查未提交的更改、未解决的 TODO、测试状态、文档更新等，确保工作完整性。
  • 资源管理与能力声明: 通过 CLI 工具管理这些功能组件，并允许 Claude Code 客户端根据配置调用相应的服务。

安装步骤

  1. 克隆仓库 (获取插件和钩子文件): 在您的用户主目录下克隆仓库，例如：

    git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

  2. 配置插件市场 (连接Claude Code客户端): 编辑 '~/.claude/settings.json' 文件（如果不存在则创建），添加本地插件市场路径。这个配置会告诉 Claude Code 客户端您的插件和钩子在哪里：

    {
  "plugin": {
    "marketplaces": [{
      "name": "grey-haven-plugins",
      "source": "/Users/YOUR_USERNAME/grey-haven-plugins/grey-haven-plugins" 
    }],
    "install": [
      "grey-haven-core@grey-haven-plugins",
      "grey-haven-developer-experience@grey-haven-plugins",
      "grey-haven-observability@grey-haven-plugins"
    ]
  }
}

    注意: 请务必将 '/Users/YOUR_USERNAME/' 替换为您的实际用户主目录路径。

  3. 安装CLI工具 (可选，用于钩子管理及其他CLI功能):

    npm install -g @greyhaven/claude-code-config

  4. 安装并激活钩子 (激活智能辅助功能): 运行以下命令将必要的钩子脚本复制到 Claude Code 的配置目录，并使其可执行。部分 Python 钩子可能需要额外安装 Python 依赖，系统会自动提示并引导您安装。

    claude-config install-hooks
claude-config install-skills

服务器配置

该项目作为一组与“Claude Code”客户端紧密集成的 MCP 服务组件工作。MCP 客户端（即“Claude Code”应用本身）会通过标准输入/输出 (Stdio) 协议，根据预定义的事件（如用户 Prompt 提交、工具调用前后、会话结束等）来自动调用这些 Python 或 Node.js 脚本（Hooks）。

作为用户，您无需手动配置 MCP 服务器的启动命令，因为这些钩子脚本是作为 Claude Code 应用内部事件处理的一部分被调用的。您只需按照上述“安装步骤”配置 '~/.claude/settings.json' 文件并运行 'claude-config install-hooks'，Claude Code 客户端就会自动发现并加载这些钩子作为其 MCP 服务端功能。

配置信息 (仅作示意，无需手动修改，由 'claude-config install-hooks' 命令自动完成):

Claude Code 客户端会生成类似于以下的配置，以调用这些钩子：

  • Prompt Enhancer (Prompt增强钩子)

    • 服务名称: Prompt Enhancer
    • 调用命令: 'python3'
    • 参数: '/Users/YOUR_USERNAME/.claude/hooks/prompt-enhancer.py'
    • 说明: 当用户提交 Prompt 时，Claude Code 会调用此钩子。该钩子接收 Prompt 和当前工作目录信息，分析意图并返回额外的上下文，以增强 LLM 对任务的理解。

  • Security Validator (安全验证钩子)

    • 服务名称: Security Validator
    • 调用命令: 'python3'
    • 参数: '/Users/YOUR_USERNAME/.claude/hooks/security-validator.py'
    • 说明: 在 Claude Code 尝试执行文件写入、编辑或 Bash 命令前调用此钩子。它会检查操作是否涉及敏感文件或危险命令，并可决定阻止（block）该操作。

  • Work Completion Assistant (工作完成辅助钩子)

    • 服务名称: Work Completion Assistant
    • 调用命令: 'python3'
    • 参数: '/Users/YOUR_USERNAME/.claude/hooks/work-completion-assistant.py'
    • 说明: 当 Claude Code 尝试结束工作会话时调用此钩子。它会检查代码库状态，如未提交更改、未解决的 TODO、测试情况等，并提供工作完成度的反馈或阻止会话结束。

重要提示: 用户只需确保 Python 3 和 Node.js 环境已正确安装，并运行 'claude-config install-hooks'，即可自动完成所有 MCP 服务端的配置。

基本使用方法

安装完成后，这些智能辅助功能将自动在 Claude Code 客户端中生效，无需额外手动操作：

  • Prompt增强: 当您在 Claude Code 中输入 Prompt 时，系统会自动分析并注入相关上下文。
  • 代码风格与提交辅助: 编写代码后，智能技能会自动检测代码风格、生成提交信息或 PR 描述（例如，当您在 VS Code 中保存文件或尝试提交代码时）。
  • 插件命令调用: 在 Claude Code 界面中，通过输入斜杠命令（如 '/tdd-implement'、'/code-review'）即可调用特定的代理和命令，执行复杂开发任务。
  • 诊断工具: 运行 'claude-config doctor' 可检查安装状态和依赖问题。

信息

分类

开发者工具

访问项目