Claude Code Skills 进阶：动态上下文注入、路径限定激活和 Subagent 集成深度指南

---
name: pr-context
description: 加载当前 PR 的上下文，帮助 Claude 理解工作背景
---

## Pull Request 信息

- PR 差异：!`gh pr diff --stat`
- 最新评论：!`gh pr view --comments | head -50`
- CI 状态：!`gh pr checks`
- 分支信息：!`git log main..HEAD --oneline`

---
name: env-check
description: 检查开发环境配置状态
---

## 当前环境

```!
echo "=== Node.js ==="
node --version
echo "=== npm 版本 ==="
npm --version
echo "=== 环境变量 ==="
echo "DATABASE_URL: ${DATABASE_URL:+已设置}"
echo "API_KEY: ${API_KEY:+已设置}"
echo "=== 数据库连接 ==="
node -e "require('./src/db').ping().then(() => console.log('✅')).catch(e => console.log('❌', e.message))" 2>/dev/null || echo "无法测试"

---
name: health-check
description: 全面的代码库健康检查，包含测试/覆盖率/技术债/依赖状态
disable-model-invocation: true
allowed-tools: Bash(npm *) Bash(git *)
effort: high
---

## 代码库健康状况报告

### 测试
```!
npm test -- --reporter=min 2>&1 | tail -10

---
name: ts-strict
description: TypeScript 严格类型的编码规范，在编辑 TS 文件时自动激活
paths: "**/*.ts,**/*.tsx"
user-invocable: false
---

编写 TypeScript 代码时，严格遵守以下规范：

**类型安全**
- 禁止使用 `any`，改用 `unknown` 配合类型守卫
- 禁止无目的的类型断言（`as SomeType`），必须有注释说明
- 所有公共 API 函数必须有显式返回类型注解
- 优先使用联合类型（`A | B`）而非 `Optional<A>`（TypeScript 5+）

**Null 安全**
- 开启 `strictNullChecks`（已在 tsconfig 里配置）
- 可选链（`?.`）和空值合并（`??`）优于显式 null 检查

**错误处理**
- `try/catch` 的 catch 参数用 `unknown`，不用 `any`
- 类型收窄：`if (error instanceof Error) { ... }`

---
name: sql-safety
description: SQL 文件的安全约束，防止注入
paths: "**/*.sql,src/**/*query*.ts,src/**/*repository*.ts"
user-invocable: false
---

处理数据库查询时：

**强制要求**
- 所有参数化查询，禁止字符串拼接
- 使用 `$1, $2` 占位符（PostgreSQL）或 `?` 占位符（MySQL）
- 用户输入必须通过参数传递，不能直接插入 SQL 字符串

**禁止模式**
```typescript
// ❌ 禁止
const query = `SELECT * FROM users WHERE id = ${userId}`;

// ✅ 正确
const query = 'SELECT * FROM users WHERE id = $1';
const result = await db.query(query, [userId]);

context: fork
agent: Explore       # 只读工具，Haiku 模型，适合代码探索
agent: Plan          # 只读工具，适合规划阶段研究
agent: general-purpose  # 全部工具（默认）
agent: my-custom-agent  # 任何 .claude/agents/ 里的自定义 agent

---
name: dep-analysis
description: 深入分析项目依赖关系和潜在问题，在独立上下文里运行
context: fork
agent: Explore
---

对当前项目进行依赖分析：

1. 读取 package.json（或 requirements.txt/go.mod）
2. 识别以下问题：
   - 重复功能的依赖（两个做同一件事的库）
   - 主版本升级可用的过时依赖
   - 已知有安全问题的依赖
   - 只在开发中使用但放在 dependencies 里的包

3. 分析依赖图的深度（间接依赖数量）

4. 输出报告：
   - 关键发现（Top 5）
   - 建议移除的依赖
   - 建议升级的依赖（优先级排序）
   - 估计的 bundle size 影响

---
name: arch-research
description: 深入调研代码库架构，用于理解大型系统的结构
context: fork
agent: Explore
---

对 $ARGUMENTS 进行深入架构调研：

## 调研范围

1. **入口点识别**：找到所有主要入口点（main.ts、index.ts、app.ts 等）
2. **模块边界**：识别主要的功能模块和它们的边界
3. **数据流**：追踪数据从输入到存储的完整路径
4. **依赖关系**：模块间的依赖图（哪些模块依赖哪些模块）
5. **关键决策点**：找到代码里体现重要架构决策的地方

## 输出格式

用 Mermaid 图表展示模块关系：

```mermaid
graph TD
  ...