通过CLAUDE.md、Skills和MCP三层上下文构建,让AI真正理解你的代码库,附OpenAI Symphony并行编排方案对比


通过CLAUDE.md、Skills和MCP三层上下文构建,让AI真正理解你的代码库,附OpenAI Symphony并行编排方案对比
70万行C#代码库,核心开发者毕业离开,功能模块搁置三年没人敢碰。华盛顿大学MacCoss实验室的首席开发者Brendan MacLean,用Claude Code在两周内完成了这个"烂尾工程"。他的方法不是让AI更聪明,而是像带实习生一样,给AI建一套完整的上下文体系。这篇文章拆解他的具体做法,同时对比OpenAI同一天发布的Symphony并行编排方案。
Brendan的洞察很朴素:每次带新人进实验室,新人都不知道项目全貌、代码关系和潜规则。区别在于,新人会慢慢学会,而Claude每次对话结束就全忘了。
所以他的核心策略是:把隐性知识变成AI可读的显性资产。
Brendan建了一个独立的代码仓库 pwiz-ai,专门存放给AI看的上下文。根目录下的 CLAUDE.md 是"地形图",告诉Claude:
项目地址:github.com/ProteoWizard/pwiz-ai
关键原则:CLAUDE.md解决的是"知道在哪"的问题,不解决"知道怎么干活"的问题。
真正的专业知识存放在skills里。比如Brendan写了一个debugging skill,描述是"在排查bug、失败或意外行为时始终加载",强制Claude在动手之前先做根因分析,而不是盲猜试错。
通过MCP(Model Context Protocol)集成,让Claude能读取真实的测试数据、异常报告和用户工单。三层上下文叠满,交互的起点从"空白"变成"理解"。

上下文建好之后,Brendan开始清理积压多年的技术债:
同一周,OpenAI发布了开源项目Symphony(GitHub上已获超1.8万颗Star)。
项目地址:github.com/openai/symphony
Symphony的思路完全不同:把Linear项目看板变成AI编程的控制中心。每个Open状态的Issue自动分配一个Agent,Agent在独立工作区持续运行,崩了自动重启。
部分团队上线Symphony头三周,成功merge的PR数量暴涨了500%。

| 维度 | Claude Code(深度上下文) | Symphony(并行编排) |
|---|---|---|
| 核心理念 | 上下文质量决定一切 | 编排效率决定一切 |
| 类比 | 师傅带徒弟 | 开自动化工厂 |
| 适合场景 | 大型老代码库、复杂业务逻辑 | 团队级新项目、并行任务多 |
| 知识固化方式 | CLAUDE.md + Skills | WORKFLOW.md + SPEC.md |
| 人类角色 | 教AI理解项目 | Review看板上的结果 |
共同发现:以前靠口口相传和肌肉记忆的东西,现在必须白纸黑字写成文档,AI才能接得住。不管走哪条路线,把隐性知识变成显性资产这一步都绕不过去。
如果你正在用AI辅助编程,不管用哪个工具,这三件事现在就可以做:

开源Agent文档维护工具,自动审查项目文档体系并迭代更新,支持Claude Code、Codex、OpenCode、OpenClaw四个平台

腾讯混元开源翻译模型Hy-MT1.5,极致压缩至440MB,支持33种语言离线互译,翻译质量超越谷歌翻译,手机端即可运行

OpenClaw v2026.4.25版本接入13个语音提供商、OTEL全链路可观测性和插件冷启动优化,让Agent运行透明可控