规则	作用	触发场景
`claude-code-defensive.md`	防止测试篡改、过度工程化、中途放弃	始终生效
`ops-safety.md`	危险命令确认、回滚方案、风险提示	执行系统命令时
`doc-sync.md`	配置/结构变更时提醒更新文档	修改配置时
`bash-style.md`	Bash 编写规范：tee 写入、heredoc 引号	操作 .sh/.md/Dockerfile 等
`lsp-usage.md`	LSP 自动调用规则、调用声明格式	查找定义/引用时

效果示例：

Claude 不会修改测试来适配错误代码
执行 sysctl 等危险命令前会提示风险和回滚方案
新增命令后会提醒你更新 README

1.2 低费力（自动触发）- Skills

你需要做什么：正常写代码

操作相关文件时自动加载对应的开发规范：

技能	触发条件	提供的帮助
`go-dev`	操作 `.go` 文件	命名约定、错误处理、并发编程、测试规范
`java-dev`	操作 `.java` 文件	命名约定、异常处理、Spring 规范、日志规范
`frontend-dev`	操作 `.vue/.tsx/.css` 等	UI 风格约束、Vue/React 规范、TypeScript
`python-dev`	操作 `.py` 文件	类型注解、Pydantic、pytest、uv 工具链

效果示例：

写 Go 代码时，自动遵循 Effective Go 规范
写 Vue 组件时，自动使用 Composition API + TypeScript
不操作这些文件时，不消耗额外 token

1.3 中费力（显式调用）- Commands

你需要做什么：输入 /命令名

高频命令（日常使用）

命令	用途	使用示例
`/fix`	快速修复 Bug	`/fix 登录接口返回 500`
`/quick-review`	快速审查（git diff + 简要意见）	`/quick-review`
`/code-review`	正式代码审查	`/code-review`
`/debug`	复杂问题排查（复现→假设→验证→修复）	`/debug 定时任务不执行`

中频命令（按需使用）

命令	用途	使用示例
`/security-review`	安全审查当前分支代码	`/security-review`
`/new-feature`	新功能全流程（需求→设计→实现）	`/new-feature 用户导出功能`
`/design-doc`	生成技术设计文档框架	`/design-doc 用户权限模块`
`/requirement-doc`	生成需求文档框架	`/requirement-doc 报表功能`

低频命令（特定场景）

命令	用途	使用示例
`/requirement-interrogate`	需求极刑审问，挖掘逻辑漏洞	`/requirement-interrogate 用户要导出数据`
`/design-checklist`	生成设计质量检查清单	`/design-checklist`
`/project-init`	为新项目初始化 Claude Code 配置	`/project-init`
`/project-scan`	扫描项目生成配置（CLAUDE.md/restart.sh/ignore/Docker）	`/project-scan`
`/style-extract`	从代码或设计图提取样式变量	`/style-extract`
`/status`	显示当前配置状态（Rules/Skills/LSP）	`/status`

2. 常见场景速查

场景	推荐方式	费力度
日常写代码	直接写，Rules + Skills 自动生效	⭐
修个小 Bug	`/fix 问题描述`	⭐⭐
提交前快速看看	`/quick-review`	⭐⭐
正式代码审查	`/code-review`	⭐⭐
复杂 Bug 排查	`/debug 问题描述`	⭐⭐⭐
安全审查	`/security-review`	⭐⭐⭐
开发新功能	`/new-feature 功能名`	⭐⭐⭐
新项目初始化	`/project-init`	⭐⭐⭐

遇到 Bug？
├─ 简单 Bug → /fix 问题描述
└─ 复杂 Bug → /debug 问题描述

代码审查？
├─ 快速看看 → /quick-review
├─ 正式审查 → /code-review
└─ 安全审查 → /security-review

新功能？
├─ 完整流程 → /new-feature 功能名
└─ 只要设计 → /design-doc 模块名

3. 最佳实践

3.1 让自动化为你工作

不要干预 Rules：它们在后台保护你，比如防止 Claude 修改测试
不要手动加载 Skills：操作相关文件时自动生效
相信防御机制：复杂任务会自动要求确认计划后再执行

3.2 避免的做法

❌ 不要绕过 Rules 的保护机制
❌ 不要在简单任务上使用复杂命令
❌ 不要忽略文档同步提醒

4. 常见问题

Q: 为什么 Claude 总是先说明计划再执行？

A: 这是 claude-code-defensive.md 规则的要求。复杂任务（超过 3 个步骤或涉及多个文件）必须先说明计划，等你确认后再执行。这是为了防止 Claude 盲目修改代码。

Q: 为什么执行系统命令时 Claude 会问很多问题？

A: 这是 ops-safety.md 规则的要求。危险命令（如 sysctl、iptables）必须说明影响范围、风险等级和回滚方案。这是为了防止误操作导致系统故障。

Q: 为什么 Claude 提醒我更新文档？

A: 这是 doc-sync.md 规则的要求。当你修改了配置（commands/skills/rules）或项目结构时，会提醒你同步更新相关文档，保持文档与代码一致。

Q: 如何添加新的语言支持？

A: 在 .claude/skills/ 下创建新目录（如 rust-dev/），添加 SKILL.md 文件定义触发条件和规范内容，然后更新本文档。

5. 目录结构

.claude/
├── CLAUDE.md                     # 核心配置：身份、偏好、技术栈
├── rules/                        # 规则：始终加载
│   ├── claude-code-defensive.md  # 防御性规则
│   ├── ops-safety.md             # 运维安全
│   ├── doc-sync.md               # 文档同步
│   ├── bash-style.md             # Bash 编写规范
│   └── lsp-usage.md              # LSP 使用规则
├── skills/                       # 技能：按需加载
│   ├── go-dev/
│   ├── java-dev/
│   ├── frontend-dev/
│   └── python-dev/
└── commands/                     # 命令：显式调用
    ├── fix.md
    ├── code-review.md
    ├── debug.md
    ├── status.md
    └── ...

核心概念

类型	加载时机	触发方式	适用场景
Rules	始终加载	自动生效	核心约束、防御规则
Skills	按需加载	根据文件类型自动触发	语言规范、领域知识
Commands	调用时加载	用户输入 `/命令名`	明确的工作流任务

设计理念

按需加载：语言规范用 Skills，只在操作相关文件时加载，节省 tokens
规则溯源：每次回复声明依据的规则/技能，便于追踪和调整
简洁优先：CLAUDE.md 只放身份/偏好，具体约束放 rules

6. 开发指南

LSP 服务器配置（v2.0.67+ 支持）

前提：需安装 @anthropic-ai/claude-code@2.0.67 或更高版本。

安装命令

# Go
go install golang.org/x/tools/gopls@latest

# TypeScript/JavaScript + Vue
npm install -g typescript typescript-language-server @vue/language-server

# Python
npm install -g pyright

# Java (macOS)
brew install jdtls

LSP 使用策略

LSP 的核心优势是"精准打击"——查找定义时只返回相关代码，而非整个文件，可节省大量 Token。

场景	建议	原因
查找定义/引用	优先用 LSP	精准定位，节省 ~99% Token
理解模块整体逻辑	读取完整文件	避免"管中窥豹"，获取完整上下文
大型项目导航	LSP + 选择性读文件	混合策略最优

注意事项

环境就绪：使用前确保依赖已安装（npm install / go mod download）
避免过度依赖：复杂逻辑需要读取完整文件上下文
LSP 失败时：退回到读取文件的方式

修改现有配置

在 .claude/ 下修改对应文件
在本项目目录启动 Claude Code 测试
验证功能符合预期
复制到 ~/.claude/ 正式使用

新增命令（Command）

创建 .claude/commands/<name>.md
编写 frontmatter（description）和内容
测试 /<name> 命令
更新本文档的命令列表

命令模板：

---
description: 命令的简要描述
---

命令的详细说明和执行逻辑。

## 输入

「$ARGUMENTS」— 用户输入的参数

## 流程

### 第 1 步：...
### 第 2 步：...

## 输出格式

...

新增技能（Skill）

创建 .claude/skills/<name>/SKILL.md
编写 frontmatter（name、description）和内容
可选：添加 references/ 目录存放详细参考
测试触发是否正确
更新本文档的技能列表

技能模板：

---
name: skill-name
description: 当用户操作 xxx 文件时触发。提供 xxx 开发规范。
---

# 技能名称

## 核心规范

...

## 详细参考

详细内容见 `references/` 目录。

测试验证

# 在本项目目录启动 Claude Code
cd /path/to/cc-use-exp
claude

# 测试命令
> /fix 测试问题

# 测试技能（操作相关文件类型）
> 帮我看看这个 Go 代码有什么问题

# 检查配置加载
> /memory

7. 部署方法

工作原理

本项目 .claude/  ──开发/优化──>  确认无误  ──复制──>  ~/.claude/

在本项目 .claude/ 目录下开发和优化配置
开发时独立运行，不依赖 ~/.claude/ 中的任何文件
确认无误后，将 .claude/ 整体复制到 ~/.claude/ 生效

首次部署

# 1. 备份现有配置（推荐）
cp -r ~/.claude ~/.claude.backup.$(date +%Y%m%d)

# 2. 复制新配置
cp -r .claude/* ~/.claude/

# 3. 验证部署
# 启动 Claude Code，执行 /memory 确认配置加载正确

更新部署

# 直接覆盖
cp -r .claude/* ~/.claude/

8. 版本记录

9. 参考资料

Claude Code 官方文档

README.md Unescape Escape

Claude Code 用户级配置

1. 快速开始

1.1 零费力（自动生效）- Rules