花式代理
Claude Code的可重用配置模板,在任何项目中强制执行行为规则、质量门和安全约束。
快速开始
选项1:用作GitHub模板
- 点击 “使用此模板” 在GitHub上创建新的存储库
- 克隆您的新存储库
- 运行安装脚本:
# macOS/Linux — install rules globally
./scripts/setup.sh
# macOS/Linux — install rules to a specific project
./scripts/setup.sh /path/to/my-project
# Windows (PowerShell)
.\scripts\setup.ps1
.\scripts\setup.ps1 -TargetPath C:\path\to\my-project- 重新启动Claude Code以获取新规则和插件
选项2:下载和提取
- 将存储库下载为ZIP文件
- 提取内容
- 运行安装脚本(见上文)
- 重新启动Claude代码
里面是什么
行为规则
.claude/rules/ 包含Claude Code自动加载的分类规则文件:
| 类别 | 规则 | 目的 |
|---|---|---|
| 编程 | functional-style.md, error-handling.md | 函数式编程(关键),错误结果模式 |
| 质量 | quality-gates.md, tdd.md, code-changes.md | 安全审查、测试覆盖率、最小更改 |
| 安全 | git-restrictions.md, security.md | 无代理提交/推送,机密保护 |
| 工作流 | plan-first.md, stop-conditions.md | 计划审批执行流程,上报触发 |
| 沟通 | output-format.md, response-style.md | 结构化的回应,简洁的风格 |
| 文档 | best-practices.md, decision-records.md | 模式记录、决策跟踪 |
| 工具 | tool-usage.md, biome.md, bun.md, rust-tooling.md | 工具使用原则、生物识别/格式化、节点捆绑、rustfmt+clippy |
rule-priority.md 定义冲突解决: 安全>质量>工作流程>代码风格.
代理身份
代理商.md 定义了一个最小的代理身份。 CLAUDE.md 是指向的符号链接 AGENTS.md 因此,Claude Code和其他查找任一文件名的工具都会找到它。安装后,根据每个项目自定义此文件名。
Claude代码插件
.claude/settings.json 从官方市场启用11个插件:
- 上下文7 -文档查找
- 功能开发 -引导功能开发
- 代码审查 -多方面代码审查
- 公关审查工具包 -公关审查代理
- 打字lsp -TypeScript语言服务器
- 锈蚀分析仪lsp -Rust语言服务器
- 代码简化器 -代码清晰度
- 安全指南 -安全最佳实践
- 插件开发 -插件开发工具
- 阿特拉斯 -Jira/Confluence集成
- 概念 -概念工作空间集成
设置脚本
scripts/setup.sh (macOS/Linux)和 scripts/setup.ps1 (Windows):
- 安装TypeScript语言服务器
- 安装锈蚀分析仪
- 复制
.claude/rules/目标项目或~/.claude/rules/(全球) - 可选择安装 RageLtd/金鱼 插件市场
旗帜
| 标志 | Bash | PowerShell | 描述 |
|---|---|---|---|
| 目标路径 | ./setup.sh /path | .\setup.ps1 -TargetPath C:\path | 将规则安装到特定项目(默认:全局) |
| 安装内存 | ./setup.sh --install-memory | .\setup.ps1 -InstallMemory | 包括RageLtd/Goldfish市场 |
标志可以组合: ./scripts/setup.sh --install-memory /path/to/project
结构
.
├── .claude/
│ ├── settings.json # Plugin configuration
│ └── rules/ # Behavioral rules (18 files, 7 categories)
│ ├── rule-priority.md # Conflict resolution hierarchy
│ ├── coding/ # Functional style, error handling
│ ├── communication/ # Output format, response style
│ ├── documentation/ # Best practices, decision records
│ ├── quality/ # Quality gates, TDD, code changes
│ ├── safety/ # Git restrictions, security
│ ├── tooling/ # Tool usage, Biome, Bun, Rust tooling
│ └── workflow/ # Plan-first, stop conditions
├── docs/
│ └── BEST_PRACTICES.md # Template for capturing verified patterns
├── scripts/
│ ├── setup.sh # macOS/Linux setup
│ └── setup.ps1 # Windows setup
├── AGENTS.md # Agent identity (customize per-project)
├── CLAUDE.md # Symlink → AGENTS.md
└── README.md需求
- 克劳德代码 已安装CLI
- Node.js(用于TypeScript LSP)
- Rust工具链(可选,适用于Rust Analyzer)
- Git(用于市场安装,如果使用
--install-memory)
岗位设置
运行安装脚本后:
- 重新启动Claude代码 加载规则和插件
- 定制
AGENTS.md具有项目特定的身份和背景 - 规则在
.claude/rules/将立即激活
如果你使用 --install-memory: 4\. 跑 /plugins 查看RageLtd/Goldfish提供的插件 5\. 启用其他插件 根据需要,通过克劳德代码设置
某些插件需要额外配置:
- 阿特拉斯 -需要Atlassian帐户身份验证
- 概念 -需要Notion工作区授权
______________________________________________________________________
专为可靠、可审计和安全的代理操作而构建。
