Skill

Skill 是一组可复用的工作说明。它通常用一个 SKILL.md 描述触发场景、处理步骤和输出要求，让 Agent 在遇到特定任务时按同一套标准执行。

在 ZCode 中，当前主要建议关注两类来源：

• ZCode Agent：适合在 ZCode 内置 Agent 中使用，推荐放项目开发、文档协作、测试验证、飞书工作流等常用能力。
• Claude CLI：适合复用 Claude Code CLI 的技能生态，也可以放团队已经沉淀好的 CLI 工作流。

管理技能

进入 设置 -> 技能 后，可以按来源查看技能。列表里会展示技能名称、来源标签、描述和启用开关。

你可以在这里完成几件事：

• 通过搜索框按名称筛选技能。
• 在 ZCode Agent 和 Claude CLI 之间切换来源。
• 使用右侧开关启用或停用技能。
• 点击右上角 新建技能 创建新的技能配置。

创建技能

一个技能本质上是一个目录加一个 SKILL.md 文件。目录名就是技能名，聊天中也会用这个名字引用。

ZCode Agent 的用户级技能目录：

~/.agents/skills/<skill-name>/SKILL.md

Claude CLI 的用户级技能目录：

~/.claude/skills/<skill-name>/SKILL.md

一个最小可用的 SKILL.md 示例：

---
name: code-review-checklist
description: Review code changes with a focused checklist for correctness, regressions, tests, and maintainability.
---

# Code Review Checklist

Use this skill when reviewing a pull request, merge request, or local diff.

Focus on correctness, regressions, missing tests, risky API changes, and maintainability.

创建或修改后，回到 设置 -> 技能 点击 刷新，确认技能出现在对应来源下，并保持开关开启。

在聊天中使用

在输入框中输入 $，选择需要的技能。选中后，技能会以标签形式出现在输入框里，你可以继续补充具体需求。

比如：

$code-review-checklist 帮我 review 当前改动

$release-notes 根据这次提交写一版发版说明

ZCode 会把被引用的技能交给当前 Agent，让它按技能里的说明处理任务。

适合沉淀成 Skill 的内容

• 任务有固定流程，例如 code review、接口排查、发版说明、测试报告。
• 团队对输出格式有固定要求。
• 任务需要附带背景知识、检查清单、模板或示例。
• 同一个能力会在多个项目或多次对话里重复使用。

如果只是保存一句简单提示词，可以优先使用 Command；如果需要一套完整工作方法，就更适合做成 Skill。

下一步