内容
# 我的克劳德代码设置
克劳德代码的扩展功能（代理、技能、命令、钩子、规则、MCP设置）的综合仓库。
## 特点
- **17+ 专用代理**: architect, code-reviewer, security-reviewer, typescript-expert 等
- **16+ 斜杠命令**: `/tdd`, `/plan`, `/code-review`, `/think-harder` 等
- **安全钩子**: 机密文件阻止、危险命令防止
- **质量钩子**: 自动格式化、TypeScript检查、console.log检测
- **20+ MCP 服务器设置**: GitHub, Slack, Database 等
- **框架特定技能**: React, Next.js, TypeScript, AWS 等
## 上下文窗口效率
本仓库采用渐进式披露设计:
- **SKILL.md**: 简洁的元数据和概要（100-500行）
- **references/**: 详细的参考资料（仅在需要时加载）
- **检查清单**: 另存为单独文件
这样可以避免上下文窗口的压力，只需高效地使用必要的信息。
## 目录结构
```
everything-claude-code/
├── .claude-plugin/ # 插件设置文件
│ ├── plugin.json # 插件清单
│ ├── marketplace.json # 市场定义
│ └── install.sh # 安装脚本
├── agents/ # 专用代理定义
│ ├── architect.md # 架构设计
│ ├── code-reviewer.md # 代码审查
│ ├── security-reviewer.md
│ ├── typescript-expert.md
│ └── ...
├── commands/ # 斜杠命令
│ ├── tdd.md # /tdd - 测试驱动开发
│ ├── plan.md # /plan - 设计和计划
│ ├── code-review.md # /code-review
│ ├── think-harder.md # /think-harder - 深入思考
│ └── ...
├── skills/ # 技能定义（渐进式披露设计）
│ ├── architecture/ # 应用架构（DDD, Clean Architecture等）
│ ├── frameworks/ # 框架特定（React, Next.js等）
│ ├── languages/ # 语言特定（TypeScript等）
│ ├── operations/ # 运维（CI/CD, 监控, SRE）
│ ├── tools/ # 工具特定
│ └── workflows/ # 工作流程
│ ├── terraform/ # IaC（模块, 状态管理, CI/CD集成）
│ ├── monorepo/ # 单仓库设计（Turborepo, pnpm workspace）
│ ├── security-review/ # 安全审查（OWASP, 工具）
│ └── tdd-workflow/ # TDD
├── rules/ # 规则定义
│ ├── coding-style.md # 编码风格
│ ├── security.md # 安全
│ ├── testing.md # 测试
│ └── ...
├── hooks/ # 钩子设置
│ ├── hooks.json # 钩子定义
│ ├── observability.json # 监控设置
│ └── scripts/ # 钩子脚本
│ ├── obsidian-export.py # Obsidian集成
│ └── slack-notify.sh # Slack通知
├── mcp-configs/ # MCP 服务器设置
│ └── mcp-servers.json
└── examples/ # 示例
├── CLAUDE.md # 项目CLAUDE.md
└── user-CLAUDE.md # 用户CLAUDE.md
```
---
## 安装方法
### 作为插件安装（推荐）
使用克劳德代码的插件系统进行安装。
```bash
# 添加市场
/plugin marketplace add tubone24/claude-code-settings
# 安装插件
/plugin install claude-code-settings@tubone24/claude-code-settings
```
---
## Slack通知集成
当克劳德代码等待用户的批准时（工具执行许可请求），通过Slack incoming webhook接收通知的功能。
### 功能
- **等待批准时Slack通知**: `Notification` 钩子调用Slack incoming webhook
- **Block Kit支持**: 消息、工作目录、主机名、时间戳以丰富的方式显示
- **安全的故障转移**: 环境变量未设置时跳过通知（不会出错）
### 设置
#### 1. 获取Slack Incoming Webhook URL
按照[Slack Incoming Webhooks](https://api.slack.com/messaging/webhooks)指南创建Webhook URL。
#### 2. 设置环境变量
```bash
# 添加到 ~/.zshrc 或 ~/.bashrc
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/TXXXXX/BXXXXX/XXXXXXXXXX"
```
使设置生效:
```bash
source ~/.zshrc # 或 source ~/.bashrc
```
> **安全注意事项**:
> - **绝不能将Webhook URL提交到Git仓库**
> - shell配置文件（`~/.zshrc`, `~/.bashrc`）位于主目录下，通常不受Git管理
> - 如果需要更严格的管理，可以在`~/.claude/.env`中写入并从shell配置中读取:
>
> ```bash
> # ~/.claude/.env（不受Git管理）
> SLACK_WEBHOOK_URL=https://hooks.slack.com/services/TXXXXX/BXXXXX/XXXXXXXXXX
> ```
>
> ```bash
> # 添加到 ~/.zshrc
> [ -f ~/.claude/.env ] && export $(grep -v '^#' ~/.claude/.env | xargs)
> ```
#### 3. 验证
重启克劳德代码并执行需要批准的操作（例如文件编辑）。Slack将收到通知。
### 禁用通知
只需删除或注释掉环境变量即可禁用:
```bash
# 从 ~/.zshrc 中删除或注释掉相关行
# export SLACK_WEBHOOK_URL="..."
```
---
## Obsidian集成
将克劳德代码会话内容自动导出到Obsidian的功能。
### 功能
- **会话结束时自动导出**: `SessionEnd` 钩子解析转录
- **结构化Markdown**: 提示、编辑文件、运行命令已组织
- **YAML前置**: 支持Obsidian属性/标签
- **折叠支持**: 长提示自动折叠为 `<details>`
### 设置
1. **设置环境变量**（可选 - 如果使用默认路径则不需要）:
```bash
# 添加到 ~/.bashrc 或 ~/.zshrc
export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian Vault"
```
自动检测默认路径:
- `~/Documents/Obsidian Vault`
- `~/Documents/Obsidian`
- `~/Obsidian`
2. 安装插件后，钩子将自动启用
### 输出示例
```markdown
---
date: 2026-01-28
time: 15:30:45
session_id: abc123
project: my-project
tags:
- claude-code
- session
---
# 克劳德代码会话 - 2026-01-28 15:30:45
## 用户提示
### 提示 1
\`\`\`
用户提示内容...
\`\`\`
## 编辑文件
- `src/index.ts`
- `package.json`
## 运行命令
\`\`\`bash
npm install
npm test
\`\`\`
## 工具使用总结
| 工具 | 次数 |
|------|-------|
| 编辑 | 5 |
| Bash | 3 |
| 读取 | 2 |
```
### 保存位置
`$OBSIDIAN_VAULT_PATH/Claude-Sessions/claude-session-YYYY-MM-DD-HHMMSS-{session_id}.md`
---
## 许可证
MIT License
