用途
Explain Codebase 用于解释陌生的代码库区域,帮助使用者理解某块代码是如何组合运作的。它的定位是只读(read-only),即在不改动代码的前提下完成对目标代码区域的映射与说明。
主要能力
该技能围绕一个代码区域,梳理并呈现以下内容:
- 目的(Purpose)
- 入口点和关键模块
- 调用方、数据流与控制流
- 相关测试或检查
- 重要术语
- 未知项或假设
使用方式
按照资料描述,其处理过程大致为:
- 阅读仓库说明以及相关的当前文档、术语表(Glossary)或 ADR。
- 当用户未指定范围时,推断出最小且有用的范围。
- 检查入口点、关键模块、调用方、测试以及重要的数据/控制流。
- 在使用历史记录之前先阅读相关 ADR;仅在用户要求,或当前证据无法解释某个重要设计选择时,才去检查有针对性的历史记录。
- 按用户的理解水平解释归属关系与流程,并区分已核实证据、推断和未知项。
输出倾向于采用紧凑的结构,即上文列出的“目的 / 入口点和关键模块 / 调用方、数据与控制流 / 相关测试或检查 / 重要术语 / 未知项或假设”。同时使用聚焦的文件引用,而不是罗列搜索结果。
适用场景
适合需要快速理解一块不熟悉代码区域的场景,例如了解其目的、入口、模块关系、调用与数据流向、相关测试以及关键术语时。
限制
- 只读;除非用户切换到其他工作流,否则不进行编辑、诊断、审查或重构。
- 如果证据中显示出可能的 bug 或架构摩擦,只会简要提示,并建议将 diagnose-issue 或 improve-architecture 作为单独的下一步。
- 关于收费、价格、平台支持范围等信息,资料中暂未提供。