Claude Code Skills 进阶指南：四大内置技能、动态上下文注入、Subagent 运行与参数传递

---
name: explain-code
description: Explains code with visual diagrams and analogies.
             Use when explaining how code works or user asks
             "how does this work?"
---

When explaining code, always include:

1. **Start with an analogy**: Compare to something from everyday life
2. **Draw a diagram**: Use ASCII art to show flow or structure  
3. **Walk through the code**: Step-by-step explanation
4. **Highlight a gotcha**: Common mistake or misconception

---
name: deploy                           # Skill 名称（创建 /deploy 命令）
description: Deploy to production      # 描述（Claude 自动调用的依据）
disable-model-invocation: true         # 禁止 Claude 自动触发（只能手动 /deploy）
context: fork                          # 在独立 Subagent 中运行
tools:                                  # 限制此 Skill 可用的工具
  allow:
    - Bash
    - Read
  deny:
    - Write
---

---
name: api-conventions
description: API 设计约定，编写 API 端点时使用
---

编写 API 端点时：
- 使用 RESTful 命名约定
- 返回一致的错误格式：{"error": {"code": "...", "message": "..."}}
- 包含请求验证（zod/joi）
- POST 返回 201，DELETE 返回 204

---
name: commit
description: Create a git commit with conventional commit format
disable-model-invocation: true
---

1. Run `git diff --staged` to see what's staged
2. Analyze the changes and determine the commit type
   (feat/fix/docs/style/refactor/test/chore)
3. Write a commit message: `<type>(<scope>): <description>`
4. Run `git commit -m "<message>"`
5. Confirm the commit was created successfully

---
name: db-query
description: Database query helper with current schema
---

# Current Database Schema

$CURRENT_SCHEMA=$(psql $DATABASE_URL -c "\d" 2>/dev/null || echo "Schema unavailable")

---

当写数据库查询时，参考上面的 Schema。使用适当的索引，避免全表扫描。

# 当前 Git 状态
$GIT_STATUS=$(git status --short)

# 环境信息
$NODE_VERSION=$(node --version)
$PYTHON_VERSION=$(python3 --version)

# 最近的测试结果
$LAST_TEST=$(cat .test-cache/last-result.txt 2>/dev/null || echo "No cache")

---
name: research
description: 深度研究某个话题，读取大量文件后返回摘要
context: fork
tools:
  allow:
    - Read
    - Grep
    - Glob
    - WebFetch
---

对指定话题进行深度研究：
1. 搜索整个代码库的相关文件
2. 阅读所有相关文档
3. 搜索网络了解背景
4. 返回一份结构化的研究报告

只返回最终报告，不要显示中间步骤。

---
name: deploy
disable-model-invocation: true
---

Deploy to environment: $ARGUMENTS

1. Validate the target environment
2. Run pre-deployment checks
3. Execute deployment
4. Verify the deployment succeeded