# 代码库架构改进 (improve-codebase-architecture)

> 扫描代码库中可将浅模块变为深模块的重构机会，生成可视化 HTML 报告，再就选中的一项逐步追问讨论。

- 分类: [架构调优](https://www.myskills.tools/zh/categories/architecture-tuning/)
- 来源: 社区 · Matt Pocock
- 代码仓库: https://github.com/mattpocock/skills/tree/main/skills/engineering/improve-codebase-architecture (commit 7739eae)
- SKILL.md: https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md
- 安装命令: `npx skills add mattpocock/skills --skill improve-codebase-architecture`
- 许可证: MIT
- 兼容工具: Claude Code, Codex, Copilot, Gemini CLI
- 权限: read-repo ✓, write-files ✓, shell ✓, network ✗
- 状态: 扫描通过
- 规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。

## 核心规则

先划定范围再扫描：优先关注最近频繁改动的部分，而不是全盘重构。

## 执行阶段

1. **确定范围** — 采用用户指定的方向；否则用 git log 找出热点文件，并先读 GLOSSARY.md 和相关 ADR。
2. **探索摩擦点** — 派出子代理遍历代码，寻找浅模块、缺乏局部性和接缝泄漏之处，并用删除测试判断。
3. **生成 HTML 报告** — 在系统临时目录写入自包含 HTML 报告，每个候选附前后对比图和推荐强度，并给出首选建议。
4. **追问选中方案** — 用户选定后逐项讨论约束、依赖和深化后的模块形态，同时更新 GLOSSARY.md，必要时提议记录 ADR。

## 权限说明（据 SKILL.md 整理）

| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 部分需要 | 仅写入临时目录中的 HTML 报告，以及 GLOSSARY.md 和 docs/adr/ 下的 ADR；不改动业务代码。 |
| 命令执行 | 部分需要 | 运行 git log 查看提交历史，并用 open、xdg-open 或 start 打开报告。 |
| 网络外发 | 不需要 | 技能本身不调用网络；生成的报告在浏览器中打开时会从 CDN 加载 Tailwind 和 Mermaid。 |

## SKILL.md 头部信息（YAML）

```yaml
---
name: improve-codebase-architecture
description: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
disable-model-invocation: true
---
```

首页: https://www.myskills.tools/zh/ · URL: https://www.myskills.tools/zh/skills/improve-codebase-architecture/