用途:监控代码库中的重构健康度。该技能会查找所有活跃的 REFACTOR 标记,校验其关联的 ADR 是否存在,并识别过期标记(超过30天)、孤立标记(缺少 ADR)以及已完成但未移除的标记,用于保持重构跟踪清晰、防止技术债累积。
主要能力:支持文件级标记(# REFACTOR: ADR-XXX)与方法级标记(# REFACTOR(ADR-XXX):)两类;解析 ADR 编号、状态、STARTED 日期与 PERMANENT_RECORD 路径;校验 ADR 文件是否存在于 docs/adr 目录;计算标记年龄并判断是否过期;检测 ADR 已完成但标记仍残留的情况;输出分类健康报告(GOOD、ATTENTION_NEEDED、CRITICAL)。
使用方式:通过 grep 查找标记,例如 grep -rn "^# REFACTOR:" src/ --include=".py" 与 grep -rn "# REFACTOR(" src/ --include=".py";用 find docs/adr -name "027-.md" -type f 校验 ADR;用日期计算判断是否超过30天。该技能可与 @statuser、@feature-completer、@architecture-guardian 等代理工作流集成,在状态检查、功能完成前或架构审计时调用。
适用场景:用户询问重构状态或进度、功能标记完成前、每周健康检查、开始新重构前检查现有工作、架构健康审计。
限制:资料未提供具体安装命令、收费方式或平台支持信息;年龄计算依赖 STARTED 日期格式为 YYYY-MM-DD,缺失日期时无法计算年龄;ADR 目录结构需符合 docs/adr/in_progress、implemented、deprecated 等约定,否则校验路径需调整;不同标记格式需使用灵活正则处理。