SuperAPI AI 工具集

codebase-vision-report

设计与创作

查看项目

更新于 10-15 19:56

技能介绍

用途:把整个代码库(本地目录或远程 Git URL)通过 gitoutput 的 --images 模式渲染成尽量少的密集 PNG 页面,逐页读取后生成基于实际内容的报告。

主要能力:调用方式为 /codebase-vision-report <target> :: <prompt>,或 Skill(skill="codebase-vision-report", args="<target> :: <prompt>")。target 为本地路径或远程 Git URL;prompt 为报告焦点,缺省时使用“总结该代码库的架构与关键组件”。参数按第一个 :: 分割。可选尾部标志:--image-profile <claude|gpt|gemini|grok>(默认 claude)、--exclude-pattern <glob> 与 --include-pattern <glob>(可重复,用于限定大代码库范围)。

使用方式:第一步用 npx 运行 gitoutput,命令为 npx github:AnEntrypoint/gitoutput "<target>" --images --json --output "./codebase-vision-<slug>-<suffix>",并解析 stdout 的 JSON(含 outDir、pageFiles、factsheetFile、manifestFile、pageCount、truncated)。生成失败则直接报告错误,不继续。pageCount 为 0 时报告“无可分析内容”。truncated 为 true 时须在报告中说明仅覆盖前 N 页。第二步按顺序用 Read 工具读取 pageFiles 中的 PNG,页数较多时分批读取并记录每批覆盖内容;factsheetFile 非空时也读取,用于核对哈希、UUID、URL、数字 ID 等精确值。第三步撰写报告,写入 <outDir>/report.md 并在回复中呈现,保留 outDir 供用户复查。

适用场景:需要从整体视角理解代码库架构、查找安全问题、检查某功能实现是否正确等。

限制:依赖 gitoutput 与可读取图像的 Claude Code 会话;大代码库可能因页面预算被截断,需用包含/排除模式缩小范围;精确值须以 factsheet 为准,不能凭页面图像猜测。