irm https://claude.ai/install.ps1 | iex

{
  "hasCompletedOnboarding": true
}

claude --continue
# 或者
claude --resume


# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any，使用 unknown 替代
```

### 文件位置与层级

项目的核心文件结构如下： 
```
your-project/
├── CLAUDE.md                  # 项目主记忆文件（团队共享）
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置（建议加入 .gitignore）
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置
```


# 项目约定

## 技术栈
- 前端：Next.js 15、TypeScript 5.7、Tailwind CSS 4
- 后端：Node.js 22、Prisma 6
- 测试：Vitest 3.2

## 代码规范
- 始终使用函数式 React 组件
- 文件名使用 kebab-case
- 测试文件与源码放在同一目录

## 常用命令
- 构建：`pnpm build`
- 测试：`pnpm test`
- 启动开发服务器：`pnpm dev`

## API 约定
- 所有 API 路由以 `/api/v1/` 开头
- 错误响应格式：`{ error: string, code: number }`


# 我的本地覆盖

本地数据库地址：localhost:5433（非默认端口）

调试时请优先输出详细日志。

## 临时规则（本次任务用）
目前专注于重构 auth/ 模块，其他模块暂时不要改动。


{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(pytest:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl * | bash)"
    ]
  }
}


{
  "permissions": {
    "allow": [
      "Bash(rm ./tmp/*)"
    ]
  }
}


# Code Review

请对当前修改执行完整的代码审查：

1. 检查是否有安全漏洞（SQL 注入、XSS 等）
2. 验证错误处理是否完整
3. 确认测试覆盖率是否达标
4. 检查是否符合代码风格规范
5. 评估性能影响

用中文输出结构化审查报告，按严重程度排列问题。


# Code Style Rules

- TypeScript 严格模式，禁用 any 类型
- 函数长度不超过 40 行，超出则拆分
- 优先使用 const，避免使用 let
- 导入顺序：标准库 → 三方包 → 本地模块
- 所有 export 的函数/类型需要 JSDoc 注释
- 禁止使用 console.log，使用项目 logger


# Security Review Skill

## 触发条件
当用户请求代码审查、代码涉及认证/授权/加密/用户输入处理时自动触发。

## 执行步骤
1. 扫描 SQL 注入风险（检查所有数据库查询）
2. 检查 XSS 防护（验证输出转义）
3. 审计权限边界（确认最小权限原则）
4. 检查敏感数据处理（日志、错误信息中是否泄露）
5. 输出 OWASP Top 10 对照检查表

## 输出格式
按 CVSS 评分排列，高危问题优先展示。


---
name: code-reviewer
description: 资深代码审查员，专注代码质量与可维护性
---

# 代码审查员

## 角色定位
你是一名拥有 10 年经验的资深工程师，专注于代码可读性、性能优化和最佳实践。

## 审查重点
- 命名是否清晰表达意图
- 函数/类的单一职责原则
- 边界条件和错误处理
- 性能瓶颈（N+1 查询、不必要的循环等）

## 权限
只读访问，不直接修改文件。

## 输出格式
使用 Markdown 表格输出，包含：问题位置、严重程度、建议方案。

# 基础语法
claude mcp add --transport http <服务器名称> <服务器URL>

# 示例1：连接Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 示例2：带身份验证的HTTP服务器
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer 你的令牌"

# 列出所有已配置的服务器
claude mcp list

# 查看指定服务器详情（如github）
claude mcp get github

# 删除指定服务器
claude mcp remove github

# 在Claude Code中检查服务器状态
/mcp

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

/agents


---
name: code-reviewer
description: Reviews code for quality, best practices, and security issues.
             Invoke when the user asks to review, audit, or check code quality.
tools: Read, Grep, Glob
model: sonnet
permissionMode: default
memory: project
---

You are a senior code reviewer.
Analyze code and provide actionable feedback organized by severity: Critical / Major / Minor.

Update your agent memory with recurring patterns, conventions, and known issues you discover.


{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

/plugin                # 打开插件管理器
/plugin install         # 安装插件
/plugin uninstall       # 卸载
/plugin enable/disable  # 启用 / 禁用
/plugin marketplace add # 添加市场
/plugin marketplace rm  # 移除市场

命令	功能	示例
`claude`	启动交互模式	`claude`
`claude "task"`	执行一次性任务	`claude "fix the build error"`
`claude -p "query"`	执行一次查询后退出	`claude -p "explain this function"`
`claude -c`	在当前目录继续最近的对话	`claude -c`
`claude -r`	恢复之前的对话	`claude -r`
`claude commit`	创建 Git 提交	`claude commit`

命令	功能	示例
`/clear`	清除对话历史	`> /clear`
`/help`	显示可用命令	`> /help`
`/login`	登录或切换账号	`> /login`
`/resume`	恢复之前的对话	`> /resume`
`exit` 或 `Ctrl+C`	退出 Claude Code	`> exit`
`/init`	在项目根目录生成 CLAUDE.md 文件，用于定义项目级指令和上下文	`/init`
`/status`	查看当前模型、API Key、Base URL 等配置状态	`/status`
`/model <模型名称>`	切换模型	`/model qwen3-coder-next`
`/plan`	进入规划模式，仅分析和讨论方案，不修改代码	`/plan`
`/compact`	压缩对话历史，释放上下文窗口空间	`/compact`
`/config`	打开配置菜单，可设置语言、主题等	`/config`
`/cost`	查看当前会话消耗	-
`/reset`	重置会话	-
`/docs`	让 Claude 参考指定文档	-
`/review`	检查 Git 暂存区改动	-

符号	类型	本质作用
`/`	Command（命令）	执行内置操作
`@`	Context（上下文）	引用文件/代码/目录
`!`	Bash 模式	直接执行终端命令，stdout/stderr 自动注入上下文
`#`	Memory（记忆注入）	把内容持久写入 CLAUDE.md 项目记忆，跨会话长期生效，例如：#config.yaml
`&`	Async（异步任务）	后台/云端异步执行任务，不阻塞当前会话，可关闭终端后在 claude.ai/code 查看进度
`+Enter`	Multiline（多行输入）	换行不发送，写多行内容，长需求描述一次性写完
无前缀	自然语言	普通任务指令

