社区维修站有一个本地预约演示站。维护者已经能让 Claude Code 写单个函数，现在想把「修改预约说明、检查页面、交给同事复核」变成可重复的流程。练习只用虚构预约和隔离分支，最终交付一份配置记录、一个范围明确的审阅助手和一条可以复跑的页面验收。学习进度以实际产物判断；安装了多少扩展，不能证明任务已经完成。
开始前固定一个小任务和环境
在练习仓库记录 Claude Code 版本、操作系统、工作目录、启动方式和测试命令。创建一个有可见差异的任务：把预约页面的「随时到店」改为「请在预约时段到店」，并确认移动端文字能显示完整。列出允许修改的文案文件、组件和测试，不涉及真实预约、付款或通知。保存修改前截图和当前版本，先手动启动演示站，再运行一次原有检查。这样后续失败时，可以分清项目本身不能启动还是新增配置有问题。
为任务写三条验收条件。页面显示新的句子，预约表单仍可使用，交接者能按记录复现检查。让助手先找到文案来源与调用组件，再提出小范围改动。如果它找不到入口，补充现有目录说明或检索结果，不急着增加更多工具。把当前分支、未提交文件和练习数据位置记在任务卡上，避免另一会话误读正在进行的工作。
第一轮练习：让 Hooks 产生可观察结果
Hooks 把宿主支持的事件交给处理程序。先决定要观察什么，再按当前官方文档核对事件、配置作用域、输入字段和返回方式。这个案例先记录一次文件编辑后发生的检查，内容只含时间、任务编号、事件类别和结果。处理程序放在练习目录，配置先限于该项目。确认已有配置后增加一项，保留原文件副本与撤销步骤。不要直接把网上模板中的路径、命令和事件名称当作适合本机的值。
第一遍让处理程序只输出一行可识别的练习标记，编辑指定文案后核对它确实运行。再接入仓库现有的格式检查，给运行设置时限，记录退出状态和检查输出。分别演练正常编辑、检查失败以及处理程序找不到依赖。检查不应偷偷重写不相关文件；如果选用自动格式化，事先说明可修改范围，并对照运行前后差异。若同一次动作触发了多个处理程序，按任务编号检查是否重复执行。
Hooks 失败时从最小标记回查。确认当前会话加载了哪个作用域的配置，路径是否在当前系统可执行，标准输入是否符合处理程序预期，输出有没有被后续命令覆盖。把「事件未触发」「处理程序执行失败」「检查发现代码问题」写成不同结果。暂时撤销新配置再跑同一任务，能帮助判断故障与新增处理是否有关。验收产物是一份配置差异、两次运行记录和恢复原配置的方法。
第二轮练习：给审阅助手明确任务边界
先在主会话完成一次人工可复核的审阅，再决定哪些重复步骤交给子代理。子代理适合独立整理调用路径或审阅有限差异；它需要目标、输入版本、允许使用的工具和结果格式。按当前 Claude Code 子代理文档选择配置位置和能力范围，区分个人使用与项目共享。此处创建的角色只读检查预约说明变更，输出问题位置、触发条件、影响和建议的验证方法。它不负责提交、部署或修改预约数据。
把当前差异、页面地址和三条验收条件交给审阅助手，要求先说明它实际读过哪些文件。它发现移动端换行可能遮挡按钮时，应指向具体组件和宽度条件；若没有打开浏览器，只能提出待验证风险。主会话据此打开预览，使用指定窄屏条件检查，再决定是否需要调整样式。保持建议、执行和观察分开记录，方便同事判断证据强度。
先给一份包含已知问题的练习差异，检查助手能否指出它，再给一份正确差异检查误报。任务材料缺少文案来源时，让它报告缺失输入，观察它会不会臆造文件位置。工具不可用时应说明限制。若需要修改代码，由主会话或维护者依据审阅结果执行，再把新版本交回复核。交接中带上分支与差异版本，避免审阅结论被套到后来改过的文件。
第三轮练习：按任务发现和试用 Skill
先用一句话描述能力缺口，例如「在本地预约页复现文案修改后的表单行为，并保存证据」。查找时以场景、宿主和产物为条件，打开候选详情核对上游仓库、固定版本、许可证、依赖、读写目录和网络去向。名称中出现 Claude 或 Expert 并不能证明作者身份，也不能说明适合本项目。技能包中的说明、脚本和附件需要一起检查；有脚本时，阅读它实际执行的动作后再按环境规则运行。
用于本轮页面验收，可选择 Webapp Testing。已核对的条目说明它使用 Python 与 Playwright 测试运行中的本地应用，产出浏览器脚本、截图和日志。它放在修改之后的页面回归步骤，输入是演示站地址、测试数据与验收条件。先准备应用启动说明和浏览器依赖，核对脚本执行范围，再用一个小任务试跑。它的页面检查不能代替 Hooks 配置验证，也不能证明子代理遵守了权限边界。
安装后分别确认宿主发现了技能、任务实际调用了技能、产物符合预期。按当前宿主文档核对加载位置与调用方式，查看技能名称和描述是否与已有项冲突。记录试用版本、安装位置、运行命令和结果。迁移到其他 Agent 时，重新确认目录、元数据、工具接口和配置支持，使用同一小样复验，不能因为 SKILL.md 能打开就认定完整工作流兼容。
把三轮结果串成一次交付
主会话先读任务卡并定位原句，修改限定文件后检查差异。观察 Hooks 的任务标记和格式检查结果，随后调用只读审阅助手获取可定位的问题。用 Webapp Testing 在本地演示站核对新文案、窄屏布局和表单提交前的行为，保留实际截图与日志。若需要调整，更新同一任务记录并重跑受影响的检查。最终包应包含代码差异、配置版本、审阅意见、执行过的检查和未覆盖事项。
请另一位维护者只读交付包复跑一次。他应能找到启动方式、测试数据和成功条件，指出哪些结果已经观察到、哪些仍待补测。记录一次完整演练的时间和返工原因。后续再比较新增技能是否减少重复步骤；长指令、索引与并行任务也会带来运行开销，效果需要用同样任务衡量。仓库升级后先回放这一小样，再决定是否更新配置或技能。
常见问题
一定能在一个周末完成吗？
进度取决于基础环境、项目复杂度和可用时间。先完成一个可重复任务，再增加自动化。环境和权限尚未弄清时，把时间用于启动与观察；能解释失败并恢复配置，也是有效产物。
开源技能是否保证免费或节省用量？
许可证、宿主订阅、模型调用和第三方服务是不同成本。阅读具体条款与依赖，记录演练消耗和检查时间。技能执行可能增加检索与调用，不能在没有对照数据时承诺节省额度。
不熟悉代码，能直接复制 Hooks 模板吗？
先在练习副本中阅读处理程序要读写哪些文件、运行什么命令，再从输出标记开始。对无法解释的外部命令请维护者审阅。保留撤销方式，逐步验证后再扩大用途。
安装后看不到技能，应该重装吗？
先核对当前宿主、会话、目录和文件格式，再检查同名项及加载提示。发现成功也要运行小样确认调用。只有明确定位到包损坏或缺文件后，再按支持的方式修复安装。
可以跳过发现工具手动安装吗？
可以按宿主官方方式选择单个来源安装，但仍需核对版本、许可证和运行要求。发现工具帮助缩小候选范围，最终选择依据是本项目的小样验收。