一个Claude Code技能,可扫描你的代码库寻找架构深化机会(增量感知、仅分析),并将其整理为可直接使用的议题
摘要
一个Claude Code技能,可自主扫描代码库寻找架构改进机会(如浅层模块),创建增量感知、仅分析的议题和PRD,随时可实施。
我一直在自己的仓库里反复执行同样的手动仪式:通读一个子系统,寻找浅层传递模块,应用*删除测试*("如果我删除了这个,复杂性会消失还是分布在N个调用者之间?"),然后将重构写成一个独立的任务单。这是来自Ousterhout的《软件设计哲学》和Matt Pocock的`improve-codebase-architecture`技能的方法论——但手动在整个代码库中执行既繁琐又容易半途而废。所以我把它变成了一个Claude Code技能,驱动**ralph**自主循环来为我完成。你运行`/ralph-architecture-sweep`,它就会:* 询问**范围**——整个仓库或选定的子系统/包/目录 * 从你的**远程默认分支**分出一个`ralph/*`工作树(这样它能看到已发布的重构,不会重新发现它们——它是**增量感知**的) * 扫描深化候选者,**仅分析**,每个区域一个子代理 * 编写**垂直切片议题**(深度模块 + 每个调用点重新指向 + 新接口的测试 + 删除旧副本 = 一个独立可领取的任务单),以及每个区域的PRD放在`.scratch/`下。不会推送任何内容——你在合并或实施之前审查这些议题。也可以选择链式调用ralph来实际实施它们。一个让我满意的设计细节:无头ralph只在*迭代结束时*提交,所以长时间的分析调用如果中断会丢失一切。这个技能通过短子代理驱动扫描,因此对此很健壮。安装只需要在你的项目根目录下运行`npx ralph-architecture-sweep`(或`--global`)。MIT许可。好奇是否有人正在自动化重构的*分析*方面而不是实施——以及你如何防止代理重新提出你已经做出的决策(我使用ADR作为禁止列表)。
相似文章
@seelffff:来自Synergetic Solutions的一位首席顾问刚刚发布了一个仓库,改变了Claude Code的工作方式。claude-skill…
Synergetic Solutions的一位首席顾问发布了claude-skills,这是一个包含66项针对Claude Code的专业技能的仓库,可通过一条命令安装,通过上下文感知激活、参考文件和工作流程集成,增强了其全栈开发能力。
一种用于刻意技能培养的Claude Code和Codex技能
一种Claude Code和Codex技能,将基于证据的学习练习融入开发工作流程,通过间隔重复和检索练习等技术帮助开发人员在编码时建立专业知识。
alirezarezvani/claude-skills
一个全面的开源库,包含354个生产级Claude Code技能和代理插件,适用于13款AI编码工具,涵盖工程、DevOps、营销、安全、合规等领域。
Claude Code 在大型代码库中的工作原理
Anthropic 的博文详细介绍了在大型复杂代码库中使用 Claude Code 的最佳实践,阐述了代理搜索以及如 CLAUDE.md 文件等扩展的“利用”如何在大规模下提升导航和性能。
multica-ai/andrej-karpathy-skills
一个单独的 CLAUDE.md 文件,实现了四项原则,以改进 Claude Code 的编码行为,源自 Andrej Karpathy 对 LLM 编码陷阱的观察。