从三种停顿找出真正需要的能力
一家小剧场正在修复演出目录的预览页：海报扫描完成后需要人确认缺失信息；代理处理大目录时反复读取无关文件；外部摘要请求偶尔失败。这里用虚构的三场演出和本地模拟响应练习通知、上下文组织和调试。完成标准是知道任务为何停下、能接续有效上下文、能解释失败并复现修复，而不是一次安装尽可能多的插件。
原始主题把用户经验归为三类，这个分类适合用来拆任务；其中人数、下载量与省时说法不能直接当作本次验证结果。下面给出可执行的案例和产物，不把未核对的流行名称包装成 SkillPI 已验证技能。
场景一：任务完成与等待输入分别通知
先给每个扫描任务分配编号，记录运行中、等待确认、成功、失败四种状态。扫描器发现一张海报缺少年份时，产出待确认清单并停止相关后续步骤；其他已获授权且不依赖该年份的检查可继续。成功退出的进程与等待人输入的会话是不同事件，不能用一个“已完成”消息混在一起。
Claude Code 可按当前版本的 官方 Hooks 文档 配置事件处理；先确认事件名称、输入字段和运行位置。GitHub 的 官方自动化模式参考 提供通知思路，适合学习事件分流，不能把其中操作系统示例直接当作所有终端都支持的脚本。Codex 或其他宿主需独立确认自己的能力，不照搬配置路径。
第一次只发本机最小提醒：任务编号、项目简称、需要输入或已经结束、返回终端查看。不要把密钥、完整命令或剧场未公布安排放进桌面弹窗。连续相同状态只提醒一次；记录事件时间与最近发送状态，结束后清理订阅或进程。通知只是提醒，不应替人批准权限或替任务输入答案。
用三个练习验证：需要确认时能看到等待提醒；扫描完成时收到成功提醒；模拟扫描失败时收到失败提醒，并能返回对应日志。再测试通知被系统关闭、同一事件重复到达和窗口退出的情况。产物是状态表、事件映射和一次演练记录。若后台通道不可用，保留本地状态查询并明确能力限制，不承诺永远无需轮询。
场景二：用可追踪上下文减少大项目返工
目录中若有数千张图片，不要一开始把所有文件、历史日志和说明加载进会话。先只给代理演出清单、海报命名规则、扫描入口、三个样本和验收约定。让它列出还需要哪个文件及原因，再按依赖补充。原图只读，扫描结果写入独立产物目录，避免一次失败覆盖原数据。
把长期约定和本次状态分开。长期约定写明年份未知必须保留为空、不能猜测、输出须包含来源文件；任务状态写明已扫描哪些样本、发现什么、下一步检查什么。每条结论带文件或提交依据。旧结论被推翻时标注替代关系，不能让所谓“记忆”永久保留已修复的错误。
交接卡示例：任务 T17；基线提交 A；三张海报中 P02 年份待确认；输出清单共三条；本地模式通过解析检查；外部摘要尚未执行；下一步由负责人提供 P02 年份或接受空值。换会话后先让代理复述现状并指出证据位置，确认读到的是当前版本，再继续修改。
评估加速效果时记录完成同一验收样本所用时间、重复读取次数、无效返工和实际费用。缩短提示不一定更省钱：遗漏规则可能导致多轮重做。优先保持最小但充分的上下文；只有子任务互不写同一文件、输入输出明确且权限覆盖时，才考虑并行工作。此处仅描述工作设计，没有声称已创建或运行代理。
场景三：从失败证据定位代码与请求问题
先关闭真实外部调用，用本地响应样本分别模拟正常 JSON、缺字段、超时和错误响应。错误记录保留任务编号、阶段、时间、状态类别和脱敏的请求标识，不保存凭据或完整私有提示。先问失败发生在读取海报、解析结构、网络请求还是页面展示；这四层不能用同一个重试按钮解决。
对直接使用 Claude API 的请求，按 官方错误说明 区分认证、权限、请求格式、限流与服务过载。状态码只是定位入口，还要看错误类型、请求标识和当时环境。错误归属其他提供方或代理网关时，应读对应文档，不能套用同一解释。
无效凭据和格式错误应先修正配置或请求；短暂故障才考虑有上限的退避重试，并检查客户端是否已经重试，避免叠加。设置最大尝试次数、总耗时和停止条件。对于可能写入数据的操作，先确认幂等和执行结果，再决定是否重发；本例的读取练习不能证明任意生产请求都可安全重试。
页面应显示“摘要暂不可用”并保留已扫描的演出资料，而不是用空白覆盖成功结果。新增回归样本验证恢复后只替换摘要区域、未确认年份仍为空、重试期间按钮状态准确。产物是复现步骤、分层诊断、最小补丁、失败与恢复两组证据，以及仍未测试的真实服务边界。
技能选择：先 Finder，再核对目标用途
先检查 SkillPI Skill Finder 是否已安装，缺少时使用 官方安装说明。描述具体任务后再查候选，逐项阅读来源版本、完整 SKILL.md、许可证、依赖和读写范围。不能按名字推断 fast-claude-code 或其他原文名称已经在当前目录被核实，也不能把所有技能说成免费、零消耗或跨宿主同样安装。
本例可验证且匹配的是 Webapp Testing，用于第三场景的本地页面失败恢复检查。它使用 Python Playwright，需要 Python、可运行的浏览器依赖、本地服务启动命令、端口和测试数据；先观察页面结构，再编写稳定定位与断言，保存脚本、截图和浏览器日志。
技能不负责替你管理系统通知、保留跨会话记忆或诊断所有 API，也不替代解析函数的单元测试。若当前缺少经过核验的通知专用技能，直接按宿主官方能力组织提醒即可，不强行关联一个用途不同的目录卡片。后续发现新技能时，用同一组失败和恢复样本比较，再更新关联及验证日期。
故障排查与 FAQ
通知没来怎么办？先确认任务确实产生该事件，再检查处理器日志、运行环境和系统通知权限；不要先关掉安全控制。通知重复时查去重键与退出清理，提醒出现也不等于任务已经成功。
换会话又犯旧错误怎么办？查看是否读取当前交接卡、规则是否有可定位依据、旧状态是否被替换。只写“以后别再出错”无法约束具体输入输出。
安装后找不到技能怎么办？核对当前宿主的发现路径、元数据、命名冲突和重新加载要求，先用一个最小任务验证；不要凭未经统计的比例认定一定是路径问题。
需要全装三类技能吗？先处理最影响当前任务的一处停顿，确认产物改善后再扩展。安装包价格、模型调用、外部服务与维护时间分别计算。上述练习使用模拟资料，未声称运行过读者设备或验证过社区用户数量。