找了一晚上 Claude Code 项目分析 Skill，这是我挖到的 6 个宝贝

起因

事情是这样的。

我手上有个项目，代码量不小，总觉得哪里不对劲但又说不上来。架构是不是合理的？有没有死代码？模块之间耦合严不严重？这些问题靠肉眼看代码很难回答，靠 Claude Code 的默认能力也只能一个文件一个文件地审。

我就想：Claude Code 不是有 Skill 机制吗？GitHub 上那么多社区 Skill，找个能一键扫描整个项目、给出架构分析和代码坏味道报告的，应该不难吧？

事实证明，很难。

搜索：GitHub 上的大海捞针

我用 gh CLI 开始搜。先试了最直觉的关键词：

gh search repos "claude code skill smell" --limit 10
gh search repos "claude code skill code review" --limit 10
gh search repos "claude code skill architecture" --limit 10

结果出来一大堆，但大部分是"代码审查"类的——看看 PR 有没有写错、变量命名对不对。我要的不是这个，我要的是项目级的分析：架构合不合理、有没有冗余、模块耦合怎么样、哪里可以删。

换了个思路，直接搜代码内容：

gh search code "smell" --filename "SKILL.md" -L 20
gh search code "architecture smell" --filename "SKILL.md" -L 20
gh search code "tech debt" --filename "SKILL.md" -L 20

这下精准多了。翻了一圈，锁定了几个目标，逐个看 README、读 SKILL.md 源码，最终筛出了 6 个。

第一批：架构四件套

来自 MartinPLarsen/claude-architecture-skills，4 个 Skill 组成一条完整的分析流水线。

architecture-audit：全景扫描

这个是整条链的起点。它会先把你的仓库摸一遍，搞清楚有几个子系统，然后给每个子系统派一个独立的子 Agent 去读代码。所有子 Agent 读完之后，合成一份架构文档，里面带 Mermaid 流程图（系统上下文图、端到端流程图、组件图、数据生命周期图）。

最狠的是最后一步：对抗性验证。它会派一个专门的 Agent 去检查文档里写的每一句话，是不是真的跟代码对得上。比如文档说"请求经过 A → B → C 三个模块"，它会去代码里确认这个顺序是不是对的。

这步很重要——AI 写文档容易"编"，有验证才可信。

architecture-map：可交互的架构图

审计完了，数据有了，这个 Skill 把它转成一个可交互的 HTML 页面。打开浏览器，你会看到一堆卡片，每个卡片是一个模块，卡片之间有箭头表示数据流。点任意一张卡片，能看到它接收什么、做什么、输出什么。

这个文件放在你项目里，file:// 直接打开，不需要服务器，不装任何依赖。下次代码改了，重新跑一遍 map，它会合并新数据但保留你之前加的笔记和标注。

architecture-cleanup：找出能删的

有了架构图之后，这个 Skill 做的事情很明确：找出你项目里可以安全删除的东西。

它分 7 类：

类别	例子
死函数	孤立节点 + grep 零引用
未用的端点/路由	没人调的 API
过期的数据流	目标模块已经不存在的边
未引用的文件/模块	没人 import 的文件
过期的配置/Feature Flag	没被读取的配置项
从未构建的 Proposed 节点	还是 proposed 状态、从未上线
重复/已被取代的节点	多个节点引用同一组文件

每个发现会标上置信度：🔴 确定能删、🟡 你自己判断、⚫ 纯猜测（不展示）。

关键设计：它默认只标注，不动代码。你确认了之后，它才会走分支 + PR 的流程去删。这个安全感拉满了。

architecture-improve：改进提案

跟 cleanup 是一对。cleanup 找能删的，improve 找能改的。

它用两个"镜头"扫描：

• 🏗️ 结构镜头：耦合、God Node（扇入扇出都很大的节点）、重复子系统、分层违规
• 🔀 管线镜头：冗余跳转、可以并行的串行步骤、缺少重试/幂等、数据用临时 URL 存而不是重新托管

每个提案会分成四档：

档位	条件
⚡ quick win	高影响 + 小工作量
🎯 big bet	高影响 + 中/大工作量
🧹 fill-in	其他
⛔ skip	低影响 + 大工作量（展示出来，但建议别做）

同样，它只提案不改代码。所有提案会画成虚线节点加到架构图上，你在浏览器里就能看到"如果改了会是什么样"。

第二批：评分报告 + 坏味道深挖

arch-review：6 维度评分

来自 alonsoscuriel-max/arch-review。

跟 architecture 四件套的"全景扫描 + 交互地图"不同，arch-review 走的是评分制。它把项目拆成 6 个维度，每个维度打 1-10 分：

维度	看什么
Code Organization	目录结构、关注点分离、God File、命名
Dependency Health	过期包、重复依赖、dev/prod 不匹配
Test Coverage	测试存在性、类型分布、关键路径覆盖
Error Handling	全局异常处理、类型化错误、日志、信息泄露
Performance	N+1 查询、分页、缓存、阻塞操作
Developer Experience	上手难度、.env.example、README、CI 配置

最终输出一份报告，分三层：

• Critical（最多 3 个）：下次发版前必须修的
• High Impact（最多 5 个）：下个冲刺排进去的
• Quick Wins（最多 5 个）：这周就能搞定的

