1. 项目概述
"从Prompt到Skill：我的第一个Skill诞生记"这个标题揭示了当前AI领域一个重要的技术演进方向——如何将零散的prompt提示词转化为可复用的标准化skill技能。作为一名长期关注大语言模型(LLM)应用的开发者，我发现这个转变过程蕴含着许多值得探讨的技术细节和实践经验。
在传统prompt engineering中，我们往往需要针对每个具体任务反复调试提示词。而skill的概念则将这种临时性的交互固化为可重复调用的功能模块，就像把一段临时编写的脚本升级为正式的函数库。OpenCode的skill-creator工具正是实现这一转变的关键桥梁。
2. 核心概念解析
2.1 Prompt与Skill的本质区别
Prompt（提示词）是单次交互的临时指令，具有以下特点：
- 上下文敏感：效果严重依赖对话历史
- 难以复用：需要针对每个场景重新设计
- 调试困难：缺乏系统化的评估方法
Skill（技能）则是标准化的可复用单元，其特征包括：
- 独立封装：包含完整的描述和触发条件
- 版本管理：支持迭代优化和AB测试
- 量化评估：内置自动化测试框架
2.2 Skill的核心组成要素
一个完整的Skill通常包含以下组件：
- 元数据描述：定义技能名称、用途和触发条件
- 执行逻辑：具体的操作步骤和决策流程
- 测试用例：验证技能正确性的输入输出样本
- 评估指标：量化技能效果的metrics体系
3. 开发环境搭建
3.1 OpenCode技能创建工具安装
推荐使用npm全局安装方式：
npx opencode-skill-creator install --global安装后需要验证：
npx opencode-skill-creator --version npx opencode-skill-creator --help3.2 开发目录结构规范
建议采用以下项目结构：
my-skill/ ├── SKILL.md # 主技能文件 ├── agents/ # 子代理定义 │ └── evaluator.md # 评估逻辑 ├── tests/ # 测试用例 │ ├── positive/ # 应该触发的输入 │ └── negative/ # 不应触发的输入 └── templates/ # 输出模板 └── response.md # 响应格式4. 技能开发全流程
4.1 需求分析与技能设计
以开发"Docker Compose助手"技能为例：
确定核心功能：
- 生成docker-compose.yml模板
- 检查现有配置语法
- 推荐优化方案
设计触发短语：
- "帮我写个docker-compose文件"
- "检查这个compose配置"
- "优化docker-compose性能"
4.2 技能实现与测试
SKILL.md示例结构：
--- name: docker-compose-helper description: 帮助创建、检查和优化docker-compose配置 triggers: - "docker compose" - "docker-compose" - "容器编排" --- # Docker Compose助手 ## 功能 1. 根据用户需求生成docker-compose.yml 2. 分析现有配置并提供优化建议 3. 检查常见配置错误 ## 示例 用户: 我需要一个包含MySQL和Redis的compose文件 助手: 已生成标准配置，需要添加特定参数吗？4.3 自动化测试集构建
创建测试用例文件tests/eval.json：
{ "shouldTrigger": [ {"input": "写个docker-compose文件"}, {"input": "检查这个compose配置"} ], "shouldNotTrigger": [ {"input": "怎么安装Docker"}, {"input": "容器是什么"} ] }5. 技能优化方法论
5.1 评估驱动开发(Eval-Driven Development)
训练/测试集划分：
- 60%样本用于迭代优化
- 40%样本用于最终验证
多轮测试机制：
- 每个测试用例执行3次
- 计算平均触发准确率
优化循环：
graph TD A[初始技能] --> B[生成测试集] B --> C[执行评估] C --> D{达标?} D -->|否| E[分析失败模式] E --> F[改进描述] F --> B D -->|是| G[发布技能]
5.2 关键优化技术
触发词扩展：
- 使用同义词生成器扩充触发短语
- 合并用户实际查询中的自然表达
描述精细化：
- 添加边界条件说明
- 包含典型误触发示例
上下文增强：
- 预置常见后续问题
- 设计多轮对话流程
6. 实战案例：API文档生成技能
6.1 技能设计要点
输入处理：
- 解析代码注释
- 识别端点定义
- 提取参数说明
输出规范：
- 标准OpenAPI格式
- 分级标题结构
- 示例请求/响应
6.2 性能优化记录
| 迭代版本 | 触发准确率 | 主要改进点 |
|---|---|---|
| v0.1 | 62% | 基础触发词 |
| v0.2 | 78% | 添加代码模式识别 |
| v0.3 | 89% | 优化错误处理逻辑 |
| v1.0 | 95% | 引入上下文感知 |
7. 常见问题与解决方案
7.1 技能不触发问题排查
检查步骤：
- 确认技能文件位置正确
- 验证openCode.json配置
- 检查触发短语相关性
诊断命令：
npx opencode-skill-creator diagnose --skill=docker-compose-helper
7.2 误触发处理方案
负样本强化：
- 收集实际误触发案例
- 添加到shouldNotTrigger测试集
- 调整触发条件约束
上下文限定：
triggers: - "docker compose" context:code - "容器编排" context:devops
8. 进阶技巧与最佳实践
8.1 技能组合模式
子技能分解：
agents: - name: compose-generator description: 生成基础模板 - name: compose-optimizer description: 配置优化建议技能调用链：
def handle_request(input): if "生成" in input: return invoke("compose-generator", input) elif "优化" in input: return invoke("compose-optimizer", input)
8.2 版本控制策略
语义化版本：
- MAJOR：接口变更
- MINOR：功能新增
- PATCH：问题修复
变更日志规范：
## [1.2.0] - 2023-08-15 ### Added - 支持Kubernetes配置转换 ### Fixed - 网络别名解析问题
9. 技能分发与共享
9.1 私有技能仓库搭建
目录结构：
skills-repo/ ├── docker/ │ ├── docker-compose-helper/ │ └── dockerfile-validator/ └── api/ ├── openapi-generator/ └── postman-collection-exporter/同步脚本：
#!/bin/bash rsync -avz ./skills/ user@server:/var/opencode/skills/
9.2 公共技能市场规范
提交要求：
- 完整的测试覆盖率
- 清晰的文档说明
- 版本兼容性声明
质量检查清单：
- [ ] 触发准确率 >90%
- [ ] 包含使用示例
- [ ] 明确适用场景
10. 未来演进方向
10.1 技能自适应学习
动态调整机制：
- 记录用户实际查询
- 自动扩展触发短语
- 持续优化响应模板
个性化适配：
variants: - for: beginner examples: 基础配置示例 - for: expert examples: 高级调优技巧
10.2 多模态技能开发
图文混合输出：
response_template: | {{text}}  {{code}}交互式组件：
- 内嵌表单输入
- 实时配置预览
- 可视化拓扑展示
通过这个完整的技能开发历程，我们不仅实现了从临时prompt到标准化skill的转变，更重要的是建立了一套可复用的技能工程方法论。在实际项目中，这种标准化技能相比临时prompt可以提升3-5倍的开发效率，同时将触发准确率从随机调试的60%提升到系统优化的95%以上。
 agent和组件)