# 项目：Acme API


## 命令

npm run dev          # 启动开发服务器

npm run test         # 运行测试（Jest）

npm run lint         # ESLint + Prettier 检查

npm run build        # 生产构建


## 架构

- Express REST API，Node 20
- 通过 Prisma ORM 使用 PostgreSQL
- 所有处理器位于 src/handlers/
- 共享类型位于 src/types/

## 约定

- 在每个处理器中使用 zod 进行请求验证
- 返回格式始终为 { data, error }
- 永远不要向客户端暴露堆栈跟踪
- 使用日志记录器模块，而不是 console.log

## 注意事项

- 测试使用真实的本地数据库，而非模拟数据。首先运行 `npm run db:test:reset`
- 严格的 TypeScript：永远不要有未使用的导入

.claude/rules/
├── code-style.md
├── testing.md
├── api-conventions.md
└── security.md

---
paths:
  - "src/api/**/*.ts"
  - "src/handlers/**/*.ts"
---

# API 设计规则


- 所有处理器返回 { data, error } 格式
- 使用 zod 进行请求体验证
- 永远不要向客户端暴露内部错误详情

## description: 在合并前审查当前分支的差异以发现问题

## 待审查的更改


!`git diff --name-only main...HEAD`

## 详细差异


!`git diff main...HEAD`

审查上述更改，关注：
1. 代码质量问题
2. 安全漏洞
3. 缺失的测试覆盖
4. 性能问题

按文件给出具体、可操作的反馈。

---
description: 调查并修复一个 GitHub issue
argument-hint: [issue-number]
---
查看此仓库中的 issue #$ARGUMENTS。

!`gh issue view $ARGUMENTS`

理解这个 bug，追踪其根本原因，修复它，并编写一个能捕获它的测试。

.claude/skills/
├── security-review/
│   ├── SKILL.md
│   └── DETAILED_GUIDE.md
└── deploy/
    ├── SKILL.md
    └── templates/
        └── release-notes.md

---
name: security-review
description: 全面的安全审计。在审查代码漏洞、部署前或用户提及安全时使用。
allowed-tools: Read, Grep, Glob
---
分析代码库中的安全漏洞：

1. SQL 注入和 XSS 风险
2. 暴露的凭据或密钥
3. 不安全的配置
4. 认证和授权漏洞

报告发现的问题，附带严重性评级和具体的修复步骤。
参考 @DETAILED_GUIDE.md 了解我们的安全标准。

.claude/agents/
├── code-reviewer.md
└── security-auditor.md

---
name: code-reviewer
description: 专家代码审查员。在审查 PR、检查 bug 或在合并前验证实现时主动使用。
model: sonnet
tools: Read, Grep, Glob
---
您是一位专注于正确性和可维护性的高级代码审查员。

审查代码时：
- 标记 bug，而不仅仅是风格问题
- 建议具体的修复，而不是模糊的改进
- 检查边界情况和错误处理漏洞
- 仅在规模重要时才注意性能问题

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Read",
      "Write",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

your-project/
├── CLAUDE.md                  # 团队指令（已提交）

├── CLAUDE.local.md            # 您的个人覆盖（被 git 忽略）

│
└── .claude/
    ├── settings.json          # 权限 + 配置（已提交）

    ├── settings.local.json    # 个人权限覆盖（被 git 忽略）

    │
    ├── commands/              # 自定义斜杠命令

    │   ├── review.md          # → /project:review

    │   ├── fix-issue.md       # → /project:fix-issue

    │   └── deploy.md          # → /project:deploy

    │
    ├── rules/                 # 模块化指令文件

    │   ├── code-style.md
    │   ├── testing.md
    │   └── api-conventions.md
    │
    ├── skills/                # 自动调用的工作流

    │   ├── security-review/
    │   │   └── SKILL.md
    │   └── deploy/
    │       └── SKILL.md
    │
    └── agents/                # 专门的子代理角色

        ├── code-reviewer.md
        └── security-auditor.md

~/.claude/
├── CLAUDE.md                  # 您的全局指令

├── settings.json              # 您的全局设置

├── commands/                  # 您的个人命令（所有项目）

├── skills/                    # 您的个人技能（所有项目）

├── agents/                    # 您的个人代理（所有项目）

└── projects/                  # 会话历史 + 自动记忆