SuperAPI AI 工具集

cheez-read

编程与开发

查看项目

更新于 10-16 03:16

技能介绍

用途:cheez-read 负责按读取形态选择后端来读取和列出源代码,优先使用代码智能后端而非基础工具,以便获得纯文本读取无法提供的结构信息(大纲、锚点、符号表、token 预算)。

主要能力:tilth MCP 支持文件/范围读取、仓库感知列表、结构化大纲、token 估算与编辑锚点,相关调用有 tilth_read、tilth_list,重构前用 tilth_deps;LSP 支持符号表、定义、悬停或类型形态读取;原生有界读取/列表作为回退,仅在没有代码智能后端覆盖该形态且 harness 提供新鲜内容与行/快照上下文时使用。

使用方式:小文件返回完整内容与头部,大文件自动返回结构大纲;用 #symbol_name 按符号名读取行范围;mode:stripped 返回移除普通注释和调试日志的全文,用于编辑前勘察结构,但不带编辑标签、无法回写;读取行范围会输出 [path#TAG] 头部与编号行,把 4 位十六进制 TAG 原样复制到 cheez-write 的 tag 中即可绑定编辑。目录列表用仓库感知后端,如 tilth_list(patterns:["**/*.ts"], scope:"src/"),输出带 token 估算。

适用场景:已跟踪、可解析语言中的源代码文件,尤其是后续可能需要符号导航、编辑锚点或 cheez-write 编辑的文件;多仓库读取需由调用方按仓库路由后进入。

限制:不要用 cat、head、tail、less、more、bat 查看代码,不要用 ls、tree、eza、find、fd 枚举代码文件,也不要在代码路径上用普通 Read/Glob,除非它是 harness 原生且新鲜度感知的后端;不要重复读取已展示的文件;不用于运行代码或测试,也不用于提交或发布;后端须限定在当前仓库且磁盘内容新鲜,不用于同级 worktree、系统路径或依赖缓存,除非后端明确支持;不要臆造 tag,漂移的写入会被三方合并或安全拒绝。