AI代理配置模板

一个可重用的Claude Code配置模板,用于跨项目强制执行行为规则、质量门和安全约束。

  • by RageLtd
  • PowerShell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 RageLtd/fancy-agents

使用说明

花式代理

Claude Code的可重用配置模板,在任何项目中强制执行行为规则、质量门和安全约束。

快速开始

选项1:用作GitHub模板

  1. 点击 “使用此模板” 在GitHub上创建新的存储库
  2. 克隆您的新存储库
  3. 运行安装脚本:
    # 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
    
  4. 重新启动Claude Code以获取新规则和插件

选项2:下载和提取

  1. 将存储库下载为ZIP文件
  2. 提取内容
  3. 运行安装脚本(见上文)
  4. 重新启动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)

岗位设置

运行安装脚本后:

  1. 重新启动Claude代码 加载规则和插件
  2. 定制 AGENTS.md 具有项目特定的身份和背景
  3. 规则在 .claude/rules/ 将立即激活

如果你使用 --install-memory: 4. 跑 /plugins 查看RageLtd/Goldfish提供的插件 5. 启用其他插件 根据需要,通过克劳德代码设置

某些插件需要额外配置:

  • 阿特拉斯 -需要Atlassian帐户身份验证
  • 概念 -需要Notion工作区授权

专为可靠、可审计和安全的代理操作而构建。