第 5 节 · 本站原创中文课程 · 建议 45 分钟
第五节:编写一个可复用的审查 Skill
学完能做:把第一节的任务契约整理成 SKILL.md,并设计触发与验收案例。
Skill 保存方法,而不是堆积所有资料
把经常重复的流程和判断标准放进 Skill,把长篇参考拆成按需阅读的文件。description 说明何时使用;正文说明步骤、边界和产物。文件结构清晰,才方便团队审核和修改。
参考原文:03-skills/README.md ↗从最小只读能力开始
下面是本站编写的 review-inputs 模板。将它保存到练习项目的 .claude/skills/review-inputs/SKILL.md,先阅读内容再使用。allowed-tools 缩小可用工具范围,但不代替运行环境的权限、沙箱和对输出的核验。
---
name: review-inputs
description: 审查当前改动的输入校验和错误处理;用户请求代码审查时使用。
disable-model-invocation: true
allowed-tools: Read, Grep, Glob
---
只阅读本次任务提供的代码与相关上下文。
检查空值、类型、边界值和错误返回。
每条发现写明位置、触发输入和证据。
证据不足时注明不确定,不修改文件。 验证触发与内容两件事
模板设置为由用户手动调用,避免在普通对话中自动执行。记录它是否被发现和加载,再看审查质量。准备一个无缺陷示例和一个含缺陷示例;无问题时允许返回没有发现,不要求每次都凑出建议。
演进时保留失败案例
若 Skill 报出不存在的问题,把该输入加入回归样例,再修改说明。不要为了让输出漂亮而删掉难例。后续可以按需要增加参考文件和脚本,但先保持只读任务足够小。
这是本站独立编写的讲解与示例,并非官方课程逐字翻译。理解之后,请完成下面的练习、自测和笔记。