用途:清理 AI 辅助编写或长期维护代码中积累的注释杂质,包括修复历史叙述(如“changed to X because…”)、与代码不符的过时解释、逐行复述代码的噪音,以及被注释掉的代码。保留解释非显而易见选择的原因、业务逻辑依据、TODO/FIXME/HACK/XXX、章节标记、危险行为警告、许可证头、类型/检查指令和生成器标记。
主要能力:组合三项机制——keep/remove 判断引擎、对存活注释做去 AI 腔的 humanizer 处理、以及两个可选过滤:跳过死代码/未使用/第三方/生成文件,和基于内容哈希的增量标记(已处理且未变更的文件直接跳过)。
使用方式:先运行 bash "$SKILL_DIR/scan.sh" <path-or-glob> 获取工作清单(PROCESS / SKIP-UPTODATE),省略参数则扫描整个仓库。若可用 repowise MCP 的 get_dead_code 或 codebase-memory 的 search_graph/reachability,可进一步剔除死代码;否则仅用启发式信号并在总结中说明。对每个 PROCESS 文件按保留/删除规则处理,只改注释,不动代码、格式和导入。处理完后运行 python3 "$SKILL_DIR/marker.py" stamp <file> 刷新标记。多文件范围建议先 dry-run 展示清单和删除样例,确认后再应用。
限制:标记版本仅在保留/删除规则发生重大变化时才应升级(v1→v2),否则会强制所有文件重新处理。语言覆盖取决于 marker 辅助脚本的扩展名映射,不支持的扩展名会被报告且不打标记。死代码过滤在缺少相应工具时仅为启发式,非工具验证。具体安装方式与更多细节暂未提供。