团队代理设置
成熟度:存档-继此项目之后的一个新项目是 ACE(代理协调引擎) 版本: 0.0.4
______________________________________________________________________
这是Claude Code的分层代理设置,它使用Cognee MCP让代理按需访问开发模式。目标是减少上下文使用,同时保持整个团队的一致性。
先决条件
- 支持MCP服务器的Claude代码
- Docker和Docker Compose- 安装说明
yq- 安装说明jq- 安装说明bats- 安装说明markdownlint- 安装说明shellcheck- 安装说明
快速开始
- 启动Cognee服务 -请参阅 内存mcp/README.md
- 配置MCP连接 -
claude mcp add --scope user --transport sse cognee http://YOUR_SERVER_IP:4000/sse - 安装代理定义 -快跑
./scripts/install-agents.sh - 负载和进程模式 -快跑
./scripts/load-patterns.sh然后cat memory-mcp/logs/datasets-loaded.txt | ./scripts/cognify-patterns.sh - 开始使用代理 -请参阅 代理/定义/ABOUT-THE-agents.md
用法
Main Claude通过根据您正在构建的内容将任务移交给专业代理来协调您的开发工作。代理只在需要时从Cognee MCP中提取模式,而不是预先加载所有内容。
可用代理:软件架构师代理、api架构师代理、go软件代理、go e2e测试代理、shell脚本代理、bat测试代理、文档代理
模式库:API模式(REST、GraphQL、gRPC、AsyncAPI)、CLI模式(Cobra)、Shell脚本模式(POSIX、跨平台、可读性)、测试模式(E2E、BATS)、DevOps模式(Docker、CI/CD、Azure DevOps)
结账 代理/README.md 了解完整的代理详细信息和 代理/定义/ABOUT-THE-agents.md 对于工作流。
运作原理
分层代理主Claude在需要设计工作时与架构师交谈,将工作交给工程师实施,并引入测试工程师进行验证。每个代理都专注于它最擅长的事情。
Cognee MCP集成:代理在需要时查询Cognee的知识记忆,而不是将模式填充到提示中。这将代理大小减少了约80%,同时仍允许他们访问全面的模式库。
共享内存:您团队中的每个人都连接到同一个Cognee服务器。当有人更新一个模式时,每个人都可以立即使用它——使整个团队保持一致。
关键考虑因素
Cognee MCP是必需的:代理需要Cognee来检索模式。前往 内存mcp/README.md 以设置它。
需要网络访问:您的团队需要能够访问端口4000上的Cognee服务器。
所需资源:Cognee需要大约8-12GB的RAM,具体取决于您使用的LLM提供商。检查 内存mcp/README.md 有关配置详细信息。
实验建筑:这是一个新兴的参考实现——随着我们了解什么有效,情况会发生变化。
图案维护:保留图案 代理/模式/ 与Cognee同步使用 /load_patterns 命令。
不是框架:将此视为可以适应您需求的配置参考,而不是现成的库。
开发注意事项
建筑与运营
Cognee服务器:参见 内存mcp/README.md
代理安装:运行 ./scripts/install-agents.sh
图案加载和处理:
# Step 1: Load patterns into Cognee dataset
./scripts/load-patterns.sh
# Step 2: Process into knowledge graph (choose one):
cat memory-mcp/logs/datasets-loaded.txt | ./scripts/cognify-patterns.sh # Process loaded datasets
./scripts/cognify-patterns.sh # Process ALL datasets
# Monitor async processing
docker compose -f memory-mcp/docker-compose.yml logs -f cognee-api模式验证:运行 ./scripts/validate-metadata.sh
测试
有一个BATS测试套件 tests/ 目录。使用以下工具运行测试:
bats tests/install-agents.batsShell脚本质量
我们使用shellcheck验证所有脚本:
shellcheck scripts/*.sh版本控制
我们使用基于git标签的版本控制和语义版本号。在中跟踪更改 更改日志.md 跟随 保存变更日志.
要创建发布,请标记commit:
git tag -a -s v0.1.0 -m "Release v0.1.0"
git push origin v0.1.0文档
- docs/about.md -项目背景和动机
- 代理/README.md -代理系统详细信息
- 代理/定义/ABOUT-THE-agents.md -代理工作流和委派模式
- 内存mcp/README.md -Cognee服务器设置
- docs/PATTERN-METADATA-SCHEMA.md -模式元数据规范
