一个Claude Code技能,可扫描你的代码库寻找架构深化机会(增量感知、仅分析),并将其整理为可直接使用的议题

Reddit r/AI_Agents 工具

摘要

一个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作为禁止列表)。
查看原文

相似文章

alirezarezvani/claude-skills

GitHub Trending (daily)

一个全面的开源库,包含354个生产级Claude Code技能和代理插件,适用于13款AI编码工具,涵盖工程、DevOps、营销、安全、合规等领域。

Claude Code 在大型代码库中的工作原理

Hacker News Top

Anthropic 的博文详细介绍了在大型复杂代码库中使用 Claude Code 的最佳实践,阐述了代理搜索以及如 CLAUDE.md 文件等扩展的“利用”如何在大规模下提升导航和性能。

multica-ai/andrej-karpathy-skills

GitHub Trending (daily)

一个单独的 CLAUDE.md 文件,实现了四项原则,以改进 Claude Code 的编码行为,源自 Andrej Karpathy 对 LLM 编码陷阱的观察。