ITADN
PaulRBerg/dot-claude
代码 动态 Issues30 合并请求4 版本
PaulRBerg/dot-claude · 文件 下载 ZIP
文件最后提交记录最后更新时间
README.md
以下内容由 AI 翻译，如有问题请点此提交 issue 反馈

Claude Code 配置

License: MIT Claude Code

PRB 的个人 Claude Code 配置，挂载于 ~/.claude。

快速开始

git clone git@github.com:PaulRBerg/dot-claude.git ~/.claude
cd ~/.claude
just install
ccc  # Make your first commit with the claude wrapper

请参阅 Installation 以获取完整设置，以及 Configuration 以进行自定义。

Installation

Prerequisites

  • Bun：JS 依赖项以及 Husky/lint-staged 自动化（bun install）
  • Just：用于构建脚本的命令运行器（brew install just）
  • Python 3.13+ 和 uv：Python 包/项目管理器

Setup

git clone git@github.com:PaulRBerg/dot-claude.git ~/.claude
cd ~/.claude
just install  # JS deps, Python deps, and CLI utilities

验证

just full-check  # Run all code checks
just test-hooks  # Run hook tests
claude           # Run Claude

配置

设置

所有位于 settings/* 中的 JSONC 文件，在提交时会通过 Husky + lint-staged 合并到 settings.json。

仅编辑 settings/**/*.jsonc（切勿直接编辑 settings.json）。合并发生在提交时，或手动运行 just merge-settings。

设置布局：

  • basics.jsonc: 核心配置、环境变量、状态栏
  • hooks.jsonc: 事件钩子
  • plugins.jsonc: 已启用的插件
  • permissions/*.jsonc: 权限规则（additional-dirs、bash、read）

上下文

CLAUDE.md 是用户级上下文，由 Claude Code 在所有项目中加载。它由 PaulRBerg/dot-agents 的 AGENTS.md —— 规范来源 —— 通过该仓库的 Husky + lint-staged 预提交钩子生成；请勿在此处手动编辑。请将特定于仓库的指导保留在项目 CLAUDE.md / AGENTS.md 文件中。

Justfile

使用 just 执行常见任务，如 just full-check、just merge-settings 和 just test。请参阅 justfile 获取完整的 命令列表。

功能

命令

commands/ 包含调用 skills 的轻量级入口点。命令仍然重要，因为它们支持目录嵌套， 从而启用如 /yeet:issue-cc 和 /agents-brain:brain-polish 这样的命名空间模式。

Skills

Skills 在 PaulRBerg/dot-agents 中管理，并通过 Vercel 的 skills CLI 安装。本仓库保留从 skills/ 到 ~/.agents/skills/ 的符号链接。请参阅 dot-agents 获取安装指南。

示例：agents-brain、commit、vitest、effect-ts、cli-gh、tool-finder、yeet。

Agents

agents/ 可以包含通过 Task 工具调用的专用子代理（目前无）。

MCP 服务器

MCP 服务器在 .mcp.json 中配置（目前无）。

钩子

Hooks 提供事件驱动的 Claude Code 自动化。参见 hooks/README.md。

来自 settings/hooks.jsonc 的活跃 Hooks：

  • add_plan_frontmatter.py：为计划文件添加 YAML frontmatter（PostToolUse）
  • ai-notify：通过外部 ai-notify CLI 发送桌面通知 （Notification、PermissionRequest、PreToolUse、Stop、UserPromptSubmit）
  • copy_prompt_to_clipboard.py：将提交的提示词复制到 macOS 剪贴板（UserPromptSubmit）

Plugins

settings/plugins.jsonc 中未启用任何插件。plugins/ 存储市场元数据和缓存。

Utilities

Shell 工具维护在由 chezmoi 管理的 ~/.config/prb/agents.sh 模块中，并由 ~/.zshrc 自动加载：

  • ccc [args]：通过 /commit 简化提交（默认使用 --all）
  • cccp：提交并推送（功能分支）
  • ccs [args]：仅提交已暂存的更改
  • ccsp [args]：提交已暂存的更改并推送
  • ccbump [args]：通过 /release-bumper 快速提升版本
  • ccta [args]：通过 $todo-archive 归档 TODO

License

MIT。参见 LICENSE.md。