T learn.traeai

第 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 报出不存在的问题,把该输入加入回归样例,再修改说明。不要为了让输出漂亮而删掉难例。后续可以按需要增加参考文件和脚本,但先保持只读任务足够小。

这是本站独立编写的讲解与示例,并非官方课程逐字翻译。理解之后,请完成下面的练习、自测和笔记。

参考来源:luongnv89 / claude-howto · 社区开源教程

动手,把理解变成成果

本节练习

正在读取本机草稿…

完成 review-inputs/SKILL.md,保留手动调用和只读工具。写一个正例、一个无缺陷例,记录加载与审查结果。

43 / 6000 字。本页不执行代码;可下载后在本地运行,或用 Agent 获取定性建议。

给我一个提示

触发成功不等于审查正确;分别记录这两个指标。

查看参考思路(本站预写,非实时 Agent)

Skill 被菜单发现后,用缺少边界检查的函数和已完善函数各跑一次。前者需给出触发证据,后者不应硬凑问题;输出不足时保留失败样例。

人工自评:逐项核对自己的作品

这些勾选由你确认,不是自动测试结果。遇到待测项,请在作品里明确注明。

理解自测

为什么要同时测试一个无缺陷样例?

自己的学习笔记

0 / 3000 字 · 仅保存在此浏览器

围绕当前章节学习

Agent 答疑与作品评价

正在检查连接…

本站讲解、提示、参考思路和自测可独立使用。连接模型服务后,才能实时提问或评价;这里不会把预写内容伪装为 Agent 回答。

走完学习闭环

完成本节

保留练习、勾选人工自评并通过自测后,可记录完成。修改作品或答案会重新打开本节。

课程进度:0 / 10 · 本机记录,不是外部官方证书

← 上一节:第四节:从聊天到可重复的命令行任务