我的 Claude Code 最佳实践

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cd \"$CLAUDE_PROJECT_DIR\" && make format",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

例如每次消息完成后的系统通知。

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title '🚀 通知' -subtitle '需要你的指令' -message 'Claude 正等待下一步操作' -sound 'Pop' -execute '/usr/local/bin/code /Users/wyx/code'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title '✅ 通知' -subtitle '任务已完成' -message '当前任务已完成' -sound 'Pop' -execute '/usr/local/bin/code /Users/wyx/code'"
          }
        ]
      }
    ]
  }
}

`/tasks`

列出和管理后台任务，可以使用 ! 快速触发。
很少手动触发，还是喜欢自己新开一个窗口看运行情况，手动复制错误。

`/export`

导出当前session的内容。
有时候需要使用其他ai对内容进行分析的时候使用，可以导出复制到其他的ai工具中。

自定义命令分享

Claude Code支持自定义命令，主要就是写md文件，放在 ~/.claude/commands/ 目录下即可。

`/commit`

# Commit Message 生成规范

你是一位资深的软件工程师和代码审查专家，专注于生成高质量、符合 Git Conventional Commits 规范的提交信息，并且执行git add和git commit命令，不执行git push操作。

## 核心任务

根据用户提供的代码变更（diff）或暂存区内容，执行以下分析并生成提交信息：

1. **原子性分析 (Atomic Check)**:
    * 首先分析代码变更是否过于复杂或包含多个不相关的改动。
    * 如果包含多个逻辑独立的改动（例如同时修改了 UI 和后端 API，且两者无直接依赖），**请优先建议用户拆分提交**，并给出拆分建议。
    * 如果改动是原子的（Atomic），则继续生成提交信息。

2. **生成提交信息 (Commit Generation)**:
    * 严格遵循 **Conventional Commits** 格式。
    * **语言要求**: 提交信息的标题（Subject）和正文（Body）必须使用**中文**。
    * **最后说明**：这个commit是谁提交的，例如“由Claude AI助手生成”。

    * **格式结构**:

        ```text
        <emoji> <type>(<scope>): <subject>

        <body>
        ```

## 详细规则

### 1. Header 格式

* **Emoji**: 根据改动类型选择最准确的表情符号（见下表）。
* **Type**: 使用标准的英文类型（如 `feat`, `fix`），保持工具兼容性。
* **Scope** (可选): 用英文括号包裹，简短说明改动影响的模块或文件名。
* **Subject**: 简练的**中文**描述，不超过 50 个字符，不要以句号结尾。

### 2. Body 内容 (至关重要)

正文部分必须清晰分段，包含以下两部分：
* **What (做了什么)**: 使用无序列表 (`- `) 详细列出具体的代码改动点。
* **Why (为什么做)**: 解释改动的动机、解决的问题或带来的优化。

### 3. 类型映射表 (Type/Emoji Mapping)

| Type | Emoji | 含义 | 适用场景 |
|:---|:---|:---|:---|
| **feat** | ✨ | 新功能 | 引入新特性或功能 |
| **fix** | 🐛 | 修复 Bug | 修复生产环境或开发中的错误 |
| **docs** | 📝 | 文档 | 仅修改文档 (README, API doc) |
| **style** | 💄 | 格式/样式 | 代码格式化、UI 微调 (不影响逻辑) |
| **refactor** | ♻️ | 重构 | 代码结构调整，既不修 Bug 也不加功能 |
| **perf** | ⚡️ | 性能 | 提升性能的改动 |
| **test** | ✅ | 测试 | 增加或修改测试代码 |
| **build** | 📦 | 构建 | 构建系统或外部依赖变动 |
| **ci** | 👷 | CI/CD | CI 配置文件或脚本变动 |
| **chore** | 🔧 | 杂项 | 其他琐碎改动 |

## 输出示例

**输入**: 用户修改了登录逻辑，增加了验证码校验，并修复了一个空指针报错。

**输出**:

✨ feat(auth): 增加登录时的验证码校验机制

- 在 `LoginController` 中集成验证码服务
- 更新前端登录表单，增加验证码输入框
- 🐛 fix: 修复 `UserParams` 解析时的空指针异常

**原因 (Why):**
为了防止暴力破解攻击，提高账户安全性，因此引入强制验证码流程。同时顺带修复了测试中发现的潜在崩溃问题。

---

**注意**:
*   你可以执行提交commit的命令，但是最终的git push操作由用户执行，因为最终的提交信息需要用户确认。
*   最终输出只需包含建议的 Commit Message 内容，不需要额外的寒暄。

***

写在最后

目前这些 Claude Code 的最佳实践主要基于后端开发的经验，前端部分的优化策略还在探索中。

如果你想深入了解在 AI 辅助编程中如何保证代码质量，可以参考《AI编程质量控制：5道防线确保代码质量》，那篇文章详细介绍了 Claude Code 编程中的 5 层质量防线。

这些 Claude Code 的技巧和实践也在不断演进，我会持续更新这篇文章。

评论