用途:以“刚入职的合格工程师”视角审查代码,找出理解代码所必需、但代码中未提供的信息,并产出文档待办清单。适用于需要评估新人上手难度、补充项目文档的场景。
主要能力:阅读 diff 或文件,标记每一处需要额外信息才能理解的地方,并按四类归因:设计理由(为何选此算法/数据结构/模式而非更显而易见的替代方案)、领域知识(项目专有术语含义、驱动此处的业务规则)、历史背景(TODO/变通做法背后的原因、为何避免某方案)、系统约束(超时/限制/阈值来源及失败模式)。随后按上手风险排序,给出最需要文档化的前三个缺口,并列出具体可快速修复项(注释、命名、常量、文档链接),最后用一行说明代码中可理解的部分。
使用方式:将 diff 或文件交给该技能,按输出契约得到分组结果。输出以 Context gaps 开头,按文件/组件分组并按上手风险排序,每条注明类别,附 Critical for documentation 前三条与 Quick wins。语气为好奇的同事提问,如“是什么约束让 X 在这里成为必要?”“Y 是基于测量还是估计?”。
边界:假定读者掌握语言语义、常见算法与行业标准模式;不假定其了解为何采用此方案、项目术语、过往尝试、隐含需求与领域概念。不标记标准语言/框架用法、常见行业模式、可从紧邻代码推断的内容及风格偏好。
限制:资料未提供安装命令、平台支持、收费方式与具体使用步骤,暂未提供。