note
文章目录
- note
- [一、Claude Code](#一、Claude Code)
- 二、完整的工程化布局参考
- Reference
一、Claude Code
Claude Code 的核心不是"回答",而是一个反复循环的代理过程:
python
收集上下文 → 采取行动 → 验证结果 → [完成 or 回到收集]
↑ ↓
CLAUDE.md Hooks / 权限 / 沙箱
Skills Tools / MCP
Memory

把 Claude Code 拆成六层来看,如下图。只强化其中一层,系统就会失衡,CLAUDE.md 写太长,上下文先污染自己了;工具堆太多了,选择就搞不清楚了;subagents 开得到处都是,状态就漂移了;验证这步跳过了,出了问题根本不知道是哪里挂的。

二、完整的工程化布局参考
全局约束(CLAUDE.md)、路径约束(rules)、工作流(skills)和架构细节完全解耦,Claude Code 的执行稳定性会显著上升。假如你同时维护多个项目,可以把稳定的个人基线放在 ~/.claude/,各项目的差异放在项目级 .claude/,通过同步脚本分发,不同项目之间就不会互相污染了。
参考:
python
Project/
├── CLAUDE.md
├── .claude/
│ ├── rules/
│ │ ├── core.md
│ │ ├── config.md
│ │ └── release.md
│ ├── skills/
│ │ ├── runtime-diagnosis/ # 统一收集日志、状态和依赖
│ │ ├── config-migration/ # 配置迁移回滚防污
│ │ ├── release-check/ # 发布前校验、smoke test
│ │ └── incident-triage/ # 线上故障分诊
│ ├── agents/
│ │ ├── reviewer.md
│ │ └── explorer.md
│ └── settings.json
└── docs/
└── ai/
├── architecture.md
└── release-runbook.md
Reference
1\] Claude Code 快速上手核心指南:https://datawhalechina.github.io/easy-vibe/zh-cn/stage-3/core-skills/basics/ \[2\] https://x.com/hitw93/status/2032091246588518683?s=46