该技能用于对代码库重建准备过程中的单个业务层进行深度盘问。它由 unwind:uw-grill 编排调用,输入为 docs/unwind/.cache/grill/seeds/{layer}.json,该种子文件包含层名、文档目录、发现预算、阈值、仓库约定、预计算热点以及该层文档中标注的 [MUST] 规则表面。输出为 docs/unwind/.cache/grill/{layer}.json,仅包含发现清单。
主要目标有两个:一是找出重建时会被忠实复制、但本不该继续保留的规则,例如为旧版本供应商缺陷而存在的临时绕过;二是找出即使想重建也难以复现的规范,例如只有一句话描述、缺少公式或边界情况的关键规则。该技能不负责证明每个符号是否被描述,那是覆盖阶段的工作。
工作流程分五步。第一步读取种子,从热点线索入手,优先查看标记数量多、严重性高的位置,同时阅读 mustSurface 中的规则表面与 conventions 中的可信信号;当 testConventionReliable 为 false 时,不得声称任何内容未被测试。第二步先读层文档,再读源码,关注两者之间的差距。第三步按类别搜寻发现,每个发现只归入一个类别,并设置 answerableBy 字段决定问题去向:专家类问题进入领域负责人文档,工程师类问题在运行过程中解决。类别包括:正确性类(专家回答)有 obsolete-rule、unexplained-rule、magic-constant、contradiction、duplicated-logic-drift;正确性类(工程师回答)有 tenancy-scope-gap、silent-failure、idempotency-ordering;就绪度类(工程师回答)有 thin-spec、untested-must。第四步明确拒绝报告风格、复杂度、命名、格式化、TODO、安全扫描、依赖版本、性能、缺少输入验证、不一致错误类型或无日志等问题。第五步在最后一次性写出发现文件。
每条发现必须包含类别、严重性、置信度、回答者、层、候选 ID、标题、详情、面向非工程师的业务问题、建议处置方式以及证据。证据必须来自实际打开的真实文件路径与行号,引用内容必须从源码复制,不能凭记忆或文档重构。无法引用证据的发现应直接丢弃。合并步骤会根据清单重新校验并静默拒绝不合格的发现。预算是对发现数量的硬性上限,应优先输出证据充分的高严重性发现,少量优质发现优于大量平庸发现。
适用场景为代码库重建前的业务逻辑审计与规范就绪度检查。限制包括:只处理单个层;不编辑层文档;不访谈人员;不报告风格、复杂度或 lint 类问题;在测试约定不可信时不得声称未测试;所有发现必须可引用真实代码。