第 4 章 · 问题 2:做法写进文件了,但还不够好用
复用任务卡.md 已经有了。能不能不用自己学写代码,直接让 Claude 把它变成一个随时可用的 /delivery-check?
可以。你负责说清楚技能叫什么、放在哪里、接收什么输入和不能做什么;Claude 负责创建文件。这节课只做一个当前项目专用的技能,创建后先读内容,不急着运行。
- 01项目技能应该放在哪个文件夹,为什么先不做成全局技能?
- 02
SKILL.md里哪几部分必须亲自检查? - 03怎样让 Claude 只创建这一个技能,不顺手改动其他文件?
.claude/skills/delivery-check/SKILL.md 真实存在你会亲眼核对路径、用途、输入、固定步骤和“不能修改素材”的边界。
01先看技能文件会保存在哪里,不需要背下整条路径
项目技能不会跑到你所有工作里,第一次练习更容易检查和撤销。
.claude 可能被系统隐藏,不需要手工寻找。让 Claude 创建;完成后让它列出实际路径和文件内容即可。02第一次只检查技能文件的四部分:调用名称、什么时候使用、接收什么输入、按什么步骤执行
name: delivery-check description: 对指定成品做交工前检查,生成带证据和未验证项的报告。 argument-hint: "[成品文件]" 目标成品:$ARGUMENTS 1. 读取项目规则和目标成品。 2. 逐条检查并写明证据。 3. 生成技能检查报告.md。
名字决定你在斜杠菜单里输入什么:/delivery-check。
SKILL.md 是可执行说明,不是普通笔记。创建项目技能前要读一遍内容。官方也提醒:项目技能可以声明工具权限,因此不要把陌生项目里的技能当作无害文档直接信任。
深挖:SKILL.md 为什么是“可执行说明”
普通笔记写给人看,看不懂还能问作者;SKILL.md 是 Claude 开工前必读的操作手册——你输入 /delivery-check 的那一刻,它就按文件里的字面步骤动手,没有机会先和你核对理解。所以“逐条检查并写明证据”比“好好检查”可靠,“不修改素材”比“注意安全”管用:写模糊了,它就做模糊了。
03把下面整段任务发给 Claude,让它在当前项目中创建技能文件
- 复制并发送下面任务
目标路径必须在当前项目的
.claude/skills/里面。 - 出现写入请求时核对路径
只允许创建
delivery-check/SKILL.md,不要同意写入全局目录。 - 让它重新读取并原样展示
不要只听“创建成功”,必须看到实际文件内容。
请读取项目根目录的 复用任务卡.md,创建项目技能:
.claude/skills/delivery-check/SKILL.md
SKILL.md 必须严格写入:
--- name: delivery-check description: 对用户指定的成品做交工前检查,生成带证据、未验证项和用户终验建议的报告。用于准备交付文件或用户要求检查、验收成品时。 argument-hint: "[成品文件]" disable-model-invocation: true --- # 交工检查 目标成品:$ARGUMENTS 1. 如果没有提供成品文件名,先询问用户,不要猜。 2. 读取项目根目录的 CLAUDE.md、复用任务卡.md 和目标成品。 3. 找出与目标成品有关的要求,逐条检查。 4. 不修改源素材、目标成品和现有验收文件。 5. 在项目根目录创建或更新 技能检查报告.md,必须包含: - 实际读取的文件; - 已验证项目、具体证据和证据来源; - 未验证或没有把握的项目; - 建议用户亲自完成的最终检查。 6. 没有实际证据时,不写“通过”。 7. 完成后重新读取 技能检查报告.md,再汇报创建了什么、如何验证、还有什么未验证。
不要创建其他技能,不要修改项目现有文件。创建后重新读取 SKILL.md,按“名字、用途、输入、做法”四块原样展示给我。
04先检查文件,不急着运行
逐项点击,对照真实 SKILL.md。四项都确认后,下一课再调用。
.claude/skills/delivery-check/SKILL.md 真实存在你已经亲眼检查路径、调用方式、输入和边界项目技能和个人技能以后怎么选
项目/.claude/skills/:只服务这个项目,能随项目一起交给别人。本课使用。
~/.claude/skills/:你所有项目都能用。等这个技能在真实项目里稳定试跑后,再考虑复制成个人技能。
/delivery-check 看不到?先让 Claude 列出实际创建路径。若这是会话启动后第一次创建顶层 .claude/skills 目录,官方说明可能需要重新启动 Claude Code 才能开始监听这个新目录;下一课本来就会开新会话。
.claude/skills/ 下的第二个技能。提示:先写复用任务卡再翻译成 SKILL.md,五个部分一一对应;名字用小写和连字符,让斜杠菜单里一眼认出它是干什么的。
提示:想想这个技能会碰到的文件里,哪些是只能读不能改的;没写进文件的边界,等于没有边界。
但文件存在还不能证明技能真的会工作。下一课换一个全新会话,只输入“技能命令 + 成品名”,看它能不能独立生成合格报告。
进入下一课:在新会话试跑并修正技能 →最后验收
不要只确认“AI 说做完了”,请打开真实结果检查。
项目里的 .claude/skills/delivery-check/SKILL.md,以及一次逐段人工检查回到当前 AI 任务,请它打开本课成品;也可以在访达 / 资源管理器里进入项目文件夹双击。查看参考样例 ↗