Hooks 指南

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"\\(.tool_input.command) - \\(.tool_input.description // \"No description\")\"' >> ~/.claude/bash-command-log.txt"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.ts$'; then npx prettier --write \"$file_path\"; fi; }"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/markdown_formatter.py"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""
Markdown formatter for Claude Code output.
Fixes missing language tags and spacing issues while preserving code content.
"""
import json
import sys
import re
import os
 
def detect_language(code):
    """Best-effort language detection from code content."""
    s = code.strip()
 
    # JSON detection
    if re.search(r'^\\s*[{\\[]', s):
        try:
            json.loads(s)
            return 'json'
        except:
            pass
 
    # Python detection
    if re.search(r'^\\s*def\\s+\\w+\\s*\\(', s, re.M) or \
       re.search(r'^\\s*(import|from)\\s+\\w+', s, re.M):
        return 'python'
 
    # JavaScript detection
    if re.search(r'\\b(function\\s+\\w+\\s*\\(|const\\s+\\w+\\s*=)', s) or \
       re.search('=>|console\\.(log|error)', s):
        return 'javascript'
 
    # Bash detection
    if re.search(r'^#!.*\\b(bash|sh)\\b', s, re.M) or \
       re.search(r'\\b(if|then|fi|for|in|do|done)\\b', s):
        return 'bash'
 
    return 'text'
 
def format_markdown(content):
    """Format markdown content with language detection."""
    # Fix unlabeled code fences
    def add_lang_to_fence(match):
        indent, info, body, closing = match.groups()
        if not info.strip():
            lang = detect_language(body)
            return f"{indent}```{lang}\\n{body}{closing}\\n"
        return match.group(0)
 
    fence_pattern = r'(?ms)^([ \\t]{0,3})```([^\\n]*)\\n(.*?)(\\n\\1```)\\s*$'
    content = re.sub(fence_pattern, add_lang_to_fence, content)
 
    # Fix excessive blank lines
    content = re.sub(r'\\n{3,}', '\\n\\n', content)
 
    return content.rstrip() + '\\n'
 
# Main execution
try:
    input_data = json.load(sys.stdin)
    file_path = input_data.get('tool_input', {}).get('file_path', '')
 
    if not file_path.endswith(('.md', '.mdx')):
        sys.exit(0)  # Not a markdown file
 
    if os.path.exists(file_path):
        with open(file_path, 'r', encoding='utf-8') as f:
            content = f.read()
 
        formatted = format_markdown(content)
 
        if formatted != content:
            with open(file_path, 'w', encoding='utf-8') as f:
                f.write(formatted)
            print(f"✓ Fixed markdown formatting in {file_path}")
 
except Exception as e:
    print(f"Error formatting markdown: {e}", file=sys.stderr)
    sys.exit(1)

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Awaiting your input'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 -c \"import json, sys; data=json.load(sys.stdin); path=data.get('tool_input',{}).get('file_path',''); sys.exit(2 if any(p in path for p in ['.env', 'package-lock.json', '.git/']) else 0)\""
          }
        ]
      }
    ]
  }
}

ralph:
  enabled: true
  hooks:
    post_tool_lsp:
      enabled: true
      severity_threshold: error  # error | warning | info

ralph:
  enabled: true
  loop:
    max_iterations: 10
    auto_fix: false
    completion:
      zero_errors: true
      zero_warnings: false
      tests_pass: true
      coverage_threshold: 85

constitution:
  quality_gate:
    max_errors: 0
    max_warnings: 10
    enabled: true

{
  "lsp_errors": 0,
  "lsp_warnings": 2,
  "type_errors": 0,
  "lint_errors": 0,
  "passed": true,
  "reason": "Quality gate passed: LSP diagnostics clean"
}

.claude/hooks/moai/lib/
├── __init__.py
├── atomic_write.py           # 原子写入操作
├── checkpoint.py             # 检查点管理
├── common.py                 # 通用工具
├── config.py                 # 配置管理
├── config_manager.py         # 配置管理器 (高级)
├── config_validator.py       # 配置验证
├── context_manager.py        # 上下文管理 (快照、归档)
├── enhanced_output_style_detector.py  # 输出样式检测
├── file_utils.py             # 文件工具
├── git_collector.py          # Git 数据收集
├── git_operations_manager.py # Git 运算管理器 (优化)
├── language_detector.py      # 语言检测
├── language_validator.py     # 语言验证
├── main.py                   # 主入口点
├── memory_collector.py       # 内存收集
├── metrics_tracker.py        # 指标追踪
├── models.py                 # 数据模型
├── path_utils.py             # 路径工具
├── project.py                # 项目相关
├── renderer.py               # 渲染器
├── timeout.py                # 超时处理
├── tool_registry.py          # 工具注册表 (格式化器、语法检查器)
├── unified_timeout_manager.py # 统一超时管理器
├── update_checker.py         # 更新检查
├── version_reader.py         # 版本读取
├── alfred_detector.py        # Alfred 检测
└── shared/utils/
    └── announcement_translator.py  # 公告翻译

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start__show_project_info.py\"'"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/pre_tool__security_guard.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__code_formatter.py\"'",
            "timeout": 30000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__linter.py\"'",
            "timeout": 60000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__ast_grep_scan.py\"'",
            "timeout": 30000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__lsp_diagnostic.py\"'"
          }
        ]
      }
    ],
    "PreCompact": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/pre_compact__save_context.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_end__auto_cleanup.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/stop__loop_controller.py\"'"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""自定义 PostToolUse Hook: 文件修改后执行特定检查"""
 
