在与 AI 助手（如 OpenCode、Claude Code 等）协作开发时，你是否希望它能遵循特定的、可复用的最佳实践？例如，按照团队规范生成 Git 提交信息、执行代码检查，或者像一位专业小说家那样构思完整故事。
OpenCode Agent Skill 正是为此而生。它允许我们将这些标准化的工作流程封装成一个个“技能”，让 AI 能够像调用工具一样精准、高效地执行复杂任务。
什么是 Agent Skill？
本质上，一个 Skill 就是一份包含元数据（YAML Frontmatter） 和具体指令（Markdown 正文） 的 .md 文件。它的核心结构非常简单：
—
name: your-skill-name
description: 清晰、具体地描述这个技能的功能
—
## 详细指令
这里用自然语言详细描述你希望 AI 执行的步骤、遵循的规则和注意事项。
AI 会根据 name 和 description 来发现并决定是否调用该 Skill。一旦被调用，详细指令 部分的内容就会作为核心上下文注入，指导 AI 的行为。
如何加载一个 Skill？
加载 Skill 非常简单，你只需要把准备好的 Skill 文件夹放到正确的目录下。根据官方指南，主要有两种存放方式：
- Windows: C:\\Users\\你的用户名\\.config\\opencode\\skill\\
- macOS/Linux: ~/.config/opencode/skill/
- .opencode/skill/
- .claude/skills/ (兼容 Claude Code 的路径)
具体操作步骤：
放置 Skill：假设你从 GitHub 下载了一个名为 chinese-novelist 的 Skill 文件夹，将其完整地复制到上述任一目录中。确保路径结构如下：
~/.config/opencode/skill/chinese-novelist/SKILL.md
重启 OpenCode：让 OpenCode 重新扫描并识别新放置的 Skill。
验证 Skill：在对话中直接询问 AI：“请列出你所有可用的 Skills”。AI 应该会返回包含 chinese-novelist 及其 description 的列表。
使用 Skill：当你想让 AI 创作小说时，只需在对话中说：“使用 chinese-novelist 技能，帮我写一部关于外星文明的科幻小说”。AI 会自动加载该 Skill，并按照其内置的“五问确认”、“三阶段创作”等流程开始与你协作。
实例参考：chinese-novelist-skill
为了更直观地理解 Skill 的强大，我们可以看看 GitHub 上这个有趣的示例：chinese-novelist-skill。
这个 Skill 将 AI 变成了一个结构化的中文小说创作助手。它内置了：
- 标准化的创作流程：通过“5 问逐一确认”收集核心设定 → 展示规划并二次确认 → 进入“疯狂创作模式”一气呵成。
- 专业的内置指南：包含章节结构、悬念设置、人物塑造、质量检查清单等参考文档。
- 可靠的输出质量：遵循“展示而非讲述”、“冲突驱动剧情”、“悬念承上启下”等核心法则。
加载这个 Skill 后，AI 就不再是一个只会生成零散段落的通用模型，而是一个懂得如何规划长篇故事、保持人物连贯性、并在每章结尾设置悬念的“结构化写手”。
总结
OpenCode Agent Skill 提供了一种轻量级、可复用的方式来扩展 AI 助手的能力边界。无论是为了统一团队的开发规范，还是为了解锁如“AI 小说家”这样的创意工作流，掌握 Skill 的加载与使用都是一项极具价值的技能。
下一步行动：现在就尝试把你找到的或自己编写的 Skill 放到正确的目录下，让你的 AI 助手即刻获得新的“超能力”吧！
