示例：模板 & 速查

# <项目名>
 
## 技术栈
- <语言 / 框架 + 版本 + 关键坑>
 
## 命令
- dev: ...
- build: ...
- test: ...
 
## 约定
- <规则 1，具体可执行>
- <规则 2>
 
## 禁区
- <别动的目录 / 文件>
 
## 踩过的坑
- <教训 1>
- <教训 2>

---
name: <kebab-case-name>
description: <做什么> + <什么时候触发，列中英关键词> + <输入是什么形态>
---
 
# <Skill Name>
 
## When to use
- <场景描述>
- <输入要求>
 
## Steps
1. <第一步，含具体路径>
2. ...
 
## Inputs
- <参数 1>
 
## Output
- <结果形态>
 
## Do NOT
- <边界，防止过度扩展>

---
name: <domain>-best-practices
description: <领域> 最佳实践 - <主题 1>、<主题 2>、<主题 3>...
user-invocable: false  # 被动参考的规则集
---
 
# <Domain> Best Practices
 
Apply these rules when <writing/reviewing> <domain> code.
 
## <Topic 1>
See [topic-1.md](./topic-1.md) for:
- <具体规则 1>
- <具体规则 2>
 
## <Topic 2>
See [topic-2.md](./topic-2.md) for:
- ...

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -q '<PATH_PATTERN>'; then echo 'BLOCKED: <REASON>' >&2; exit 2; fi"
      }]
    }]
  }
}

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -qE '\\.(ts|tsx)\"'; then <COMMAND>; fi"
      }]
    }]
  }
}

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "<CHECK_COMMAND>"
      }]
    }]
  }
}

{
  "hooks": {
    "UserPromptSubmit": [{
      "hooks": [{
        "type": "command",
        "command": "cat <CONTEXT_FILE> 2>/dev/null"
      }]
    }]
  }
}

信息进来
  ↓
下次会话还需要？── 否 → 不用存，会话结束自然丢掉
  ↓ 是
项目特有？── 否 → auto-memory
  ↓ 是
适合入 git？── 否 → auto-memory
  ↓ 是
CLAUDE.md

出现"每次 / 必须 / 一旦"关键词？
  ├─ 否 → 记忆（CLAUDE.md / auto-memory）
  └─ 是 ↓
频繁（每次工具调用级别）？
  ├─ 否 → 可能是 skill
  └─ 是 ↓
执行时间 < 3 秒？
  ├─ 否 → 走 CI，不走 hook
  └─ 是 → Hook

任务来了
  ↓
主对话 1-2 步能搞定？── 是 → 自己干
  ↓ 否
大范围搜索 / 独立视角 / 2+ 独立任务？
  ↓ 是
2+ 独立任务？── 是 → 一条消息并行多 agent
  ↓ 否
能写完 5 要素 brief？── 否 → 先想清楚
  ↓ 是 → 开

改 3+ 文件？       ┐
改 API / 数据结构？ │
改数据库 / 安全？   ├─ 任一为是 → 强制 Plan
不熟悉的库？       │
多种实现路线？     ┘
  ↓ 全否
完全确定改哪一行？── 否 → 还是 Plan
  ↓ 是
可跳过 Plan

改动是一件事吗？── 否 → 先拆 stage
  ↓ 是
message 写了 why？── 否 → 补
  ↓ 是
标题 ≤ 72 字符？── 否 → 精简
  ↓ 是
祈使语气 / 小写开头？── 否 → 改
  ↓ 是 → 提交

[背景]       ← 为什么做这件事
[具体位置]   ← 文件路径 / 函数名 / 行号
[明确任务]   ← 1、2、3 列清楚
[输出形式]   ← 报告？代码？checklist？
[长度限制]   ← "500 字内"

<type>(<scope>): <what changed, imperative, lowercase, no period>

<optional body: why, not what>

<optional footer: BREAKING CHANGE, refs>

## Why
<动机 / 来源>
 
## What changed
<核心改动 1-3 条，不罗列文件>
 
## How to test
<可执行 checklist>