AI配置
用于Claude Code的Ansible管理的多代理AI开发环境。一个命令安装60多个专业代理、25多个技能、MCP服务器、RAG基础设施（Qdrant）、设计工具（OpenPencil）、任务管理（Beads）和多代理编排（Gastown）——在任何项目中都可以在全球范围内使用。
这有什么作用
~/.claude/ -> symlink to this repo's .claude/安装后，每 claude 您计算机上的会话可以访问：
- 60+代理商 --从团队领导的编排者到专业的前端/后端/开发/安全工程师
- 25+技能 --
/teamlead,/implement,/debug,/test,/pr-review,/research，以及更多 - MCP服务器 --Qdrant（RAG）、代码索引mcp（语义搜索）、Context7（实时文档）、Mem0（代理内存）、OpenPencil（设计）
- 钩子 --写入时自动换行、完成时TTS、操作系统通知、安全防护
- 状态行 --通过ccuage实时跟踪使用情况
快速开始
全新安装（一个命令）
bash 架构师->敏捷大师->开发->审查->测试->验证|95%|
| **错误修复** |开发->审查->测试|90%|
| **热修复** |开发->测试|85%|
| **重构** |架构师->开发->审查->测试|95%|
| **文档** |作者->建筑管理员|评论|
| **原型** |架构师->开发| 75%|
## MCP服务器
安装于 **用户范围** （适用于所有项目）：
|服务器|用途|后端|
|--------|---------|---------|
| **qdrant mcp** |矢量搜索、知识存储|Qdrant（Docker）|
| **代码索引mcp** |深度代码索引、语义搜索|本地索引|
| **上下文7** |实时库文档|HTTP API|
| **mem0** |结构化代理内存|本地SQLite|
| **打开铅笔** |人工智能驱动的设计工具|npx|
### 根据项目MCP
复制 `.claude/templates/.mcp.json.template` 对于您的项目 `.mcp.json` 用于特定项目的服务器（GitHub、Playwright等）。
## 集成工具
|工具|命令|目的|
|------|---------|---------|
| **珠子** | `bd` |具有DAG依赖关系的任务管理|
| **煤气镇** | `gt` |大型项目的多代理编排|
| **Repomix** | `repomix` |代码库上下文快照|
| **帮助** | `aider` |AI配对编程|
| **球菌** |statusline |实时克劳德代码使用跟踪|
## 语境策略
|战略|何时|如何|
|----------|------|-----|
| **自动** |默认|检查快照大小，自动选择|
| **再混合** |\7000k令牌|查询Qdrant+代码索引mcp|
按项目配置 `docs/project.yaml` -> `context.strategy`.
## 钩子
|钩子|触发器|动作|
|------|---------|--------|
| **PostTool使用（写入）** |文件写入后|自动换行（eslint/ruff）|
| **预工具使用（Bash）** |在shell命令之前|阻止 `rm -rf`，用力推到主|
| **通知** |代理完成|操作系统通知（macOS/Linux）|
| **停止** |会话结束|TTS公告，记录会话|
| **会话开始** |会话开始|加载珠子上下文(`bd prime`) |
| **准紧的** |在上下文压缩之前|保留任务状态(`bd prime`) |
## 设置
中的关键设置 `.claude/settings.json`:
- **权限**：预先批准的工具（git、docker、npm、语言运行时等）
- **安全防护装置**：块 `rm -rf`，用力推到主/主
- **环境**：代理团队已启用，30回合代理限制，MCP 30秒超时
- **默认模式**: `acceptEdits` --自动批准文件编辑
## 技能参考
### 发展
`/teamlead` `/implement` `/debug` `/refactor` `/test` `/commit`
### 质量
`/pr-review` `/security-audit` `/audit` `/simplify`
### 研究与规划
`/research` `/design` `/decide` `/docs` `/learn`
### 项目管理
`/project-setup` `/onboard` `/changelog` `/readme` `/migrate`
### 领域
`/backend-dev` `/devops` `/ai-product-dev` `/analytics` `/system-design`
### 代理系统
`/agent-creator` `/agent-workflow` `/directives` `/update-ai` `/find-skills`
## 配置
### 可解析变量(`roles/ai/defaults/main.yml`)
|变量|默认值|描述|
|----------|---------|-------------|
| `qdrant_enabled` | `true` |部署Qdrant容器|
| `qdrant_tag` | `v1.13.2` |Qdrant图像版本|
| `qdrant_memory_limit` | `1g` |容器内存限制|
| `qdrant_mcp_embedding_model` | `paraphrase-multilingual-MiniLM-L12-v2` |嵌入模型（RU/EN）|
| `qdrant_hybrid_search_enabled` | `true` |BM25稀疏向量|
| `code_index_mcp_enabled` | `true` |代码索引MCP|
| `context7_mcp_enabled` | `true` |库文档MCP|
| `mem0_enabled` | `true` |代理内存MCP|
| `open_pencil_enabled` | `true` |设计工具|
| `ccusage_enabled` | `true` |使用状态线|
### Qdrant集合架构
- **密集向量**：384 dim，余弦距离，int8量化
- **稀疏向量**：带IDF修改器的BM25（混合搜索）
- **存储**：磁盘上的mmap，RAM中的量化向量
- **HNSW**：m=16，ef_construct=100
## 健康检查
Qdrant
curl -s http://localhost:6333/healthz docker start qdrant # if stopped
MCP servers
claude mcp list
Beads
bd list
Repomix
repomix --version
## 支持平台
|平台|包管理器|状态|
|----------|----------------|--------|
|macOS |自制|初级|
|Ubuntu/Debian |apt|支持|
|Fedora/RHEL | dnf |支持|
|Arch Linux | pacman |支持|
## 关键文件
|文档|路径|目的|
|----------|------|---------|
|宪法| `docs/Constitution.md` |所有代理人的强制性规则|
|优化计划| `docs/ai-optimization-plan.md` |改进路线图|
|建筑| `docs/architecture/overview.md` |系统架构规范|
|技术栈| `docs/tech-stack.md` |技术文档|
|要求| `docs/requirements.md` |系统要求|
|项目配置| `docs/project.yaml` |项目级配置|
|代理目录| `.claude/docs/agents/README.md` |所有带有描述的代理|
|技能目录| `.claude/docs/skills/README.md` |所有使用技能|
## 许可证
私有存储库。