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
description: 对用户指定的成品做交工前检查,生成带证据、未验证项和用户终验建议的报告。用于准备交付文件或用户要求检查、验收成品时。
argument-hint: "[成品文件]"
disable-model-invocation: true
正文 · 交工检查
目标成品:$ARGUMENTS(输入 /delivery-check 后面跟的文件名会进到这里)
- 如果没有提供成品文件名,先询问用户,不要猜。
- 读取项目根目录的 CLAUDE.md、复用任务卡.md 和目标成品。
- 找出与目标成品有关的要求,逐条检查。
- 不修改源素材、目标成品和现有验收文件。
- 在项目根目录创建或更新 技能检查报告.md:实际读取的文件;已验证项目、具体证据和证据来源;未验证或没有把握的项目;建议用户亲自完成的最终检查。
- 没有实际证据时,不写“通过”。
- 完成后重新读取 技能检查报告.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 才开始监听——下一课本来就会开新会话试跑。