CLAUDE.md 架构师
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samhvw8-dot-claude-claude-md-architect。
技能介绍
问题背景
在 Claude Code 或同类助手里长期维护项目时,团队往往靠一份 CLAUDE.md 把命令、代码风格、测试习惯写进上下文。写得太少,模型反复问「用什么框架」;写得太长,每次对话都吃掉大量 token,还与 README 重复。更麻烦的是,很多文件是模板堆出来的通用建议,并没有对照真实仓库。
技能如何工作
该技能把 CLAUDE.md 当作高频 prompt 而不是完整文档 来对待:先 Discover / Extract 分析语言、框架、目录、测试与 package.json 等证据,再按项目类型(Web、API、CLI、库、Monorepo)选模板并生成精简版;已有文件则走优化路径,识别冗余、过时命令与泛化废话,目标通常是 40%+ token 削减 且保留关键约束。
输出前会对照质量清单:行数建议(优先 <250)、命令可执行性、与代码库风格一致、避免重复 README,并给出 @ 引用 与按需加载策略——只在小而全的配置文件上自动 @,大目录不整包注入。技能还会区分 全局 ~/.claude/CLAUDE.md 与项目级文件,避免 MCP 通用说明写两遍,并在合适场景提示 context7、magic、Playwright 等 MCP 用法。
适用边界与注意点
它解决的是「项目指令文档」的设计与压缩,不能替代你亲自维护业务规则与安全红线;若项目极复杂,可能建议拆成 .claude/CLAUDE.md、.claude/ARCHITECTURE.md 与 slash command。优化效果应以 更少澄清问题、首版代码更贴仓库习惯 为衡量标准,而不是追求行数越少越好却删掉必要约束。
使用场景
- 新仓库接入 Claude Code,需要从零生成与 package.json 命令一致的项目指令文件
- 现有 CLAUDE.md 超过数百行且重复 README,希望在改版前做一次结构化瘦身
- Monorepo 多包协作,要在单份指令里写清 workspace 命令与跨包改动约定
- React/Vue 前端项目启动,需在 CLAUDE.md 中配置按需 @ 与 MCP 文档查询策略
适合人员
- 负责在团队内推广 Claude Code 的技术负责人,需要统一各仓库的项目指令格式与 token 预算
- 维护大型单体或微服务仓库的资深工程师,厌倦模型每次都要手动补充框架与测试命令
- 开源维护者希望 README 面向用户、CLAUDE.md 面向协作者 AI,两者内容不互相抄袭
- 刚接手遗留项目的开发者,需要在不读完全部代码的情况下快速产出可用的 CLAUDE.md 初稿