C01 · 第 4 章 第 2 课 · 参考样例

第一个项目技能,合格长这样

交付物:.claude/skills/delivery-check/SKILL.md 真实存在,加上一次逐段人工检查(2026-07-16)。本课只创建和检查,不运行——新会话试跑是下一课的事。

📄 .claude/skills/delivery-check/SKILL.md目录名 delivery-check 就是调用命令

开头信息(frontmatter)

name: delivery-check
description: 对用户指定的成品做交工前检查,生成带证据、未验证项和用户终验建议的报告。用于准备交付文件或用户要求检查、验收成品时。
argument-hint: "[成品文件]"
disable-model-invocation: true

正文 · 交工检查

目标成品:$ARGUMENTS(输入 /delivery-check 后面跟的文件名会进到这里)

  1. 如果没有提供成品文件名,先询问用户,不要猜。
  2. 读取项目根目录的 CLAUDE.md、复用任务卡.md 和目标成品。
  3. 找出与目标成品有关的要求,逐条检查。
  4. 不修改源素材、目标成品和现有验收文件。
  5. 在项目根目录创建或更新 技能检查报告.md:实际读取的文件;已验证项目、具体证据和证据来源;未验证或没有把握的项目;建议用户亲自完成的最终检查。
  6. 没有实际证据时,不写“通过”。
  7. 完成后重新读取 技能检查报告.md,再汇报创建了什么、如何验证、还有什么未验证。
🗒 逐段人工检查记录不听“创建成功”,亲眼看过文件内容
路径正确:当前项目/.claude/skills/delivery-check/SKILL.md,不是全局 ~/.claude✓ 核对过
只能手动调用:frontmatter 里有 disable-model-invocation: true✓ 核对过
接收成品文件名:正文包含 $ARGUMENTS✓ 核对过
边界仍在:不修改源素材、目标成品和现有验收文件(第 4 条)✓ 核对过

检查方式:让它创建后重新读取 SKILL.md,按“名字、用途、输入、做法”四块原样展示,我逐段对照——SKILL.md 是可执行说明,不是普通笔记,写模糊了它就做模糊了。

⚠ 输入 /delivery-check 看不到怎么办

先让它列出实际创建路径。如果这是会话里第一次创建顶层 .claude/skills 目录,可能要重启 Claude Code 才开始监听——下一课本来就会开新会话试跑。

返回本课