Skill822 repo starsupdated 5d ago

improve-codebase-architecture

This Claude Code skill analyzes codebases to identify architectural friction points and opportunities for deep refactoring. It examines domain vocabulary and architectural decision records, then flags shallow modules, tight coupling, and poor locality by testing module dependencies. Use this skill when seeking to improve code testability, reduce cognitive load for AI agents, or consolidate complexity into well-defined modules rather than distributing it across shallow components.

View source Repository: openagent

Install in Claude Code

Copy

git clone --depth 1 https://github.com/Haohao-end/openagent /tmp/improve-codebase-architecture && cp -r /tmp/improve-codebase-architecture/api/internal/core/skills/catalog/improve-codebase-architecture ~/.claude/skills/improve-codebase-architecture

Then start a new Claude Code session; the skill loads automatically.

Definition

skill.md

# 架构深挖

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

## 适用场景

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

## 工作方式

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

## 约束

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