玩转 Claude Code 的 Commands 和 Hooks：让 AI 自动执行你的进阶工作流

type

Post

status

Published

date

Oct 16, 2025

slug

claude-code-commands-hooks-ai-advanced-y5oraw

summary

📌 来自：faafospecialist.substack.com (Substack) | 💡 s：让 AI 自动执行你的进阶工作流 HOOK: 像配置游戏宏一样，让 AI 自动完成繁琐的开发任务。本文深入介绍了 Claude Code 中两个极具潜力但常被忽视的功能：Commands（命令）和 Hooks（钩子）。Commands 允许用户将常用的 Prompt（提示词）打包成快捷指令，并赋予其比系统提示词更高的权重；Hooks 则能实现操作的自动化触发，例如任务完成后自动发送 Telegram 通知或语音提醒。通过这些工具，开发者可以构建出高度定制化、自动化的 AI 开发环境。 | 🔑 关键词：Substack、faafospecialist.substack.com、FA&FO | 🤖 由Gemini 3 Flash (Google API)分析生成

什么是 Commands？

Commands（命令）是一种快速发送预制 Prompt 模板的方式。

与 `CLAUDE.md` 或 `AGENTS.md` 这种属于 System Prompts（系统提示词）的文件不同，Commands 属于 User Prompts（用户提示词）。这意味着它们在模型处理时具有更高的权重和优先级。如果你发现自己反复输入相同的指令，现在可以将它们封装成一个命令，并通过 `/<command-name>` 快速调用。

如何创建 Commands

创建过程非常简单。在 `~/.claude/commands` 目录下创建一个 Markdown 文件，结构如下：

description: 描述这个命令的功能

在这里编写你的 Prompt

$ARGUMENTS

你可以在所有项目中使用 `/<command-name>`。如果你只想为当前项目创建特定命令，只需在项目的 `./.claude/commands` 目录下创建即可。

注：`$ARGUMENTS` 是命令后跟随的参数值，会被插入到指定位置（例如：`/fix 默认语言错误`）。

专家技巧

在我之前的文章中提到过，Commands 是在需要时召唤 Subagents（子智能体）的最佳方式。因此，我们可以在每个命令中创建详细且清晰的工作流，根据不同任务进行定制。

例如：`fix-ci.md`

description: 读取、分析、调试并修复失败的 Github Actions 测试

读取、分析、调试并修复失败的 Github Actions 测试：$ARGUMENTS

流程：

使用 `debugger` 智能体读取并分析 Github Actions 日志

使用 `planner` 智能体规划修复方案

使用 `tester` 智能体测试修复结果，确保所有测试套件通过

我常用的 Commands 列表

我将自己创建的所有命令文件都放在了 [这个仓库] 中，包括我目前使用的所有优化后的 Subagent 设置。

/ask

用于询问有关代码库的任何问题。

description: 回答技术和架构问题。

上下文

技术问题或架构挑战： $ARGUMENTS

将使用 @ 文件语法引用相关的系统文档。

你的角色

你是一名提供专家咨询的 Senior Systems Architect（高级系统架构师）。你专注于高层设计和战略决策，而非实现细节。你协调四个专业的架构顾问：

Systems Designer（系统设计师）

Technology Strategist（技术战略家）

Scalability Consultant（可扩展性顾问）

Risk Analyst（风险分析师）

/cook

在我的系统提示词中，已经包含了工作流的三个重要部分：核心职责、子智能体团队和开发规则。调用此命令可实现需要整个团队协作的功能或复杂 Bug 修复。

description: 实现一个功能

严格遵守你的核心职责、子智能体团队和开发规则。开始执行此任务：$ARGUMENTS

/fix

用于需要快速修复的小型 Bug。

description: [快速] 分析并修复问题

分析并修复此问题：<issue> $ARGUMENTS </issue>

/fix-test

在本地运行测试套件。如果有失败的测试，不惜一切代价修复它们，直到通过。

description: 运行测试流并修复问题

使用 `debugger` 和 `tester` 子智能体寻找根源并实施修复。完成后交给 `code-reviewer` 审核。

/watzup

在 Vibe Coding（氛围编程）时，这个命令非常有用。因为代码是 AI 写的，过几天我可能就不记得做了什么。

description: 回顾最近的更改并总结工作

查看当前分支和最近的提交。提供详细的更改摘要，分析整体影响。

Hooks 是什么？

简单来说，Hooks（钩子）就像你在游戏中设置的 自动设置。你不再是希望 AI 记住做某事，而是通过编程告诉它：“每当你做 X 时，必须做 Y。”

目前有 8 种主要的 Hooks 类型：

**UserPromptSubmit**：发送查询时立即运行。

**PreToolUse**：在使用工具前运行（可以拦截工具）。

**PostToolUse**：工具使用完成后运行。

**Notification**：发送通知时运行。

**Stop**：完成响应时运行。

**SubagentStop**：子智能体完成任务时运行。

**PreCompact**：压缩前运行。

**SessionStart**：会话开始时运行。

Hooks 使用案例

1. 完成工作后发送通知

我使用 Hook 让 Claude Code 在完成任务后通过 Telegram 发送通知。

步骤：

通过 `@BotFather` 创建 Telegram Bot。

获取 Chat ID。

设置环境变量： `TELEGRAM_BOT_TOKEN` 和 `TELEGRAM_CHAT_ID`。

安装 Hook。

现在，每次 Claude Code 完成任务，我的手机都会收到摘要通知，我只需回去查看即可。

2. TTS + Hook = 语音助手

把 Claude Code 变成一个会说话的助手。

步骤：

在 `~/.claude/settings.json` 中配置 Hooks，指向一个 Python 脚本。

创建 `notification.py` 脚本，使用 `pyttsx3` 库实现 Text-to-Speech（文本转语音）。

终极技巧：用 AI 配置 AI

这是我的秘密招数：将 Claude Code 的文档发送给它，然后命令它为你配置 Hooks。

例如：

“阅读这份文档：https://docs.anthropic.com/en/docs/claude-code/hooks-guide，然后为我写 3 个钩子：

自动格式化 Python 代码

自动提交 Git 分支

安全验证： 在执行前拦截危险指令”

📌 关键收获

对 Grace 的启示

**标准化独立站维护工作流**：你可以为你的独立站开发任务创建专属 Commands。比如 `/seo-check` 自动检查页面的 Meta 标签，或者 `/speed-test` 自动运行性能测试并提出优化建议。

**利用 Hooks 实现异步工作**：作为创业者，你不需要盯着终端看 AI 写代码。配置一个 Telegram Hook，当 AI 完成复杂的代码重构或内容生成后，直接在手机上接收“任务完成”的通知。

**降低配置门槛**：直接把 Claude Code 的官方文档链接丢给它，让它帮你写自定义的 Commands 和 Hooks，这是最高效的学习和配置方式。

Commands 是发送预制 Prompt 模板的快捷方式，而 Hooks 则是你为 AI 设定的自动化规则。

👉

想了解更多细节？ 查看原文 →