Skip to main content

为什么用 skill

您的团队可能已经把安全规则写成了供编码助手使用的智能体 skill。自定义智能体可以在代码审查中遵循同一个 skill:在变更需要时打开它,读取其参考文件,并引用每条发现所应用的规则。当主分支上的 skill 发生变化时,智能体无需修改设置就会遵循新版本。 示例是一个多租户的排程 API,其中每个查询都必须限定在调用者的工作区内。

步骤 1 — 代码库中的 skill

.claude/skills/tenant-isolation/SKILL.md
.claude/skills/tenant-isolation/references/tenant-tables.md
文件夹名必须与 name 一致,并且 description 是必填的。

步骤 2 — 作为智能体导入

1

打开代码库的设置

在范围选择器中选择该代码库,然后进入 What to review → Custom agents → New agent。
2

Import from repository

该标签页列出在默认分支上找到的 skills。点击 tenant-isolation。
3

检查结果

智能体以关闭状态创建,名为 Tenant isolation reviewer,已关联该 skill,指令如下:

步骤 3 — 细化指令

保留对 skill 的引用,并补充一条发现需要什么证据:
Instructions

步骤 4 — 可选:插件

如果您的任务跟踪工具已作为插件安装,可在 Tools → Plugins 中开启它。只会提供读取类工具。当拉取请求描述中链接了工单时,智能体可以读取工单,并检查变更是否符合其要求。

步骤 5 — 评论

点击 Save。

步骤 6 — Try it

在一个新增了端点的拉取请求上运行 Try it。检查:
  • Skills opened 列出了 .claude/skills/tenant-isolation,并在智能体需要时列出 references/tenant-tables.md。
  • 保留的发现引用了 skill 中的规则:
  • 被丢弃的发现会显示原因。skill 未覆盖的一般性安全意见会因超出智能体的关注范围而被丢弃,这正是此处想要的效果。
开启该智能体。之后如果想对某个打开的拉取请求再听一次意见,可以评论 @kody -v tenant-isolation-reviewer。

检查清单

  • SKILL.md 包含与文件夹名一致的 name 以及 description
  • 参考文件最多位于 skill 下一层文件夹中
  • 指令说明了一条发现需要什么证据
  • 最低严重程度符合智能体应有的”音量”
  • 已在一个已知存在问题的拉取请求上试运行
检测和预算的说明,请参阅 Skills & docs。