Claude Workspace Template

Claude工作区模板

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

包含什么

快速开始

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

许可证

麻省理工学院