技能（Skills）

**技能（Skill）**是一份给 Agent 的「操作手册」：一个包含 SKILL.md 的文件夹，描述某类工作该怎么做。激活技能后，它的指令会注入任务，Agent 还能按需读取技能附带的参考文件与脚本。

技能的格式

一个技能就是一个文件夹，最少只需要一个 SKILL.md：

review-code/
├── SKILL.md          # 必需：技能定义
├── references/       # 可选：参考资料（清单、规范……）
├── scripts/          # 可选：可执行脚本
├── assets/           # 可选：静态资源
└── templates/        # 可选：模板文件

SKILL.md 使用 YAML frontmatter 定义元信息：

---
name: review-code
description: Review code changes for correctness, security, regressions,
  and maintainability.
version: 1.0.0
---

# Review workflow

Inspect the changed files, read `references/checklist.md` when needed,
run focused validation, and report findings in priority order.

提示：description 决定 Agent 在什么场景下使用这个技能——把它写成「何时用 + 能做什么」，效果最好。

技能从哪里来

VibeSpace 会扫描以下目录，并把找到的技能汇总到「技能 · 插件」页：

不同来源的同名技能会同时保留，列表按来源排序展示（工作区技能在前、内置技能在后），你可以自由启用其中任何一个。

启用与停用

1. 打开「技能 · 插件」导航；
2. 浏览技能列表，查看名称、描述、来源与版本；
3. 用开关控制每个技能的启用状态——只有启用的技能会在新建任务时可选；
4. 首次使用内置技能时需要确认一次（技能不会暗中扩大权限）。

技能列表发生变化时（新增、修改目录），可点击刷新让 VibeSpace 重新扫描。

实用场景

• 团队规范：把「代码审查清单」「提交信息规范」「发版步骤」写成技能，提交到工作区的 .claude/skills/ 并纳入版本管理；
• 复杂流程：把需要多步骤、多文件配合的流程（如「上线前检查」）沉淀为技能，避免每次在提示词里重复解释；
• 跨工具复用：已有的 Claude / Codex 技能目录无需迁移，VibeSpace 直接识别。

编写建议

• 一个技能聚焦一类工作，不要做成大杂烩；
• 需要长参考资料时放进 references/，在 SKILL.md 里指明何时读取——Agent 会按需加载，不浪费上下文；
• 脚本放在 scripts/ 中的技能仍受权限模式约束，执行命令同样要过审批。