Opencode: 创建自定义Skill，以基金公司实习日报为例

关注

原创 2026-05-17 17:29:27 443 阅读 AI 写同款· GEO 优化 ›

OpenCode智能编程框架：自定义Skills开发指南智能编程辅助工具通过模块化扩展显著提升开发效率，其核心在于将代码补全、规范检查等能力封装为可复用的Skills模块。以OpenCode框架为例，开发者可基于Python/Java等技术栈创建定制化Skills，实现跨语言智能提示、API规范校验等场景。这类工具通过预训练语言模型和钩子机制，在代码保存、提交等关键节点自动触发检查，结合CI/CD集成可构建自动化代码质量防线。典型应用包括Spring参数校验、团队规范统一等场景，实测能使代码补全准确率提升40%，Code Review时间减少60%。阅读详情

说明：本文以全局Skill为例。项目skill只是路径有点差异。

一、全局Skill的路径与文件创建

其中 songroom为user名，全局skill的路径为：

C:\Users\songroom\.config\opencode\

创建skills目录后，新建一个xxfund-intern-report目录。这个就是自定义skill的名字。
注意，分隔号“-”。

(base) PS C:\Users\songroom\.config\opencode\skills\xxfund-intern-report> ls


    目录: C:\Users\songroom\.config\opencode\skills\xxfund-intern-report


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----        2026-05-16     20:33                assets
d-----        2026-05-16     20:34                data
d-----        2026-05-16     20:33                references
d-----        2026-05-16     20:34                scripts
-a----        2026-05-17      9:38           1953 SKILL.md

其中，assets,data,references,scripts都是空的，可以根据自身skill的需要配置。这里重要介绍一下SKILL.md。

二、准备SKILL.md

在这里创建的实习生报告skill的markdown文件格式如下：

# YAML
---
name: xxfund-intern-report
description: 根据提供的实习的工作内容，生成实习报告。当用户输入"生成实习日报"，"生成实习总结报告"时触发。
---

# 核心指令
## 通常步骤
- 第一步：读取 D:\intern_work\实习工作.md 内容。
- 第二步：根据内容，按输出文件要求、报告内容结构要求，生成相应的实习报告。
## 报告日期确定
- 默认生成最近一天的实习日报。如果用户指定生成具体某一天，则生成指定日期的实习报告。如果用户指定是总结报告，就是最后一天的总结报告。
- 如果历史上曾经生成过某一天的实习日报，第2次生成某日实习报告，则报告名称后面加序号。如：德邦基金实习日报_20260430（第2次生成）.docx。
## 输出文件要求
- 实习的报告，全部以word文件格式输出。
- 文件名最后写上当天报告生成的日期。下面是参考：
  - xx基金实习日报_20260430.docx
  - xx基金实习总结报告_20260501.docx
- 输出文件存放目录在: D:\intern_work\report\
- 实习字体统一用宋体。
- 报告署名：王小二

## 日报内容结构要求，必须包括以下内容：
- 上日完成的工作
- 本日完成的工作
- 工作中存在问题
- 下一步工作的计划
- 以李白的两句诗句来结尾。
## 实习总结报告内容结构要求，必须包括以下内容：
- 实习期间工作总结
- 实习期间收获
- 实习期间还有待完成的事项
- 下一步工作计划
- 致谢
- 以苏东坡的两句诗来结尾。
## 错误处理
- 如果没有发现D:\intern_work\实习工作.md 文件，则直接报错，提示"请存放相应的实习工作内容文件"。

## 禁止事项
- 不能删除任何文件，特别是D:\intern_work\实习工作.md。

注意坑：

- name:后要隔着1个空格！description:也一样
- name名字要和文件夹名字一样
- -不要用成_
- 尽量用英文

三、用opencode来验证

你可以让Opencode来验证你创建的skill是否有效。比如在opencode对话框中输入：

我生成了我的创建的skill xxfund-intern-report,请检查一下这个skill是否可用，如果有任何问题，请帮我指出，并进行修复。

输出：

