mcpField
S
shower

shower

github.com/lilmgenius测试与质量1.4k1.3k 次安装4 周前更新
代码仓库

关于 shower

shower 是一种审阅技能,会让全新的独立子会话检查产物能否自成一体、易于理解。它报告理解障碍和建议修复项,但不直接修改内容。

主要功能

  1. 01在全新子会话中冷读产物内容
  2. 02对照预期用途检查理解情况
  3. 03找出歧义和未说明的假设
  4. 04按影响排序问题并提出修复建议

适用场景

  1. 01审阅交接文档
  2. 02检查产物对新读者是否清晰
  3. 03发现交付内容缺少的背景

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lilmgenius/paperthin --skill shower

安装后在 Claude Code 中输入/shower确认已加载。

详细介绍

跳出当前会话,让一颗全新的头脑来阅读:这份产物能否独立成立?

目标

漫长的会话会悄然积累上下文,让你无法忘掉已知信息,因此也就失去了判断作品对初次接触者而言是否清晰易懂的能力——你不再知道自己遗漏了哪些未说明的内容(未知的未知)。解决办法是换一颗真正全新的头脑:启动一个从未看到过这段对话的独立子会话,让它冷读当前关注的产物,并指出没有上下文的读者会在哪些地方卡住。这是一项针对理解和交接的冒烟测试。这项技能负责诊断;修复工作回到主会话中进行。

工作流

  1. 明确范围:当前关注的产物(或一组产物)。如果“当前关注”含义不明确,请向用户确认,或选取刚刚产出或正在讨论的产物。私下用一行记录它的用途和目标读者——这是第 4 步的评判标准;评审者不会看到这行内容。
  2. 启动一个全新的子会话(子 Agent / Task——它从零开始获取上下文)。将产物的内容(内联提供或复制一份)交给它,而不是提供仓库路径,并告诉它不要打开项目的 README、文档或相邻文件,以免破坏冷读。不要向它透露任何意图或推理。
  3. 让它在不知情的情况下冷读,并仅根据产物本身报告:
    • 它认为这份产物是什么、做什么,以及期望什么;
    • 哪些内容不清楚、含糊不明,或被默认但未说明;
    • 它需要哪些信息才能有把握地采取行动,以及哪些地方只能靠猜测。
  4. 将它在盲读中的理解与第 1 步记录的意图(它从未看到过)进行比较。每一处不匹配都是产物的缺陷,而不是读者的错误。
  5. 按照对新读者造成的阻碍程度,从重到轻报告缺陷及具体修复方法。

规则

  • 阅读必须来自一个独立、没有上下文的子会话——绝不要在本会话中自我评估,因为你无法忘掉已有上下文(这正是整个方法的核心)。
  • 只提供产物的内容,绝不提供你的意图。
  • 如果不得不说“我只能假设……”,这就是一项发现,不是读者的失误。
  • 不受媒介限制:根据产物的类型调整冷读问题。
  • 一次冷读只是一次尝试,即使非常有把握,在高风险情况下仍可能出错;它是默认做法,不是严谨程度的上限,因此应在风险值得付出成本时,升级为多次独立阅读。
  • 通读,不要扫查。 冷读应从头到尾完整阅读,而不是进行模式搜索——扫查只能发现已知模式,却会漏掉过时引用、失效链接、事实偏差和无声的编辑损坏。记录实际阅读了多少内容;绝不要仅凭搜索结果就报告“没有问题”。

验证

结束前:

  1. 阅读来自一个不了解你意图的全新子会话。
  2. 报告结论(可独立成立 / 存在小问题 / 需要修改),并将修复事项交给主会话。

评论

支持 Markdown