Claude Code Skills 与 Hooks 使用指南

Skills 和 Hooks 是 Claude Code 最核心的两个扩展机制。用了一段时间后，把理解和配置总结一下。

Skills 的理解

Skills 是什么？

Skill 是 Claude Code 的专业化指令集。每个 skill 定义了一套工作流程——不是告诉 Claude “做什么”，而是告诉 Claude “怎么做”。比如 TDD skill 定义了 “先写测试→看到失败→写最少代码→看到通过→重构” 的循环，而不是简单说 “写测试”。

Skill 的两种类型：

我的 Skills 清单：

Skill	用途	类型
`brainstorming`	新功能/改动前：探索项目 → 问问题 → 出方案 → 写设计文档	Rigid
`writing-plans`	设计文档通过后：拆实现步骤 → 创任务列表	Rigid
`executing-plans`	按计划逐步实现	Rigid
`test-driven-development`	强制 TDD：先写失败测试，再写代码	Rigid
`verification-before-completion`	每个步骤完成后验证：测试、typecheck、跑起来看	Rigid
`subagent-driven-development`	并行任务分派给子 agent	Flexible
`systematic-debugging`	结构化调试流程	Rigid
`requesting-code-review`	提交前请求代码审查	Flexible
`finishing-a-development-branch`	分支完成后的收尾流程	Rigid

Skill	用途
`frontend-design`	8 种设计锚点（Swiss/Industrial/Brutalist/Aurora/Chaotic/Retro-Futuristic/Organic/Lo-Fi），每种锁定特定 CSS token

Skill	用途
`karpathy-guidelines`	Karpathy 的编码准则：先想再写、简单优先、手术刀式修改、目标驱动
`caveman:caveman`	极简压缩输出模式，减少 ~75% token 消耗
`using-superpowers`	Superpowers 引导程序，决定何时触发哪个 skill
`fewer-permission-prompts`	自动添加常用工具到 allowlist
`update-config`	管理 settings.json 配置

Hooks 是什么？

Hooks 是 Claude Code 的自动化触发器系统。在特定生命周期事件发生时，自动执行脚本。不同于 skills（由模型主动调用），hooks 是系统强制执行——模型无法跳过。

Hook 的生命周期事件：

Hook 能做：

Hooks vs Skills 的本质区别：

1
2
3

当会话启动时，检测当前目录：
→ 没有 .codegraph/ + 是项目目录（有 .git/package.json/go.mod 等）
→ 自动运行 codegraph init + codegraph index

1
2
3

每次用户消息前注入（当前 2 条）：
1. CodeGraph first: use codegraph_* tools, not grep
2. Git branch before any code change