验证通过项：
- 
✅ 文件名 SKILL.md（全部大写）
- 
✅ name = xxfund-intern-report，符合正则 ^[a-z0-9]+(-[a-z0-9]+)*$
- 
✅ name 与文件夹名一致
- 
✅ description 长度合规（1-1024字符）
- 
✅ 存放路径正确：~\.config\opencode\skills\xxfund-intern-report\SKILL.md
使用前请注意：
- 
需确保 D:\intern_work\实习工作.md 文件存在，否则 skill 会报错提示"请存放相应的实习工作内容文件"
- 
输出目录 `D:\intern

四、opencode.jsonc文件

opencode.jsonc文件在：

(base) PS C:\Users\songroom\.config\opencode> ls


    目录: C:\Users\songroom\.config\opencode


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----        2026-05-05     10:57                node_modules
d-----        2026-05-17      9:36                skills
-a----        2026-03-08     13:37             45 .gitignore
-a----        2026-03-21     10:25            711 bun.lock
-a----        2026-05-17      9:59            132 opencode.jsonc
-a----        2026-05-05     10:57          13560 package-lock.json
-a----        2026-05-05     10:57             65 package.json

原始的文件如下：

{
  "$schema": "https://opencode.ai/config.json"
}

进行"permission"设置：“xxfund-intern-report”: “allow”

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": {
      "xxfund-intern-report": "allow"
    }
  }
}

关于opencode相关配置文件，可以参考：

https://www.studynil.com/ai/ai-tools/opencode/config.html

五、原始数据的准备

在这里插入图片描述完成上面验证后，后面就是准备原始数据了。

1、原始数据和report存放目录创建

(base) PS D:\> cd intern*
(base) PS D:\intern_work> ls

    目录: D:\intern_work

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----        2026-05-17      9:51                report
-a----        2026-05-16     21:21           1170 实习工作.md

2、实习工作内容【谨供测试用】
以下是“实习工作.md”的内容：

# 实习工作
## 2026-5-14
- 超融合采购及集团关联交易安排[集团已经回复]
- HS包年落实[下周沟通一下未达成共识的部分，较急]
- 投研平台（人员落实、立项、测试等）[待立项]
- 算法交易[下周交易部要进行MC会议汇报,准备PPT]

## 2026-5-15
- HS包年落实：正在安排A角和B角，A角到位，但B角还没到位。
- 公众号进展 ：[周三+周五两次会议,下周重点要推进HSAPI4.0接口议标]
- 网站梳理，内容更新[拟下周一安排相关部门会议沟通，会议通知还没发]
- 打新梳理汇报：HS场外打新系统进行沟通交流[HS场外交易系统会议]
- RPA事项（JQW+TA稽核等）：[母公司还没有反馈]
- 绩效归因（项目人员、需求、开发配合）自研[固定收益部的需求还没明确，没有人安排，缺少人手！]
- FA4.5升级及周边落实[外部接口招标，还没完成]

## 2026-5-16
- 周末休息

六、测试

在opencode中输入：

请帮我生成xx基金公司实习日报

输出：
在这里插入图片描述

可以看出，基本达到预期。

七、总结

1、有点坑，需要特别注意。比较多在格式上，比如name：要空1格等。
2、opencode.jsonc的设置。
其它还好。

收录于

人工智能

标签

#人工智能

opencode与skill实战：AI编程代理的开源终端方案与技能扩展机制在AI编程工具快速演进的当下，终端型AI代理（coding agent）正成为开发者提效的新范式。开源工具opencode通过统一的模型接入层，支持DeepSeek、Qwen及本地Ollama等任意OpenAI兼容服务，解决了闭源工具模型绑定的痛点。而skill机制本质上是系统提示词的模块化封装，以SKILL.md为核心将领域知识、工作流程沉淀为可复用的能力包，与MCP（外部工具连接器）形成“知道怎么做”与“能调用什么”的互补关系。这种“终端+技能包”的组合，让AI不仅能理解任务，还能按标准化流程执行代码审阅读详情