SuperAPI AI 工具集

geeklens

通用与其它

查看项目

更新于 10-16 08:43

技能介绍

用途:geekLens(聚焦代码阅读版)面向“想读透某段实现”的人,给一段聚焦的真实源码产出能直接顺读的注解版:清掉打断顺读的噪声、只留核心逻辑,讲清“这段在做什么、为什么这样写、和谁同步”。它适合用户提出“给这段代码加注解/出阅读版/逐行讲解/精读某条路径/改前改后对照/整理数据结构”等请求,前提是有一个明确焦点(一个功能、一次改动、一条数据流或调用链),而不是注解整个仓库。

主要能力与产物形态:产出 .annotated.<ext> 阅读版文件,每个文件顶部固定写来源(原路径、commit、快照日期)、角色、关系、改动;注解约定包括行尾一句话解释、上方 // ▶ 成段解释、删减处留占位、长函数分步编号。另产出 data-structures.md 数据手册(定义、字段语义、所有权与生命周期、同步、放置、诊断字段、角色对照表)与端到端路径文档,并建立交叉链接。

使用方式与工作流:先界定焦点与边界,读源码建“改动清单”和“结构清单”,先建目录骨架与顶层 README,再逐个产出阅读版,抽数据手册、写路径文档、交叉链接与校验,最后记 project-memory。目录放在 ./tmp/annotated/<focus-slug>/,无 project-memory 时退化为 ./annotated/<focus-slug>/ 并自建 CHANGELOG.md。触发时需启用 calm-explain 作为讲解协议,前者负责解释风格,geekLens 负责产物形态。

限制:源码只读,阅读版是副本、会随时间漂移;必须在阅读版中标注来源与快照日期。不做纯 diff,不静默删除代码,不凭感觉报结构体大小。若资料未提供具体收费、平台与安装命令等信息,暂未提供。