improve-codebase-architecturecommit 7739eaeSKILL.md · 架构调优

代码库架构改进

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

npx skills add mattpocock/skills --skill improve-codebase-architecture

权限: read-repo
write-files
shell
network
兼容工具: Claude Code, Codex, Copilot, Gemini CLI
GitHub: 308.7k
来源: 社区 · Matt Pocock
状态: 扫描通过
许可证: MIT
分类: 架构调优
代码仓库: github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture

核心规则

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

执行阶段

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

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

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

SKILL.md 头部信息（YAML）commit 7739eae

---
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
---

核心规则

执行阶段

阶段 01确定范围

阶段 02探索摩擦点

阶段 03生成 HTML 报告

阶段 04追问选中方案

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

SKILL.md 头部信息（YAML）

相关技能