Instruction file imported from Lawofall/AgentCore (
.cursor/rules/seam-audit.mdc). Copyright stays with the author.
接缝排查配方(interface-seam audit)
排查「一侧定义了、另一侧没接」的接缝 bug。逐轮结论正文见 git;公开仓不复述审计票号。
两类接缝签名(判据)
- 渲染画了却没接(drawn-but-not-wired)=一侧有 UI/控件/动词/handler,却没把输出真正喂到另一侧、或输出被静默丢弃。
- 例:多选 scale 手柄画了不 hit-test;看板分组列被隐藏时配置显示 ok、画面却空白。
- 已铺管线·零产出(plumbed-but-zero-producer/consumer)=字段/事件/路由/DB 列/类型在一侧已定义并承载,另一侧却无 producer(无人写/发)或无 consumer(无人读/渲)。
- 例:rotation 全链认却无 producer;
run_id后端发前端丢;辩论BatchMetrics收了不 emit。
- 例:rotation 全链认却无 producer;
铁律:判 gap 前先查文档(防误报)
判「有后端无前端 / 有前端无后端」为 gap 之前,先 grep docs/ 看是否记为有意休眠 / 退役 / ⏳待后端——大量「缺口」实为 by-design(质量档 UI 内测退役、admin LLM 窗待后端、mobile lite 减法)。
弱证据不冒充 bug,置信五档只对前两档动手:
GAP(真缺口·修)/ DRIFT(漂移·修)/ RESERVED(前瞻预留 → 路线图摘要)/ BY-DESIGN(有意 → 记档闭案)/ UNSURE(留观察)。
可复用配方
- 按面切分(画板/分享/admin/用户规则/…)派并行只读探子,每子代理带「两签名 + 本铁律 + 五档置信 + 必附
file:line证据」。委派形态跟 Cursor Task 官方说明。 - 探子回报的 GAP 先 Read 源码复核——别信行号(复核曾翻过「有前端无后端」误报);复核以外禁止主侧重跑整审计。
- 复核为实的 GAP·DRIFT 才修,改完
vitest/pytest+biome/ruff+tsc自检。 - RESERVED 进路线图摘要(或维护者本地规划索引)、BY-DESIGN 记档闭案、UNSURE 留观察。
收口判据
每批稳定 ~2 真 bug、二批后边际递减(多为 by-design)即收口,别为凑数造 busywork。