第 4 章 · 问题 3:看得到命令,不等于真的能交工
/delivery-check 已经出现在项目里。可如果换一个全新会话,它会不会漏读规则、写出没有证据的“检查通过”?
这节课不相信“技能创建成功”这句话。你会在新会话真实运行一次,打开报告找漏项,把发现的问题写回技能,再运行第二次。技能不是一次写完,而是在真实使用中越改越可靠。
- 01新会话只收到一条命令,技能能不能自己找到规则和成品?
- 02怎样识别报告里“听起来正确、实际没有证据”的结论?
- 03发现漏项后,怎样把经验写回技能,而不是每次聊天都重新提醒?
技能检查报告.md + 技能试跑记录.md + 页面质检徽章区记录第一版漏了什么、技能改了哪里、第二版怎样用更可靠的证据回答。
01先看一次模拟运行:输入一条命令后,Claude 应该依次读取技能、读取项目、执行检查并创建报告
/delivery-check 活动执行单.html02在真实 Claude Code 打开新会话,第一次试跑
仍然选择 c01-first-delivery,确认输入框能看到斜杠菜单。
新会话会重新发现项目里的技能目录。
/delivery-check 活动执行单.html
技能检查报告.md报告列出实际文件、证据、未验证项和用户终验建议先确认文件路径和 SKILL.md 文件名,再重新启动同项目会话。如果菜单里仍没有,直接输入“列出当前项目可用技能和来源路径”,让它给出证据。
03打开第一次生成的报告,检查每个结论是否有证据、无法确认的内容是否明确标出
“页面内容检查通过。”
它没有写证据来自哪里,这一项能算通过吗?
04找到报告里缺少的一项检查,把新的要求写回技能文件
第一版会写“未验证项”,但没有强制单独检查受保护的源素材。读取文件不能证明它们从未被改过;本项目已经有独立验收工具,所以把这条经验写回技能。
请读取第一次生成的 技能检查报告.md 和 .claude/skills/delivery-check/SKILL.md。
修改 SKILL.md,在检查步骤中追加:
- 必须把“受保护源素材是否保持原样”单独列为检查项。 - 仅靠读取当前文件不能证明它从未被改过;如果没有运行独立哈希或验收工具,必须写入“未验证”,并建议用户打开项目里的 验收工具.html 完成终验。
不要修改其他文件。修改后重新读取 SKILL.md,告诉我新增规则位于哪一段。
05让技能学会盖章:检查通过,页面上要看得见
检查报告躺在 技能检查报告.md 里,打开活动执行单的人一个字也看不见。给 /delivery-check 加最后一步:全部检查项通过时,在活动执行单上盖一个看得见的“质检徽章”。
请修改 .claude/skills/delivery-check/SKILL.md,在检查步骤的末尾追加:
- 全部检查项通过时:更新 活动执行单.html 的“质检徽章”区(没有这个区,就在“版本历史”区上方创建一个):写入通过项计数(如 9/9)、检查日期、/delivery-check 字样。同时在“版本历史”区追加一行,说明本次盖章。 - 有任何未通过项:不得创建或更新徽章区,只在报告中列出问题。 - 徽章内容必须来自本次真实检查结果,禁止凭空写“通过”。
不要修改其他文件。改完后重新读取 SKILL.md,把新增的盖章步骤原文贴给我确认。
改完技能,在会话里跑一次 /delivery-check 活动执行单.html,亲眼看徽章出现在页面上:
/delivery-check 活动执行单.html
活动执行单.html,出现“质检徽章”区:通过项计数 + 检查日期“版本历史”区多出一行;技能检查报告.md 的结论与徽章数字一致这是最危险的一种错:页面在替一次不合格的检查背书。回到 SKILL.md,确认“有任何未通过项不得更新徽章区”那句真的写进去了,再跑一次。
06在新会话第二次运行技能,确认问题已经修正,再保存两次运行的对比记录
/delivery-check 活动执行单.html
第二次报告里应该新增“源素材完整性”检查,并在没有独立证据时明确标为未验证,而不是假装通过。
请在项目根目录创建 技能试跑记录.md,只记录真实发生的结果:
# delivery-check 技能试跑记录 ## 调用 - 新会话输入:/delivery-check 活动执行单.html ## 第一版结果 - 创建了什么: - 做对了什么: - 发现的漏项: ## 写回技能的改进 - 修改的文件:.claude/skills/delivery-check/SKILL.md - 新增的规则: ## 第二版结果 - 报告是否单列源素材完整性: - 没有独立证据时是否明确写“未验证”: - 仍需用户亲自完成什么:打开 验收工具.html 终验
缺少真实证据的空格保留为空,不要编造。不要修改其他文件。
delivery-check/SKILL.md 能在新会话被调用并生成报告技能试跑记录写清第一版问题、改进规则和第二版证据不要继续在聊天里提醒。直接打开 SKILL.md,看新增规则是否真的写进去、描述是否明确、技能是否从正确的项目路径加载。
深挖:为什么改进必须写回文件,不能只在聊天里叮嘱
聊天里的叮嘱只活在这个会话;写进 SKILL.md 的规则跟着技能走,换会话、换日子、换人用都在。技能的成长靠的就是"试跑→发现→写回"这个闭环——每一圈都让它更像你要的那个检查员。
下一章不急着设置每天自动运行。先解决一个更关键的问题:没有聊天窗口、没有人在旁边回答问题时,这个技能能不能独立跑完并留下回执?
进入第 5 章:先完成一次无人回答的单次运行 →最后验收
不要只确认“AI 说做完了”,请打开真实结果检查。
技能检查报告.md、改进后的 SKILL.md 和技能试跑记录.md回到当前 AI 任务,请它打开本课成品;也可以在访达 / 资源管理器里进入项目文件夹双击。查看参考样例 ↗