实施指南

技能开发准备

首先，确认技能系统的可用性。虽然当前显示无可用技能，但可以根据OpenCode文档创建自定义技能。需要设置技能目录，如~/.claude/skills/或项目级.opencode/skills/。

准备工作包括安装必要的依赖和配置SkillMcpManager。确保技能目录存在并可写。

核心技能实现

创建路由技能，用于确定性模板选择：

{
  "name": "openspec-router",
  "description": "根据用户意图选择OpenSpec模板",
  "triggers": ["proposal", "spec", "change"],
  "actions": {
    "analyze_intent": "解析输入并匹配模板",
    "select_template": "从可用模板中选择最匹配的"
  }
}

验证技能示例：

function validateOutput(output, template) {
  // 检查输出结构是否符合模板要求
  const requiredSections = template.sections;
  for (let section of requiredSections) {
    if (!output.includes(section)) {
      throw new Error(`缺少必需章节: ${section}`);
    }
  }
  return true;
}

配置与集成

在opencode.json中添加技能配置：

{
  "skills": {
    "openspec-router": {
      "path": "~/.claude/skills/openspec-router/",
      "enabled": true
    },
    "output-validator": {
      "path": "~/.claude/skills/output-validator/",
      "enabled": true
    }
  }
}

确保技能在工作流启动时自动加载。

测试与部署

实施后，进行多模型测试：使用相同输入，在Claude、GPT等模型下运行工作流，比较输出一致性。目标是输出差异率低于5%。

部署时，先在开发环境测试，然后逐步推广。监控技能性能，避免加载延迟影响用户体验。

维护指南

定期更新技能以适应新模板。建立技能版本控制，确保向后兼容。监控错误日志，及时修复技能相关问题。