AI导哈

代码项目启动工具包

用于快速启动Claude代码项目的全功能套件，包含编排、持久化和MCP运行时等核心组件。

  • by MitchellkellerLG
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MitchellkellerLG/claude-workspace-template

使用说明

Claude工作区模板

一个完整的操作工具包，用于引导具有编排、连续性和MCP运行时的Claude Code项目。

包含什么

组件 描述
编排器 将复杂任务分解为并行代理工作的指挥哲学
连续性系统 幸存的会话状态 /clear （账簿、交接单）
规则 4个久经考验的作战护栏
钩子 事件驱动自动化（会话生命周期、工具使用）
MCP运行时 MCP服务器集成的Python工具
Braintrust插件 可选的可观察性/跟踪

快速开始

1.克隆模板

git clone https://github.com/YOUR_USERNAME/claude-workspace-template my-project
cd my-project

2.设置环境

# Copy example files
cp .env.example .env
cp mcp_config.json.example mcp_config.json
cp CLAUDE.local.md.example CLAUDE.local.md

# Edit .env with your API keys
# Edit mcp_config.json with your MCP servers

3.安装Python依赖项

# Create virtual environment
uv venv

# Install base dependencies
uv pip install -e .

# Optional: Install with dev tools
uv pip install -e ".[dev]"

# Optional: Install with tracing
uv pip install -e ".[tracing]"

4.生成MCP包装器（如果使用MCP服务器）

uv run mcp-generate

5.启动克劳德

claude

项目结构

.
├── .claude/
│   ├── skills/           # SOPs and workflows
│   │   ├── orchestrator/ # The conductor system
│   │   ├── continuity_ledger/
│   │   ├── create_handoff/
│   │   └── resume_handoff/
│   ├── rules/            # Operational guardrails
│   ├── hooks/            # Event automation
│   ├── plugins/          # Optional plugins
│   └── settings.json     # Hook config
│
├── thoughts/             # Context persistence
│   ├── ledgers/          # Session state
│   └── shared/           # Handoffs and plans
│
├── src/runtime/          # MCP runtime
├── scripts/              # CLI workflows
├── servers/              # Generated MCP wrappers (gitignored)
├── samples/              # Test data schemas
├── references/           # Domain knowledge
│
├── CLAUDE.md             # Main instructions
├── CLAUDE.local.md       # Local config (gitignored)
├── .env                  # API keys (gitignored)
└── mcp_config.json       # MCP server config

关键概念

编排器

编排技巧(.claude/skills/orchestrator/SKILL.md)定义了Claude的操作方式：

  • 分解 将复杂任务转换为并行工作流
  • 生成 执行工人代理人
  • 合成 将结果转化为连贯的输出

连续性

跨上下文持续存在的状态清除：

  • 账本 (thoughts/ledgers/)-会话状态，之后自动加载 /clear
  • 交接 (thoughts/shared/handoffs/)-跨届会议文件

域名指南

中常见任务类型的预构建指南 .claude/skills/orchestrator/references/domains/:

  • 软件开发
  • 代码审查
  • 测试
  • 文档
  • 开发运维
  • 数据分析
  • 研究
  • 项目管理

定制

添加技能

  1. 创建： .claude/skills/[skill-name]-SKILL.md
  2. 添加带有触发器的YAML frontmatter
  3. CLAUDE.md中的参考（如果经常使用）

添加MCP服务器

  1. 将配置添加到 mcp_config.json
  2. 将密钥添加到 .env
  3. 跑 uv run mcp-generate

添加参考文档

在中创建markdown文件 references/ 对于克劳德应该访问的领域知识。

命令

# MCP wrapper generation
uv run mcp-generate

# Run script with MCP
uv run python -m runtime.harness scripts/your_script.py --args

# Schema discovery
uv run mcp-discover

许可证

麻省理工学院

相关 MCP