前言¶
代码库跑了半年到两年,通常会进入一种状态:改动没有停,但没人说得清哪里改得多、哪里几乎没人碰、哪个模块是事实上的关键路径。靠翻目录和 git log 心里有数,但这种判断很难传承,也很难在评审时拿出来讨论。
架构深化这个 Skill 面向的是另一个问题:不是从零设计架构,而是在已有代码上找可以「深化」的点——把模糊的地方变明确,把隐式约定写成显式约束。它的做法是先扫描代码库,再产出一份可视化 HTML 报告,然后对报告里选定的项逐条追问。下面介绍它的实际能力边界和启用方式。
这是什么¶
一句话定位:扫描代码库寻找架构深化机会,生成可视化 HTML 报告,并对选定项展开拷问。
- 名称:架构深化
- 坐标:
@kunlungrowth/improve-codebase-architecture - 版本:1.0.0
- 来源归属:enterprise
- 发布者:昆仑增长
- 分类:dev-programming
- 标签:
requires_api_key=false - 官方地址:https://www.skillhub.cn/skills/kunlungrowth/improve-codebase-architecture
需要 API Key 吗?不需要。标签里明确写了 requires_api_key=false,这是它和一类依赖外部模型服务的 Skill 的差别,本地跑不涉及密钥配置。
核心能力¶
资料里给出的能力是两条,没有更多:
- 扫描代码库,找出「深化」机会。
- 产出可视化 HTML 报告,并对选定项拷问。
「深化机会」在官方简介里没有逐项定义。从名称和流程推断,它指向的是让现有结构更明确的方向,例如分层边界、模块职责、隐式依赖方向。具体命中哪些项,需要实际跑一遍才能确认,这里不替它预设清单。
输出形态是 HTML,不是终端里的一段文字。这点值得先说明:报告要打开浏览器看,意味着它面向的是需要拿给人看、需要在评审会上讨论的场景,而不是只想快速过一眼结论的场景。
「拷问选定项」是流程的后半段。报告给出候选之后,可以就其中某一项继续追问。追问的具体形式,资料未展开。
安装与启用¶
官方资料没有给出安装命令、目录约定或配置字段。可以确认的只有坐标和页面:
坐标: @kunlungrowth/improve-codebase-architecture
页面: https://www.skillhub.cn/skills/kunlungrowth/improve-codebase-architecture
版本: 1.0.0
这类 Skill 基于通用 SKILL.md 格式,通常放入对应 Agent 的 skills 目录后即可被识别。但具体路径、是否要在配置文件里注册、Cursor 与 Claude Code 的目录差异,本资料没有覆盖,不在这里编造。启用方式请以官方页面为准。
有一个数据值得留意:截至资料抓取时,下载量 1216,安装量 0。安装量为 0 意味着还没有人真正把它接进自己的环境,遇到问题时难以在社区找到现成的排查记录。
典型用法¶
资料没有提供可复现的官方示例,以下流程按简介描述的三步给出,供实际使用时参考:
- 在 Agent 里发起扫描,输入目标代码库路径。这一步做的是全库扫描,产出候选深化点。
- 打开生成的 HTML 报告,浏览可视化结果。
- 选定其中一项,继续追问,直到得到明确结论。
命令行层面的具体写法,资料未提供,这里不虚构。
适用场景与注意¶
适合的场景:
- 代码库已经有一定规模,架构靠口头约定维持,需要把约束显性化。
- 有评审或交接需求,需要一份能打开浏览器讨论的产出物。
- 不想从零做架构设计,只想在现有结构上找改进点。
不适合的场景:
- 空仓库或只有少量文件的项目,扫描没有足够信息可挖。
- 需要精确到函数级调用链分析的场景,资料未说明它能做到这个粒度。
需要注意的点:
- 它的产出是一份报告加后续追问,不是自动改代码。深化之后的实际重构仍要人工完成。
- 评分显示为 100000(资料抓取时数据),下载量 1216,安装量 0。样本量很小,评分参考价值有限。
- 抓取时间点为 2026-11-04,上述数字可能已经变化。
结尾¶
架构深化做的事情不复杂:把代码库里「说不清楚为什么这样分层」的地方找出来,摊成 HTML,然后逐条追问到能落地为止。它的价值在于产出的形态——一份能拿去讨论的东西,而不是一次改完就消失的代码改动。
官方地址:https://www.skillhub.cn/skills/kunlungrowth/improve-codebase-architecture