Claude-ecosystem

克劳德生态系统

一个全面的Claude Code插件，提供自主任务管理、持久内存、语义搜索、深度推理和76种专业技能，所有这些都通过钩子、MCP服务器和CLI工具集成在一起。

包含什么

系统要求

快速开始

安装

git clone https://github.com/brdigetrlol/claude-ecosystem.git
cd claude-ecosystem
./install.sh

这将构建所有Rust二进制文件（第一次大约10-15分钟），创建数据目录，并下载嵌入模型。

用作插件

claude --plugin-dir /path/to/claude-ecosystem

更新

cd /path/to/claude-ecosystem
./update.sh

提取最新更改，显示更改的内容，并重建修改后的二进制文件。

仓库结构

claude-ecosystem/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── .mcp.json                # MCP server definitions (7 servers)
├── hooks/
│   └── hooks.json           # Hook event registrations
├── skills/                  # 76 skill definitions (SKILL.md format)
│   ├── rust-expert/
│   ├── deep-solve/
│   ├── mcp-builder/
│   └── ...
├── agents/
│   └── file-researcher.md   # Subagent definitions
├── scripts/
│   └── hooks/               # 13 hook scripts
│       ├── SessionStart.sh
│       ├── UserPromptSubmit.sh
│       ├── PreToolUse.sh
│       ├── PostToolUse.sh
│       ├── cortex-prompt.sh
│       ├── cortex-pretool.sh
│       ├── cortex-posttool.sh
│       ├── cortex-stop.sh
│       ├── PreCompact.sh
│       └── ...
├── bin/                     # Shell wrappers + built binaries
│   ├── ledger               # Task management CLI
│   ├── engram               # Memory/knowledge CLI
│   ├── cortex               # Auto-task management CLI
│   └── ensure-coordinator   # Daemon health checker
├── src/                     # Rust source code (8 projects)
│   ├── engram-nexus/        # ENGRAM + LEDGER + Cortex
│   ├── oracle/              # Semantic search engine
│   ├── scry/                # Reasoning engine
│   ├── simplex/             # Context selection
│   ├── crouter/             # Multi-model LLM router
│   ├── mcp-forge/           # MCP infrastructure
│   ├── aegis/               # Privacy shield
│   └── gpu-accelerator/     # CUDA compute
├── config/
│   ├── CLAUDE.md            # Project instructions (portable)
│   └── permissions.json     # Recommended permissions
├── docs/                    # Design docs, research, analysis
├── install.sh               # First-time setup
├── build.sh                 # Build all Rust binaries
└── update.sh                # Pull + rebuild

MCP服务器

所有服务器都通过路由 mcp-hotshell 用于统一的生命周期管理。定义于 .mcp.json 便携式 ${CLAUDE_PLUGIN_ROOT} 路径。

钉钩系统

该插件为6个生命周期事件注册挂钩：

技能（76）

技能被调用为 /claude-ecosystem: 插件安装后。

锈 (20+): rust-expert, rust-async-concurrency, rust-cargo-ecosystem, rust-cli, rust-collections, rust-database, rust-design-patterns, rust-error-handling, rust-iterators, rust-macros, rust-memory, rust-networking, rust-performance, rust-serde, rust-testing, rust-traits-generics, rust-unsafe-ffi, rust-web, rust-contracts-patterns, rust-verification-layer

C (10): cpp-expert, cpp-build-cmake, cpp-concurrency, cpp-memory, cpp-performance, cpp-safety, cpp-stl, cpp-testing, cpp-version-features, cpp-templates

主控程序 (5): mcp-builder, mcp-doctor, mcp-orchestrator, mcp-pathfixer, mcp-tester

方法论: deep-solve, markovian-reasoning, L3-complex-solve-framework, cognitive-nexus-orchestrator

领域: deadlock-diagnosis, performance, process-debugging, cuda-gpu-acceleration, diffusion-model-optimization, neural-architecture-search, curriculum-learning-expert

工作流程: documentation, git-workflow, testing-standards, version-management, ledger-task-management, engram-labeling, oracle-recovery, session-repair

CLI工具

安装后，以下CLI包装器在中可用 bin/:

# Task management
ledger add "Fix authentication bug" --task-type bug --complexity moderate
ledger show 
ledger list
ledger complete  --verified-build --verified-tests

# Memory / knowledge
engram write -t decision "Use JWT for auth"
engram query "authentication approach"
engram checkpoint save --focus "auth system"

# Automatic task tracking
cortex ensure-task --session  --prompt "..."
cortex current --session 
cortex detect-shift --session  --tool Edit --file src/auth.rs

数据目录

用户数据存储在外部（不在插件中）：

配置

环境变量

自定义MCP服务器

编辑 .mcp.json 调整服务器配置。所有路径使用 ${CLAUDE_PLUGIN_ROOT} 为了便于携带。要禁用服务器，请从文件中删除其条目。

自定义挂钩

编辑 hooks/hooks.json 启用/禁用特定挂钩。Hook脚本在 scripts/hooks/.

从源头构建

./build.sh

构建所有8个Rust项目并将二进制文件复制到 bin/.单个项目可以单独建造：

cargo build --release --manifest-path src/oracle/Cargo.toml
cargo build --release --manifest-path src/scry/Cargo.toml

故障排除

构建失败

• “找不到链接器cc”：安装构建必备(apt install build-essential 在Linux上， xcode-select --install 在macOS上）
• 构建过程中内存不足：构建单个项目，而不是一次性构建所有项目。每 cargo build 在 build.sh 是独立的。
• CUDA编译错误：CUDA是可选的。移除 gpu-accelerator 从 build.sh 如果你不需要GPU计算。

MCP服务器问题

• 启动时服务器超时：增加克劳德代码设置中的超时时间。服务器初始化时，首次启动可能需要更长的时间。
• “找不到工具”错误：验证 bin/mcp-hotshell 存在并且可执行。跑 ./build.sh 如果丢失。
• Oracle“嵌入失败”：嵌入模型可能无法下载。跑 ./install.sh 再次或手动下载 sentence-transformers/all-MiniLM-L6-v2 到 ~/.cache/huggingface/hub/.

钩子问题

• 钩子没有开火：检查一下 hooks/hooks.json 条目指向中的现有脚本 scripts/hooks/.
• “找不到命令：engram”：The bin/ 目录必须在PATH中，或者钩子必须使用通过的绝对路径 ${CLAUDE_PLUGIN_ROOT}/bin/.

数据恢复

• ENGRAM数据：存储在 ~/.engram/rocksdb/ 具有自动备份功能 ~/.engram/rocksdb-backups/.
• Oracle索引：重建 oracle_index(path: "/path/to/your/codebase") 通过Oracle MCP工具。

建筑

Claude Code
  ├── Hooks (SessionStart, PreToolUse, PostToolUse, Stop, PreCompact)
  │     └── scripts/hooks/*.sh → bin/{engram,cortex,ledger}
  │           └── engram-coordinator (RocksDB daemon)
  │
  ├── MCP Servers (via mcp-hotshell)
  │     ├── Oracle (semantic search + entailment)
  │     ├── SCRY (cognitive reasoning)
  │     ├── Simplex (context selection)
  │     ├── cRouter (multi-model routing)
  │     ├── Aegis (privacy shield)
  │     └── GPU Accelerator (CUDA compute)
  │
  ├── Skills (76 specialized prompts)
  │
  └── Agents (file-researcher, etc.)

许可证

麻省理工学院——见 许可证 了解详情。