每个发现都有证据（具体文件和行号）、影响说明、修复建议和工作量估算。

它的设计哲学很对我胃口——“Be opinionated”。不给你列一堆选项让你自己选，而是直接告诉你"你应该这么做"，然后解释为什么。

smell：50+ 种代码坏味道检测

来自 smallnest/goal-workflow。

这个是最"学术"的一个，知识库直接来自 Martin Fowler 和 Kent Beck 的经典代码坏味道分类（refactoring.guru 那套），加上算法复杂度热点检测。

覆盖 8 大类、50+ 种 smell：

类别	典型 smell
架构	Big Ball of Mud、分布式单体、贫血领域模型、过度分层、过度抽象
耦合	循环依赖、内容耦合、公共耦合、消息链、中间人
内聚	God Object、散弹手术（改一个功能要动 5 个文件）、特性依恋、发散式变化
设计	SOLID 违反、静态依赖、泄露的抽象、投机性泛化
代码	长方法、长参数列表、重复代码、魔法数字、死代码
测试	没测试、测试耦合实现、慢测试
命名	模糊命名（Manager、Handler、Util 满天飞）、命名不一致
复杂度	嵌套循环 O(n²)、N+1 查询、循环内排序、错误数据结构选择

复杂度检测那块特别实用。比如它能发现你代码里有 includes() 在循环里调用——这是 O(n*m)，应该换成 Set 的 O(n+m)。或者 fetch() 在循环里发请求——典型的 N+1 问题。

输出是完整的 Markdown 报告，包含模块健康评分卡、smell 分布统计表、重构路线图（立即 / 短期 / 长期）。

6 个 Skill 怎么选？

一张表说清楚：

	架构全景	死代码清理	改进提案	评分制	坏味道检测	复杂度分析
architecture-audit	✅	-	-	-	-	-
architecture-map	✅	-	-	-	-	-
architecture-cleanup	-	✅	-	-	-	-
architecture-improve	-	-	✅	-	-	-
arch-review	✅	-	✅	✅	-	-
smell	-	-	-	-	✅	✅

简单来说：

• 想要交互式架构地图，能点来点去看数据流 → architecture 四件套
• 想要一份评分报告 + 路线图，快速知道该先干嘛 → arch-review
• 想要深度扫描代码坏味道和算法复杂度 → smell

三个来源互不冲突，可以全装。

安装实录

下载

三个仓库都克隆下来：

git clone --depth 1 https://github.com/MartinPLarsen/claude-architecture-skills.git
git clone --depth 1 https://github.com/alonsoscuriel-max/arch-review.git
git clone --depth 1 https://github.com/smallnest/goal-workflow.git

复制到 ~/.claude/skills/

# 架构四件套
cp -R claude-architecture-skills/architecture-audit/* ~/.claude/skills/architecture-audit/
cp -R claude-architecture-skills/architecture-map/* ~/.claude/skills/architecture-map/
cp -R claude-architecture-skills/architecture-cleanup/* ~/.claude/skills/architecture-cleanup/
cp -R claude-architecture-skills/architecture-improve/* ~/.claude/skills/architecture-improve/

# arch-review
cp arch-review/SKILL.md ~/.claude/skills/arch-review/
cp -R arch-review/references/* ~/.claude/skills/arch-review/references/

# smell
cp -R goal-workflow/skills/smell/* ~/.claude/skills/smell/

踩坑：权限拦截

第一次复制的时候被 Claude Code 的权限系统拦了。原因是：~/.claude/skills/ 是 Claude 读取指令的地方，从外部仓库直接复制代码进去，系统会认为是"不受信任的代码集成"。

解决办法：先读 SKILL.md 确认内容没问题，再手动执行复制命令。如果你也遇到这个问题，可以在 Claude Code 里用 ! 前缀执行命令，或者自己开终端跑。

验证

装完之后确认文件到位：

ls ~/.claude/skills/architecture-*/SKILL.md ~/.claude/skills/arch-review/SKILL.md ~/.claude/skills/smell/SKILL.md

重启 Claude Code，就能用了。

我的使用建议

先跑 /arch-review 拿全景评分，知道项目整体健康度多少分、哪些维度最拉胯。然后根据评分结果选择下一步：

• 评分里"Code Organization"分数低 → 跑 /architecture-audit 出全景架构图，再用 /architecture-cleanup 找死代码
• 评分里"Performance"分数低 → 跑 /smell，重点看复杂度那一类
• 想规划重构 → 架构图出来之后跑 /architecture-improve，看它给的提案

/arch-review  →  看评分  →  针对性地跑 smell 或 architecture-*  →  清理 + 改进

后话

搜 Skill 这件事本身挺有意思的。GitHub 上 Claude Code 的 Skill 生态已经很庞大了——光"claude code skills"相关的仓库就有几百个，alirezarezvani/claude-skills 那个仓库甚至打包了 362 个 Skill、24000 多个 Star。但大部分是代码审查、PR 评审、commit message 生成这类"单文件级别"的工具。

真正能做到项目级分析的不多。我找到的这 6 个，算是各有侧重、互相补充的一套组合。装上之后，至少在"这个项目架构到底行不行"这个问题上，有了一个可以依赖的工具链。

不再靠猜了。