167 lines
6.7 KiB
Markdown
167 lines
6.7 KiB
Markdown
# Claude Code个人配置
|
||
|
||
**GitHub**: [0xbigboss/claude-code](https://github.com/0xbigboss/claude-code) | **Gitea**: [mc-skills/0xbigboss--claude-code](http://192.168.0.109:3000/mc-skills/0xbigboss--claude-code)
|
||
|
||
## 中文摘要
|
||
|
||
为Claude Code提供开发规范、斜杠命令、自定义子代理和多语言技能配置，包含代码审查、调试、重构、测试等工作流工具，支持Python/TypeScript/Go/Zig等语言最佳实践，通过GNU Stow或手动符号链接安装。
|
||
|
||
## 标签
|
||
|
||
`Claude Code` `开发配置` `斜杠命令` `自定义代理` `多语言支持`
|
||
|
||
---
|
||
|
||
## README 原文
|
||
|
||
# Claude Code Configuration
|
||
|
||
Personal configuration for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) providing development guidelines, slash commands, custom agents, and language-specific skills.
|
||
|
||
## What's Included
|
||
|
||
```
|
||
claude-code/
|
||
├── CLAUDE.md # Shared runtime agent instructions (synced to ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md)
|
||
├── CLAUDE.local.md # Local operational notes for this repo (not the runtime instruction source)
|
||
├── commands/ # Slash commands
|
||
│ ├── fix-issue.md # /fix-issue <id> - locate and fix issues
|
||
│ ├── git-commit.md # /git-commit - conventional commit workflow
|
||
│ ├── handoff.md # /handoff - generate session handoff prompts
|
||
│ └── rewrite-history.md # /rewrite-history - clean up branch commits
|
||
├── agents/ # Custom subagents
|
||
│ ├── code-reviewer.md # Review code for quality and security
|
||
│ ├── debugger.md # Root cause analysis for failures
|
||
│ ├── refactorer.md # Clean refactoring with complete migrations
|
||
│ └── test-writer.md # Write tests that verify correctness
|
||
├── .claude/
|
||
│ └── skills/ # Language and tool best practices
|
||
│ ├── python-best-practices/
|
||
│ ├── typescript-best-practices/
|
||
│ ├── react-best-practices/
|
||
│ ├── go-best-practices/
|
||
│ ├── zig-best-practices/
|
||
│ ├── playwright-best-practices/
|
||
│ ├── tamagui-best-practices/
|
||
│ ├── tilt/
|
||
│ ├── web-fetch/
|
||
│ ├── axe-ios-simulator/
|
||
│ └── zig-docs/
|
||
├── scripts/ # Utility scripts
|
||
│ ├── install-symlinks.sh # Installation helper
|
||
│ └── sync-codex.sh # Sync/check Claude commands + skills into Codex
|
||
├── codex-overrides/
|
||
│ └── skills/ # Codex-only skill overrides applied after upstream sync
|
||
├── settings/ # Settings configurations
|
||
├── statusline/ # Statusline configurations
|
||
└── analytics/ # Usage analytics (submodule)
|
||
```
|
||
|
||
## Installation
|
||
|
||
### Via Stow (Recommended)
|
||
|
||
This repo is a submodule of a dotfiles repository using GNU Stow:
|
||
|
||
```bash
|
||
cd ~/code/dotfiles
|
||
stow -v -R -t ~ claude
|
||
```
|
||
|
||
The `claude` stow package symlinks to this repo's contents.
|
||
|
||
### Manual Symlinks
|
||
|
||
```bash
|
||
mkdir -p ~/.claude
|
||
ln -sf "$(pwd)/CLAUDE.md" ~/.claude/CLAUDE.md
|
||
ln -sf "$(pwd)/commands" ~/.claude/commands
|
||
ln -sf "$(pwd)/agents" ~/.claude/agents
|
||
ln -sf "$(pwd)/.claude/skills" ~/.claude/skills
|
||
```
|
||
|
||
## Commands
|
||
|
||
Invoke with `/command-name` in Claude Code:
|
||
|
||
| Command | Description |
|
||
|---------|-------------|
|
||
| `/fix-issue <id>` | Find and fix an issue by ID with tests and PR description |
|
||
| `/git-commit` | Review changes and create conventional commits |
|
||
| `/handoff` | Generate a self-contained handoff prompt for another agent |
|
||
| `/rewrite-history` | Rewrite branch with clean, narrative commit history |
|
||
|
||
## Agents
|
||
|
||
Custom subagents for focused tasks. Claude Code delegates to these automatically when appropriate:
|
||
|
||
| Agent | Purpose |
|
||
|-------|---------|
|
||
| `code-reviewer` | Reviews changes for quality, security, and project conventions |
|
||
| `debugger` | Investigates failures through root cause analysis |
|
||
| `refactorer` | Restructures code with clean breaks and complete migrations |
|
||
| `test-writer` | Writes tests that verify correctness without gaming assertions |
|
||
|
||
## Skills
|
||
|
||
Language and tool-specific best practices loaded automatically based on file context:
|
||
|
||
| Context | Skill |
|
||
|---------|-------|
|
||
| Python (`.py`, `pyproject.toml`) | python-best-practices |
|
||
| TypeScript (`.ts`, `.tsx`) | typescript-best-practices |
|
||
| React (`.tsx`, `.jsx`, `@react` imports) | react-best-practices |
|
||
| Go (`.go`, `go.mod`) | go-best-practices |
|
||
| Zig (`.zig`, `build.zig`) | zig-best-practices |
|
||
| Playwright (`@playwright/test`) | playwright-best-practices |
|
||
| Tamagui (`@tamagui` imports) | tamagui-best-practices |
|
||
| Tilt (`Tiltfile`) | tilt |
|
||
|
||
## Runtime Settings
|
||
|
||
- Baseline settings: `claude-code/settings/settings.json`
|
||
- Local overrides: `~/.claude/settings.local.json`
|
||
- Generated runtime file: `~/.claude/settings.json` (generated by `bin/bin/claude-settings-merge --fix`)
|
||
- Merge behavior: object keys merge recursively; `permissions.allow` and `permissions.additionalDirectories` append local entries without removing baseline entries; other arrays are replaced by local values.
|
||
|
||
## Instruction Source of Truth
|
||
|
||
- Keep shared agent behavior in `claude-code/CLAUDE.md`.
|
||
- Keep local repo notes and personal operational guidance in `claude-code/CLAUDE.local.md`.
|
||
- Do not move local-only content into `claude-code/CLAUDE.md`; that file syncs to both `~/.claude/CLAUDE.md` and `~/.codex/AGENTS.md`.
|
||
|
||
## Codex Asset Sync
|
||
|
||
```bash
|
||
# Drift check only (exit 0 clean, 2 drift, 1 error)
|
||
claude-code/scripts/sync-codex.sh --check
|
||
|
||
# Apply sync and prune stale managed entries (commands + skills)
|
||
claude-code/scripts/sync-codex.sh
|
||
```
|
||
|
||
Codex skill sync is curated:
|
||
|
||
- Upstream Claude user skills sync first
|
||
- Plugin skills sync next, with selective drops from `claude-code/scripts/sync-codex.skill-policy.tsv`
|
||
- Codex-only overrides in `claude-code/codex-overrides/skills/` sync last and win on name collision
|
||
|
||
## Core Principles
|
||
|
||
The `CLAUDE.md` guidelines emphasize:
|
||
|
||
- **Type-first development**: Define types before implementing logic; make illegal states unrepresentable
|
||
- **Functional style**: Prefer immutability, pure functions, and explicit data flow
|
||
- **Minimal changes**: Implement only what's requested; avoid unrequested features or refactoring
|
||
- **Error handling**: Handle or return errors at every level; fail loudly with clear messages
|
||
- **Test integrity**: Tests verify correctness, not just satisfy assertions
|
||
- **Clean refactoring**: Update all callers atomically; delete superseded code completely
|
||
|
||
## Author
|
||
|
||
Created by Allen Eubank (Big Boss)
|
||
|
||
## License
|
||
|
||
Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.
|