告别重复提示词！ZCode Skill.md 完全指南：打造你的专属 AI 编程工作流

在使用 AI 编程助手时，你是否经常遇到这样的痛点：每次让 AI 做 Code Review，都要重复输入一堆检查标准；每次写发版说明，都要重新描述格式要求？

在 ZCode 中，通过引入 Skill（技能） 机制，这些问题将迎刃而解。今天我们就来手把手教你如何利用 SKILL.md 文件，让 ZCode Agent 拥有“肌肉记忆”，实现标准化、流水线式的智能开发。

---

🧠 什么是 Skill？为什么需要它？

Skill 是一组可复用的工作说明。 它的本质是一个 SKILL.md 文件，用于向 Agent 明确界定：在什么场景下触发、按什么步骤处理、输出什么格式的内容。

在 ZCode 中，Skill 主要围绕内置的 ZCode Agent 运行，非常适合沉淀以下能力：

• 项目开发规范与脚手架
• 文档协作与生成
• 自动化测试验证
• 飞书工作流对接

💡 什么时候该用 Skill？

• 任务有固定流程（如：接口排查、提单检查）。
• 团队对输出有严格格式要求（如：特定结构的发版说明）。
• 任务需要附带背景知识、检查清单或模板。
• 同一套逻辑会在多个项目或多次对话中重复使用。

(注：如果只是保存一句简单的提示词，使用 ZCode 的 Command 即可；如果需要一套完整的工作方法论，Skill 才是最佳选择。)

---

🛠️ 技能管理：一切尽在掌控

在 ZCode 中管理技能非常直观。点击进入 设置 -> 技能 页面，你可以：

1. 全局概览：按来源（全局、项目、外部导入）查看所有技能，清晰展示名称、描述和状态。
2. 快速检索：通过搜索框按名称秒级筛选。
3. 动态启停：通过右侧的开关，随时启用或停用某个技能，无需删除。
4. AI 辅助创建：点击右上角的 新建技能，ZCode 甚至会引导你在聊天框中直接让 Agent 帮你生成一个新技能！

---

📝 如何创建一个自定义 Skill？

一个技能在物理层面上就是一个目录 + 一个 SKILL.md 文件。目录名即技能名。

1. 找到用户级技能目录

ZCode Agent 的用户级技能存放在以下路径：

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

2. 编写 SKILL.md

一个最小且可用的 SKILL.md 示例（支持 YAML Front Matter）：

---
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.

在具体业务中，你可以在这里补充更详细的 Checklist 条目、代码规范链接或输出 Markdown 模板。

3. 刷新并生效

创建或修改保存后，回到 ZCode 的 设置 -> 技能 页面，点击 刷新 按钮。确认你的技能出现在列表中，并保持开关处于开启状态。

---

🚀 亮点功能：一键导入外部 Agent 技能

如果你之前已经在 Claude Code、Codex CLI、OpenClaw、Augment、Windsurf 等其他 AI 编程工具中积累了大量精心调教的技能，完全不需要在 ZCode 里重新手敲！

在 设置 -> 技能 页面右上角点击 导入 图标，ZCode 会自动扫描这些外部工具的技能目录。

在导入弹窗中，你可以进行精细化控制：

• 分组查看：按外部 Agent 分类，显示对应目录路径和可导入数量。
• 批量勾选：支持全选，顶部实时显示已选数量。
• 选择导入方式（核心）：
  • 软链：创建指向外部目录的快捷方式。优点：外部工具更新了技能，ZCode 这里自动同步；缺点：如果删了外部工具的目录，这里会失效。
  • 复制：将技能完全拷贝为 ZCode 的独立副本。优点：解耦，不怕源文件被删；缺点：后续需要手动在 ZCode 内维护更新。
• 选择导入目标：可导入为全局（所有项目可用）或当前项目（仅限当前工作区）。

---

💬 在聊天中如何调用 Skill？

一切准备就绪，在实际开发中如何触发？极其简单！

在 ZCode 的聊天输入框中，输入美元符号 $，就会弹出技能选择面板。选中需要的技能后，它会以标签形式吸附在输入框内，你只需在后面补充具体的指令即可。

实战演示：

$code-review-checklist 帮我 review 当前改动，重点关注并发问题
$release-notes 根据这次提交写一版发版说明，发到飞书群里

此时，ZCode Agent 会在后台将你引用的 SKILL.md 内容注入到当前上下文中，严格按照你预设的流程、标准和格式来执行任务。

---

总结

SKILL.md 不仅是一个配置文件，更是团队工程经验的代码化沉淀。通过 ZCode 提供的 Skill 机制与跨平台导入功能，我们可以轻易地将 AI 编程从“随口提问”升级为“标准化作业流水线”。

强烈建议大家花 10 分钟，把日常最高频的几个开发动作（如单测生成、代码审查、Bug 排查模板）写成 Skill。一旦习惯了这种“$一下就干活”的优雅体验，你绝对会回不去以前手动输长提示词的日子了！