关于 shower
shower 是一种审阅技能,会让全新的独立子会话检查产物能否自成一体、易于理解。它报告理解障碍和建议修复项,但不直接修改内容。
主要功能
- 01在全新子会话中冷读产物内容
- 02对照预期用途检查理解情况
- 03找出歧义和未说明的假设
- 04按影响排序问题并提出修复建议
适用场景
- 01审阅交接文档
- 02检查产物对新读者是否清晰
- 03发现交付内容缺少的背景
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill shower安装后在 Claude Code 中输入/shower确认已加载。
详细介绍
跳出当前会话,让一颗全新的头脑来阅读:这份产物能否独立成立?
目标
漫长的会话会悄然积累上下文,让你无法忘掉已知信息,因此也就失去了判断作品对初次接触者而言是否清晰易懂的能力——你不再知道自己遗漏了哪些未说明的内容(未知的未知)。解决办法是换一颗真正全新的头脑:启动一个从未看到过这段对话的独立子会话,让它冷读当前关注的产物,并指出没有上下文的读者会在哪些地方卡住。这是一项针对理解和交接的冒烟测试。这项技能负责诊断;修复工作回到主会话中进行。
工作流
- 明确范围:当前关注的产物(或一组产物)。如果“当前关注”含义不明确,请向用户确认,或选取刚刚产出或正在讨论的产物。私下用一行记录它的用途和目标读者——这是第 4 步的评判标准;评审者不会看到这行内容。
- 启动一个全新的子会话(子 Agent / Task——它从零开始获取上下文)。将产物的内容(内联提供或复制一份)交给它,而不是提供仓库路径,并告诉它不要打开项目的 README、文档或相邻文件,以免破坏冷读。不要向它透露任何意图或推理。
- 让它在不知情的情况下冷读,并仅根据产物本身报告:
- 它认为这份产物是什么、做什么,以及期望什么;
- 哪些内容不清楚、含糊不明,或被默认但未说明;
- 它需要哪些信息才能有把握地采取行动,以及哪些地方只能靠猜测。
- 将它在盲读中的理解与第 1 步记录的意图(它从未看到过)进行比较。每一处不匹配都是产物的缺陷,而不是读者的错误。
- 按照对新读者造成的阻碍程度,从重到轻报告缺陷及具体修复方法。
规则
- 阅读必须来自一个独立、没有上下文的子会话——绝不要在本会话中自我评估,因为你无法忘掉已有上下文(这正是整个方法的核心)。
- 只提供产物的内容,绝不提供你的意图。
- 如果不得不说“我只能假设……”,这就是一项发现,不是读者的失误。
- 不受媒介限制:根据产物的类型调整冷读问题。
- 一次冷读只是一次尝试,即使非常有把握,在高风险情况下仍可能出错;它是默认做法,不是严谨程度的上限,因此应在风险值得付出成本时,升级为多次独立阅读。
- 通读,不要扫查。 冷读应从头到尾完整阅读,而不是进行模式搜索——扫查只能发现已知模式,却会漏掉过时引用、失效链接、事实偏差和无声的编辑损坏。记录实际阅读了多少内容;绝不要仅凭搜索结果就报告“没有问题”。
验证
结束前:
- 阅读来自一个不了解你意图的全新子会话。
- 报告结论(可独立成立 / 存在小问题 / 需要修改),并将修复事项交给主会话。
评论
支持 Markdown