import json
import sys
 
 
def main():
    # 从 stdin 读取 Hook 输入数据
    input_data = json.loads(sys.stdin.read())
 
    tool_name = input_data.get("tool_name", "")
    tool_input = input_data.get("tool_input", {})
    file_path = tool_input.get("file_path", "")
 
    # 检查逻辑
    if file_path.endswith(".py"):
        # Python 文件自定义检查
        result = check_python_file(file_path)
 
        if result["has_issues"]:
            # 向 Claude Code 传递反馈
            output = {
                "hookSpecificOutput": {
                    "hookEventName": "PostToolUse",
                    "additionalContext": result["message"]
                }
            }
            print(json.dumps(output))
            return
 
    # 没有问题则抑制输出
    output = {"suppressOutput": True}
    print(json.dumps(output))
 
 
def check_python_file(file_path: str) -> dict:
    """Python 文件自定义检查"""
    # 实现检查逻辑
    return {"has_issues": False, "message": ""}
 
 
if __name__ == "__main__":
    main()

{
  "tool_name": "Write",
  "tool_input": {
    "file_path": "/path/to/file.py",
    "content": "文件内容..."
  },
  "tool_output": "文件输出结果 (仅 PostToolUse)"
}

.claude/hooks/moai/
├── __init__.py                        # 包初始化
├── session_start__show_project_info.py # 会话开始
├── pre_tool__security_guard.py         # 安全守卫
├── post_tool__code_formatter.py        # 代码格式化器
├── post_tool__linter.py                # 语法检查器
├── post_tool__ast_grep_scan.py         # AST-grep 扫描
├── post_tool__lsp_diagnostic.py        # LSP 诊断
├── pre_compact__save_context.py        # 上下文保存
├── session_end__auto_cleanup.py        # 自动清理

├── stop__loop_controller.py            # 循环控制器
├── quality_gate_with_lsp.py            # 质量门控
└── lib/                                # 共享库
    ├── atomic_write.py                 # 原子写入
    ├── checkpoint.py                   # 检查点
    ├── common.py                       # 通用工具
    ├── config.py                       # 配置
    ├── config_manager.py               # 配置管理器
    ├── config_validator.py             # 配置验证
    ├── context_manager.py              # 上下文管理
    ├── git_operations_manager.py       # Git 运算管理
    ├── tool_registry.py                # 工具注册表
    ├── unified_timeout_manager.py      # 超时管理
    └── ...                             # 其他模块

export MOAI_DISABLE_AST_GREP_SCAN=1