克劳德代码工程配置
分层工程系统 克劳德代码.智能管理上下文,因此Claude使用其上下文窗口的约20%而不是60%,并且表现得像高级工程师而不是聊天机器人。
 ](https://github.com/Arxchibobo/claude-Reconstruction) ](https://nodejs.org)
______________________________________________________________________
概述
Claude Code加载所有内容 ~/.claude/ 默认情况下进入上下文。在任何工作开始之前,典型的配置会占用60%的上下文窗口。
该系统通过5层架构解决了这个问题,该架构:
- 仅加载相关文档 每种任务类型(35-55KB,而不是120KB)
- 强制执行4步工作流程 --计划→ 确认→ 执行→ 交付
- 安装挂钩基线 用于在不覆盖现有用户钩子的情况下进行命令/编辑生命周期检查
- 通往专业代理商的路线 用于架构、审查和安全问题
- 跨会话持久化内存 因此,模式和上下文在对话重置中幸存下来
______________________________________________________________________
特性
- 智能上下文加载 --关键字匹配的文档加载使上下文保持在28%以下
- 自主执行 --克劳德独立决定95%的问题;只有4种情况需要用户输入
- 钩层 --PreToolUse/PostToolUse/session挂钩为生命周期检查提供了安全的基线
- 15模式错误库 --记录最常见的人工智能辅助开发错误的根本原因和修复方法
- 8名专业代理 --规划师、架构师、代码审查员、安全分析师、范围分析师等
- 持久存储系统 --跨会话状态通过
memory/MEMORY.md(自动加载,\=18.0.0|
|pnpm|>=8.0.0|
平台:Windows、macOS、Linux
开发人员依赖性:第3.2.5层(仅格式化)
______________________________________________________________________
建筑
该系统由5层堆叠而成。每一层在Claude执行生命周期的不同点进行拦截。
┌─────────────────────────────┐
│ User Request │
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
Layer 5 │ Context Manager │ What docs to load?
│ (CONTEXT_MANAGER.md) │ Keyword matching → load plan
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
Layer 4 │ Workflow Engine │ How to work?
│ (rules/core/work-mode.md) │ Plan → Confirm → Execute → Deliver
│ (rules/core/blocking-rules) │ When to ask vs. decide
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
Layer 3 │ Rules Engine │ What rules to follow?
│ (rules/domain/*.md) │ coding, testing, security, git
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
Layer 2 │ Hook Layer │ Quality gates on every tool call
│ (rules/hooks.md) │ PreToolUse / PostToolUse / Stop
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
Layer 1 │ Agent Orchestration │ Route to specialists
│ (rules/agents.md) │ Planner / Reviewer / Security
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
│ Tool Execution │
└─────────────────────────────┘第5层:上下文管理器
问题:克劳德把所有东西都装进去了 ~/.claude/ 结合上下文。在任何工作开始之前,120KB的配置会占用60%的上下文窗口。
解决方案:上下文管理器(CONTEXT_MANAGER.md)从关键字中识别任务类型,并仅加载相关文档。
User says "write a Playwright test"
→ detected: browser-automation
→ loads: rules/core/ (10KB) + rules/domain/coding.md (5KB) + capabilities/browser-automation-decision-tree.md (8KB)
→ total: 23KB (12% context)
→ leaves 88% free for actual work| 图层 | 内容 | 时间 | 大小 |
|---|---|---|---|
| L0 | CLAUDE.md + rules/core/ | 始终 | ~15KB |
| L1 | index/task-router.md | 路由 | ~3KB |
| L2 | 域+能力文档 | 匹配 | 15-30KB |
| L3 | 模板、示例 | 精确匹配 | 各不相同 |
第4层:工作流引擎
定义 克劳德是如何工作的 任何任务。位于 rules/core/.
4步循环:
1. Plan → Create TodoList, break down steps
2. Confirm → Show plan, wait for user "go"
3. Execute → Autonomous decisions, no questions
4. Deliver → Summary, verification, handoff阻止规则 --克劳德只在4种情况下提问:
- 缺少凭据(API密钥、密码)
- 互斥方法(无法从代码库中推断)
- 矛盾的要求
- 不可逆转的高风险操作
其他一切都是自主决定的:文件名、代码风格、依赖版本、UI细节、测试策略。
第3层:规则引擎
管理代码质量的特定领域规则。位于 rules/domain/.
| 模块 | 文件 | 它强制执行什么 |
|---|---|---|
| 代码风格 | rules/domain/coding.md | 不变性优先,小文件(\(): ` |
类型: feat, fix, docs, refactor, test, chore 范围: error, capability, design, core, workflow
许可证
麻省理工学院——见 许可证.
