Improve Codebase Architecture
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
概览
The Improve Codebase Architecture skill, found within the mxyhi/ok-skills repository, enables AI agents to evaluate software structures for technical debt and design inconsistencies. By synthesizing information from domain-specific documentation in CONTEXT.md and historical architectural decision records in the docs/adr/ folder, the skill identifies specific areas for refactoring. It is particularly effective for consolidating tightly-coupled modules and improving the overall testability of a project. This tool helps ensure that codebases remain navigable for both developers and AI models. Part of a repository with 423 stars, this skill supports various agents including Claude, Cursor, and Codex, focusing on aligning implementation with established project standards.
使用场景
安装说明
# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/improve-codebase-architecture/SKILL.mdCopy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.
安全提示
This skill requires read access to project documentation and architectural records to provide informed recommendations. Users should verify that CONTEXT.md and ADR files do not contain sensitive information or hardcoded credentials. The skill's functionality is limited to codebase analysis and does not specify additional external execution permissions.
相关 Skills
Skill Creator
anthropics/skills
创建新技能、修改和改进现有技能,并衡量技能性能。适用于用户希望从零开始创建技能、编辑或优化现有技能、运行评估以测试技能、通过方差分析对技能性能进行基准测试,或优化技能描述以提高触发准确性的场景。
Windows Builder
hashicorp/agent-skills
使用 Packer、WinRM 通信器和 PowerShell 配置程序构建 Windows 镜像。适用于创建 Windows AMIs、Azure 镜像或 VMware 模板。