Skip to content

ccch1mneyyy/dsh-TUI / .agents/skills/review

review

Verified

Review or de-slop concrete changes in ccch1mneyyy/dsh-TUI at maintainer level: PR numbers or URLs, branches, commit ranges, patch files, staged or unstaged worktrees, and scoped repository-hygiene requests. Use for evidence-first correctness, contract, repository-rule, process, and behavior-preserving cleanup review, including debug residue, dead or duplicate code, speculative abstractions, stale comments or tests, and unrelated diff churn. Do not use for abstract designs with no concrete repository artifact; use audit for repository-wide assessments and vuln-check for security-only checks.

FileKindSize
SKILL.mdskill md10.5 KB
references/contract-gates.mdmarkdown5.0 KB
references/deslop-gates.mdmarkdown5.9 KB
references/evidence-base.mdmarkdown7.2 KB
references/redlines.mdmarkdown4.8 KB
references/report-contract.mdmarkdown3.1 KB
references/verification-map.mdmarkdown5.1 KB
scripts/contract-snapshot.mjsexecutablescript15.6 KB
scripts/scan-diff-hygiene.mjsexecutablescript9.6 KB

references/deslop-gates.md

View on GitHub
# dsh-TUI Deslop 判据与最小清理协议
仅降已证仓库熵,不猜作者、不包装审美。下称“红线”指 references/redlines.md,“行为/流程”指 references/evidence-base.md,“验证映射”指 references/verification-map.md。

## 优先级
冲突依次:保行为/数据/API → 当前契约/所有权 → 最小 diff、无关格式化不入 → 优先删已证多余项而非造抽象 → 不添依赖/框架/统一层 → 保非显然不变量注释与回归保护。

## 三层分离
### 1. 候选信号
grep/编译器/静态分析/扫描器/单调用点仅表示值得核查;冲突标记/debugger/stdout、TODO/FIXME/HACK/占位/禁用测试、`@ts-ignore`/`@ts-nocheck`/eslint disable/`as any`、空 catch/空 `.catch`、新未引用符号/相似 helper/重复字面量/wrapper、注释文码不符、无关文件/大格式化均须上下文核验,不直接 auto-fix。

### 2. Finding
须给机制/成本:当前或合理可达失败、公共契约/硬规则违反、双真源漂移、同语义平行实现须双改、无收益层增状态/异常/所有权边界、假绿挡不住所称回归、文档误导维护动作、无关 churn 扩审查/冲突/回滚面。

### 3. 可安全修改项
finding 外还须删除/合并证明及可信工作树前后验证;缺证据只报不改。

## 严重度与熵类型
| 类型 | 例子 | 默认输出 |
|---|---|---|
| 硬缺陷伪装成 slop | stdout 污染、吞错伪成功、假绿、生成物入库、删公共 export;运行时/契约/安全/硬规则影响 | defect,行为/契约/安全/流程 A–D 轴,❌/⚠️ |
| 已证实维护熵 | 双真源、无收益 wrapper、过时注释、死路径、重复实现、越界 churn;仅维护/理解成本或未来误改风险且证据完整 | slop,熵 E 轴,通常 ⚠️/💡 |
| 纯偏好 | 命名、空行、排序、“更优雅” | 不报,除非仓库明规 |

本节是分类/严重度/置信度的唯一真源:置信度独立,高置信轻微熵仍 💡,高影响缺证据只澄清。

## 证明义务
删除前通查仓库引用、动态注册/字符串查找、公共 exports、副作用、生成来源、测试/夹具、平台分支;任一未知不得自动删除。再按类别补证:

### 死代码 / 未使用导出
至少查静态 imports/calls/constructors/re-exports;package.json 的 exports/bin/imports;字符串注册/动态 import/Cordis service/command/event;JSX/React 动态映射;测试/夹具/脚本/文档示例/下游插件契约;模块求值/注册/polyfill/环境初始化副作用。grep 零命中不足以删公共/注册式代码。

### 重复 helper / 平行实现
证输入规范化/边界值、错误/fallback、owner/副作用/生命周期、平台、返回类型/API、测试判定依据等价;指明当前权威接口及合并迁移调用者,文本相似不等于重复。

### 单调用者 abstraction / wrapper tower
单调用者非 finding;须证该层不担 adapter/所有权/策略/测试/懒加载/平台边界,不稳定依赖方向、不隔离第三方/预发布 API,删除不扩调用者知识或破替换点,且实增错误转换/状态同步/导航成本;架构边界即使单调用者也保留。

### fallback、catch 与 defensive cargo cult
须证吞真实契约错误、伪成功、状态/UI 分叉、保不支持旧 API 而藏漂移,或令类型/测试永不到真实分支;合理兼容边界、可观察降级、资源清理 catch 不算 slop。

### 注释、JSDoc 与文档噪声
只报与代码/路径矛盾、过时复述易漏同步、PR 自述冒充验真、不存在的 fallback/兼容/安全承诺、教程遮关键不变量;保解释原因的短注释、协议来源、平台限制、安全不变量。

### 假绿或冗余测试
坏基线失败、独立判定依据(不复制实现/同源自比)、非恒真/符号/翻译子串断言、真实入口/夹具、CI/聚合挂载以验证映射“反假绿检查”为唯一真源;另证删测试不丢独立不变量/平台覆盖。先修判定依据再考虑删除,测试多不等于 slop。

### 超范围 churn
用 issue/PR 主张及变更面映射证与主题无关:本地编辑器/包管理配置、整棵上游同步树、顺手修别的 bug、vendor/Ink 大重排、格式化未改逻辑、无用于主题的新框架/脚本/文档。建议拆分/恢复无关路径,不扩大 patch 顺手清理。

## dsh-TUI Golden Principles
优先检查点按以下唯一真源核验,不另造规则副本:
- 会话事实、职责/owner、终端安静/净化/单元上限、可审/可回滚范围 → 红线 2、3/12、5/7、13;增量:screen/component 不另建平行兼容层,不以两个布尔量镜像同模式,不混并行方案。
- 当前 exports/features/plugin-host 全集提取 → references/contract-gates.md 门 1/5;事件全集 → 验证映射“独立 oracle”,不长期手抄计数。
- 测试/快照/gate 不与实现共用错误来源 → SKILL.md 阶段 2 三分查及验证映射“反假绿检查”。
- 不吞错/未持久化伪称成功/兜底藏上游漂移 → 本文件 fallback 证明及行为/流程 A3;Windows/POSIX、真终端、socket/路径字节 → 行为/流程 A5;可选 UI/生态优先插件、核心不引大块无增量源码 → 行为/流程 D1。

## 候选扫描器的边界
scripts/scan-diff-hygiene.mjs 仅读 unified diff 新增行,输出文件/head 行号/类别/置信提示/上下文要求;不判可达性/动态注册/API、catch 故意忽略、TODO 已归 issue、必要第三方 `any`、注释过时,不自动改文件。完成本文件证明前,扫描器 `high` 不得写成高置信 finding。

## Apply 协议
清理编排唯一真源为 SKILL.md 阶段 6,不在此复写。

## Finding 写法
E 轴 finding 须答双处维护动作/被藏错误、当前 head 证据、非架构/兼容边界或必要注释的理由、最小安全变化、引用/副作用/API/测试的删并证明;缺一转澄清,不建议自动修复。
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall