Claude代码配置
便携式工作流的个人Claude代码配置。包括设置、挂钩、技能、命令、代理、MCP服务器和Ralph自主编码循环。
快速设置
git clone https://github.com/DylanLamb888/claude-code-config.git
cd claude-code-config
./setup.sh包含什么
核心配置文件
| 文件 | 目的 |
|---|---|
CLAUDE.md | Claude Code的全球指令(代码质量、计划模式、Ralph) |
settings.json | 权限、挂钩、已启用的插件 |
.mcp.json | MCP服务器配置 |
ralph-instructions.md | Ralph自主循环说明 |
feedback-loops.md | 特定语言的反馈命令 |
husky-setup.md | 赫斯基+皮棉分阶段设置指南 |
钩子(hooks/)
工具前后使用挂钩进行质量门和自动化。
| 钩子 | 触发器 | 目的 |
|---|---|---|
security-check.sh | PreToolUse(Bash) | 使用敏感数据模式进行块提交 |
pre-commit-test.sh | PreToolUse(Bash) | 在git提交之前运行测试 |
typecheck-pre-commit.sh | PreToolUse(Bash) | 在提交之前运行TypeScript检查 |
branch-protection.sh | PreToolUse(Bash) | 防止直接提交到main/master |
format-typescript.sh | PostToolUse(写入/编辑) | 使用Prettier自动格式化TS/JS |
lint-on-write.sh | PostToolUse(写入/编辑) | 对编辑过的文件运行ESLint |
notify-complete.sh | PostToolUse(Bash) | macOS长命令完成通知 |
命令(commands/)
常见工作流的自定义斜线命令。
| 命令 | 描述 |
|---|---|
/prd | Ralph循环的交互式PRD生成 |
/ralph | 为Ralph将markdown PRD转换为JSON |
/preflight | 提交前运行所有验证检查 |
/self-review | 审查常见问题的分阶段变更 |
/verify-build | 运行构建并报告错误 |
/verify-ui | 截图并检查视觉问题 |
/check-console | 读取浏览器控制台以查找错误 |
技能(skills/)
专业知识和指导方针。
| 技能 | 描述 |
|---|---|
agent-browser | 使用代理浏览器CLI实现浏览器自动化 |
react-best-practices | Vercel的40多条React/Next.js性能规则 |
ui-skills | 意见化的UI约束(顺风、动画、组件) |
web-design-guidelines | 根据Web界面指南审查UI代码 |
代理商(agents/)
自定义代理定义。
| 代理 | 描述 |
|---|---|
code-improver | 对代码的可读性、性能和最佳实践进行审查 |
拉尔夫(ralph/)
用于完成PRD的自主AI编码循环。
| 文件 | 描述 |
|---|---|
afk-ralph.sh | 使用Docker沙盒的AFK循环(无人值守) |
ralph-once.sh | HITL单次迭代(观察和干预) |
prompt.md | 每次迭代发送给Claude的指令 |
prd.json.example | JSON PRD格式示例 |
prd.md.example | markdown PRD格式示例 |
README.md | Ralph使用文档 |
设置概述
允许的权限
{
"permissions": {
"allow": [
"WebSearch", "WebFetch",
"Bash(npm run:*)", "Bash(npm test:*)", "Bash(npm install:*)",
"Bash(git add:*)", "Bash(git commit:*)", "Bash(git push:*)",
"Bash(git status:*)", "Bash(git diff:*)", "Bash(git log:*)",
"Bash(npx prettier:*)", "Bash(npx eslint:*)"
],
"deny": [
"Read(.env)", "Read(.env.*)", "Read(**/secrets/**)"
]
}
}已启用的插件
frontend-design-前端设计协助context7-文档查找github-GitHub集成feature-dev-功能开发工作流程code-review-代码审查协助commit-commands-Git提交助手playwright-浏览器测试agent-sdk-dev-代理SDK开发security-guidance-安全最佳实践Notion-概念整合vercel-Vercel部署
MCP服务器
chrome-devtools-Chrome DevTools集成实现浏览器自动化
Ralph工作流
Ralph是一个通过PRD工作的自主编码循环。
快速开始
- 创建PRD:
claude然后键入/prd - 转换为JSON:
/ralph - 运行拉尔夫:
- HITL: ~/.claude/ralph/ralph-once.sh - 暂时离开键盘 ~/.claude/ralph/afk-ralph.sh 50
运作原理
每次迭代:
- 读取PRD和progress.txt
- 查找优先级最高的未完成故事
- 实施它
- 运行反馈循环(类型检查、测试、棉绒)
- 致力于成功
- 集合
passes: true在珠三角 - 重复,直到所有故事都过去
手动安装
所有文件
# Core configs
cp CLAUDE.md ~/.claude/
cp settings.json ~/.claude/
cp ralph-instructions.md ~/.claude/
cp feedback-loops.md ~/.claude/
cp husky-setup.md ~/.claude/
cp .mcp.json ~/
# Hooks
mkdir -p ~/.claude/hooks
cp hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
# Commands
mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/
# Skills
cp -r skills/* ~/.claude/skills/
# Agents
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/
# Ralph
mkdir -p ~/.claude/ralph
cp ralph/*.sh ~/.claude/ralph/
cp ralph/*.md ~/.claude/ralph/
cp ralph/*.example ~/.claude/ralph/
chmod +x ~/.claude/ralph/*.sh定制
添加挂钩
- 创建
hooks/your-hook.sh - 添加到
settings.json在...之下hooks.PreToolUse或hooks.PostToolUse - 使可执行文件:
chmod +x hooks/your-hook.sh
添加技能
- 创建
skills/your-skill/SKILL.md - 添加正面内容:
name,description - 添加技能内容
添加命令
- 创建
commands/your-command.md - 命令可用
/your-command
添加代理
- 创建
agents/your-agent.md - 添加正面内容:
name,description,tools,model - 添加代理说明
同步更改
cd ~/claude-code-config
git pull
./setup.sh许可证
麻省理工学院
