SuperAPI AI 工具集

scan-todos

通用与其它

查看项目

更新于 10-16 00:24

技能介绍

用途:扫描代码库源码注释(而非工单系统条目)中的可执行标记,如 TODO/FIXME/HACK/XXX,并对每个标记进行解决、登记或清理。资料指出,新工作并不推荐依赖此流程,持久工作应在编写时进入工单系统;消费方仓库更适合用提交时的卫生门禁(linter 或 git hook)来捕获新违规。

用法:/work-items:scan-todos [--path <dir>] [--work]。--path <dir> 将扫描限制到特定目录(默认仓库根);--work 在展示分组后自动选择最小分组并开始处理。

检测:若消费方仓库已有注释卫生工具(共享模式库、lint lane),以其为检测依据;否则直接扫描被跟踪文件,例如:git -C "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}" grep -nE '\b(TODO|FIXME|HACK|XXX)\b' -- ':!.min.' ':!node_modules' | tr -d '\r'。带 --path 时以根相对路径形式加入并保留排除项。

可操作范围:裸 TODO/FIXME/HACK/XXX 标记,以及内部工单溯源注释(如 item #N 面包屑)。跳过:外部上游引用(org/repo#issue)、工作笔记文件中的结构化任务语法(如 [TODO] 阶段标签)、断言字面标记的测试夹具,以及仓库文档中的排除路径。

工作流:一次 git grep 扫描而非逐文件循环;按父文件夹分组并计数;按数量升序展示汇总表;用户按编号选择分组,或用 --work 自动选最小分组;对每个标记读取前后 10 行上下文,分类为立即解决并删除标记、登记工作项并删除标记(通过 /work-items:track add,遵循自观察契约:去重→分类→固定形态→needs-triage)、删除(已完成)或误报(修正排除或 PR 注明);合并到生产代码的可执行标记不得保留。处理完分组后展示结果表(文件、行、动作、详情);若修改了源文件,运行消费方仓库的构建/测试/lint 验证。

限制:需在 Claude 插件环境中使用,依赖共享 tracker seam 与相关参考文件;详细定价、平台支持与效果数据暂未提供。