文件总结
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_56e2a655/file-summarizer。
技能介绍
要解决什么问题
仓库里常有单文件过长、类型各异的情况:论文 PDF 转文本、几千行的服务代码、config.yaml 或内部 Markdown。你只想知道「核心逻辑是什么」「有哪些关键配置」,而不是自己从头扫一遍。本技能在用户明确提出总结、提炼要点或 TL;DR 某文件时介入,把阅读与归纳收敛成一次对话里的结构化输出。
工作方式
- 锁定目标文件 — 若未指定路径,会先向你确认。
- 用 read 工具读取 — 体积很大时先读首段,再询问是否继续。
- 按文件类型组织摘要,例如:
- 代码:import、类型定义、主流程、导出面
- 配置:值得关注的键值,略去模板化占位
- Markdown / 文档:保留标题层级,必要时指向章节
- 直接在对话中输出 — 默认不写磁盘;只有你要求保存时才落文件。
适用边界
- 超过约 100KB 的大文件会分块总结,需要你配合决定是否继续读后续块。
- 它做的是单文件理解与摘要,不是跨目录架构审计或批量对比。
- 触发依赖自然语言意图(如「帮我总结这个文件」「TL;DR 这篇论文」),不会替你在未说明目标时自动扫全项目。
使用场景
- 接手他人遗留的单体代码文件,需要在改 bug 前先弄清 import 链路与主流程
- 打开体积超过 100KB 的日志或导出文本,只想先读首段再决定是否继续深挖
- 新环境里的 config.yaml 键值众多,需要快速标出与当前部署相关的非模板项
- 论文或长 Markdown 文档已落盘,想按章节结构拿到要点而不逐段通读
适合人员
- 刚 clone 仓库、需要快速理解某个核心 `.py` 或 `.ts` 文件导出与主逻辑的维护工程师
- 负责排查线上问题时要把巨大单文件日志先压缩成可讨论要点的 SRE
- 写技术方案前需要把内部规范 Markdown 的标题与章节要点摘进评审材料的文档作者
- 读论文或技术报告本地副本、用 TL;DR 确认是否值得精读的研发生态成员