关于 architecture-review
architecture-review 是面向开发者的项目结构审查与改进技能。它强调先梳理依赖和边界，再制定分阶段重构计划，并通过测试逐步验证。
主要功能
- 01梳理目录结构与依赖
- 02识别循环依赖和过大模块
- 03按严重程度分类问题
- 04制定经测试验证的分阶段重构计划
- 05提供结构与依赖管理参考
适用场景
- 01评估陌生代码库
- 02排查模块边界和依赖问题
- 03规划渐进式结构调整
- 04清理死代码并整合模块
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/architecture-review确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/analysis-techniques.mdanti-rationalization.mdcleanup-strategies.mddependency-management.mdrefactoring-patterns.mdstructural-patterns.md详细介绍
架构审查
分析、审计并改进项目结构。
核心原则
- 先衡量再更改 — 绘制结构图并找出具体问题，然后再提出更改方案
- 边界清晰 — 分离各层（UI、逻辑、数据），并保持依赖方向一致
- 就近组织 — 将相关代码放在一起，让功能易于查找、更改和删除
- 渐进式迁移 — 分阶段重构，并通过测试验证每一步
快速评估
- 不存在循环依赖
- 目录命名和分组一致（按功能或按类型）
- 每个文件/模块职责单一，文件大小合理（<500 行）
- 隔离外部依赖，并妥善提取共享代码
- 新开发者可以轻松浏览并找到任何功能的代码
快速入门清单
- 梳理当前结构：目录树、依赖关系图、模块边界
- 找出问题：循环依赖、上帝模块、泄漏的抽象、嵌套过深
- 按严重程度分类：严重（阻碍开发）、高（增加维护负担）、中/低（造成不便）
- 提出目标结构及迁移计划
- 逐步执行，并在每次调整后通过测试验证
参考资料
| 参考资料 | 描述 |
|---|---|
| analysis-techniques.md | 依赖关系图、复杂度指标、代码分析 |
| refactoring-patterns.md | 安全的重构技术、迁移策略 |
| structural-patterns.md | 不同项目类型的目录结构 |
| dependency-management.md | 循环依赖、耦合、模块边界 |
| cleanup-strategies.md | 删除无用代码、整合、命名约定 |
| anti-rationalization.md | 铁律、常见的自我合理化、用于维护架构纪律的危险信号 STOP 清单 |
评论
支持 Markdown