30 秒看懂
它能做什么，以及什么时候值得选
Improve Codebase Architecture 用于发现架构摩擦，并提出接口更小、实现更深的模块方案。上游流程从明确痛点或近期修改热点出发，读取领域上下文和 ADR，比较不同接口设计，只记录有依据的重构建议，而不是把所有大文件都视为问题。
按 Agent 安装
选择你的 Agent
路径来自 Agent 官方文档或 skills.sh 同源通用安装器。兼容状态仍以这个 Skill 的资料为准。
项目范围
.claude/skills/improve-codebase-architecture/个人范围
~/.claude/skills/improve-codebase-architecture/项目范围适合团队共享；个人范围适合跨项目复用。安装器默认项目范围，加 -g 可改为个人范围。
安装命令（项目范围）
npx skills add mattpocock/skills --skill improve-codebase-architecture --agent claude-code典型工作流
从任务到结果的典型流程
01
发现架构摩擦
检查高频修改区域中的浅模块、耦合与薄弱测试接缝。
02
比较接口
生成明显不同的模块接口并评估其杠杆效应。
03
编写 RFC
记录问题、权衡与建议重构方案供团队评审。
优点与局限
优点与使用边界
显著优点
- 本页已依据当前上游 SKILL.md 的具体工作流进行人工整理。
- 能力边界与来源 mattpocock/skills 保持明确关联。
- 核心用途、局限与风险分开呈现，便于安装前判断。
潜在缺点与局限
- 架构判断依赖变更历史与领域上下文，而这些信息可能不完整。
- 该 Skill 提出重构建议，但不能证明迁移成本一定合理。
适合人群
适合哪些人
→
持续演进代码库的维护者
→
改善可测试性与模块边界的团队
使用前须知
使用前需要检查的风险
中
过早重构
更整洁的接口仍可能是不合适的投入，应先验证热点与预期变化再安排实施。
中
上游指令变化
Skill 行为可能随仓库更新而变化；重要工作流应记录所用提交，并在更新后重新审查。
安全说明
如何理解它的权限
- 声明权限仍以当前上游 SKILL.md 和运行时请求为准。
- 仓库文件、网页内容与工具输出都应视为不可信输入。
- SkillSignal 未独立执行或安全审计该软件包；skills.sh 外部标签不构成 SkillSignal 认证。
这不是安全认证。 第三方评级仅作为标注来源的参考信息展示；SkillSignal 尚未独立执行或安全审查此 Skill。
软件包内容
已收录文件
SKILL.md上游 Skill 说明来源可查
标签
架构重构可测试性
人工扩展资料，依据 mattpocock/skills 的当前上游 SKILL.md 与标注来源整理，核对日期 2026-08-19。本文为原创摘要，不代表已执行或安全认证。