技能

把常用任务说明整理成技能，在对话中按需调用，保持熟悉的工作方法。

找到适合任务的技能

技能是带 YAML frontmatter 的 SKILL.md 文件。工作区技能位于 ~/.zero-works/workspaces/{workspace-slug}/skills/{skill-slug}/SKILL.md，项目技能位于工作目录的 .agents/skills/{skill-slug}/SKILL.md，全局技能位于 ~/.agents/skills/{skill-slug}/SKILL.md。
打开技能列表查看说明；在目标会话输入 @，按名称搜索并选择技能候选项，确认它是技能而不是同名来源。
需要新技能时，在上述任一目录创建以英文短名命名的技能文件夹，再创建 SKILL.md，按下节示例填写名称、描述和正文。

在对话中调用技能

确认当前工作区和工作目录正确；项目级技能从对应项目目录中发现。
在输入框输入 @，搜索 weekly-review 等技能名称，然后选择候选项，插入技能提及。技能入口是 @ 菜单，/ 菜单没有技能分类。
保留插入的技能标记，补充本次材料、范围与输出要求，再发送。

提示词示例

@weekly-review 请根据本次对话中的项目进展整理周报，分为已完成、待确认和下一步，不补写未提供的数据。

创建项目自己的技能

用普通编辑器创建 .agents/skills/weekly-review/SKILL.md。正文使用 Markdown，开头的 YAML frontmatter 至少包含 name 与 description；文件夹名 weekly-review 是调用时使用的技能标识。

在项目目录创建技能文件夹和 SKILL.md，写入下面的最小示例。
把稳定步骤写进正文，并说明所需材料与结果格式；本次任务材料留在对话里。
在该项目的会话中输入 @，搜索 weekly-review 并选择。未出现时检查路径、frontmatter 与同名覆盖，再重新载入工作区。
用一份小材料实际调用，确认输出符合规则。

代码示例

---
name: weekly-review
description: 根据已提供的项目进展整理每周回顾。
---

只使用用户提供的事实。
按“已完成、待确认、下一步”组织结果。
缺少负责人或日期时明确标注，不自行补写。

维护清楚可信的任务说明

创建或复制前先阅读来源和正文，确认它要求使用哪些材料与工具。
把稳定步骤写入技能，把本次任务的私有材料留在对话中。
调整自建技能后，用一个小任务检查输出是否符合预期。
不再需要时，移除自己管理的对应技能目录，并检查是否会显露出同名的工作区或全局技能。