命令	作用
`/help`	查看全部能力
`/clear`	清空对话
`/plan`	进入规划模式
`/model`	切换模型
`/context`	查看上下文使用情况
`/export`	导出对话
`/status`	环境状态
`/tasks`	管理后台任务
`/theme`	主题切换
`/memory`	编辑 CLAUDE.md

命令	作用
`claude mcp add`	添加一个 MCP 服务器
`claude mcp list`	查看所有已配置服务器
`claude mcp get <name>`	查看某个服务器详情
`claude mcp remove <name>`	删除服务器
`/mcp`	在 Claude Code 中查看状态 / 认证

范围	用途	配置命令示例
local（默认）	仅当前项目可用，私密配置（如敏感密钥）	`claude mcp add --scope local ...`
project	团队共享（存储在.mcp.json，可提交版本库）	`claude mcp add --scope project ...`
user	所有项目可用（个人全局配置）	`claude mcp add --scope user ...`

位置	范围	优先级
CLI --agents 标志	当前会话（临时测试 / 自动化脚本，不保留到磁盘）	最高
.claude/agents/	当前项目	高
~/.claude/agents/	所有项目(用户级)	中
插件 agents	插件作用域	最低

字段	类型	说明
name	string（必填）	唯一标识，也是显式调用时的名称
description	string（必填）	决定 Claude 何时自动调用此代理，务必写清楚使用场景
tools	string	工具白名单；设置后只能使用列出的工具，MCP 工具也会被排除
disallowedTools	string	工具黑名单；继承主对话全部工具，但排除列出的工具（含 MCP）
model	string	haiku / sonnet / opus / 完整模型 ID / inherit（默认，继承主对话）
permissionMode	enum	权限行为控制（见权限模式章节）
memory	enum	持久记忆范围：user / project / local（见记忆章节）
background	bool	为 true 时始终以后台方式运行
isolation	string	设为 worktree 时在临时 git worktree 中运行，完全隔离主仓库
skills	list	声明在此代理启动时自动加载的 Skills 列表
hooks	object	生命周期钩子（SubagentStart / SubagentStop / PreToolUse / PostToolUse）

方式对比	命令形式	适合场景
独立配置（.claude/）	/hello	个人使用、单项目、快速实验
插件（.claude-plugin/）	/plugin-name:hello	团队共享、跨项目、版本化

字段	作用
name	唯一标识 + 命令命名空间
description	插件市场中展示
version	语义化版本控制
author	可选，归属说明

原来	迁移后
.claude/commands	plugin/commands
.claude/agents	plugin/agents
settings.json hooks	plugin/hooks/hooks.json

简介¶

安装¶

其他登录¶

使用claude¶

常用命令速查表¶

命令行命令¶

交互模式内命令¶

模型¶

恢复或分叉会话¶

上下文窗口¶

安全机制¶

API 管理¶

Claude Code for VS Code¶

提示框¶

项目结构¶

/init 项目初始化¶

CLAUDE.md¶

CLAUDE.local.md¶

settings.json¶

settings.local.json¶

.claude/commands/ 自定义斜杠命令¶

.claude/rules/ 模块化行为规则¶

.claude/skills/ 自动调用的工作流¶

.claude/agents/ 子代理角色¶

交互模式¶

操作说明¶

常见命令¶

MCP¶

安装 MCP 服务器¶

管理 MCP 服务器¶

配置范围¶

示例¶

在对话中使用 MCP¶

注意¶

子代理¶

内置的子代理¶

创建子代理¶

子代理的作用范围¶

文件结构¶

使用子代理¶

使用示例¶

子代理上下文与恢复¶

什么时候该用子代理？¶

插件¶

结构¶

插件清单（plugin.json）¶

斜杠命令（commands/）¶

本地测试插件¶

插件市场¶

插件命令¶

从 .claude/ 迁移到插件¶

什么时候用插件？¶