# Improve Codebase Architecture

> 架构深挖

- Skill: `haohao-end/improve-codebase-architecture` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add haohao-end/improve-codebase-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haohao-end/improve-codebase-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Haohao-end (https://skillmd.com/u/haohao-end)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/haohao-end/improve-codebase-architecture

---

# 架构深挖

这是一个帮助识别架构摩擦并提出深挖机会的技能。

## 适用场景

- 用户想改进架构
- 用户想找重构机会
- 用户想让代码库更可测、更容易让 Agent 理解

## 工作方式

1. 先读项目的领域词汇和 ADR。
2. 观察哪里需要在很多小模块之间来回跳。
3. 识别浅模块、紧耦合和缺少局部性的地方。
4. 用删除测试判断一个模块是不是只是复杂度搬运工。
5. 给出能沉淀复杂度的深模块建议。

## 约束

- 不要用“组件”“服务”这种泛词替代领域词汇。
- 不要在没有证据时重提旧决策。
- 关注测试性和局部性，而不是单纯拆文件。