用 skill 结合 git 自动生成周报：TaoToken 统一 Key 接入 OpenCode Agent 的配置骨架

1. 周报这件事为什么值得交给 skill git 来做每周五下午打开空白文档回想这周改了哪些文件、修了哪些 bug、开了哪些会然后硬凑出三段话——这个场景你应该不陌生。更麻烦的是你明明提交了几十次 commit写了清晰的 message结果写周报时还得靠记忆一条条翻。git log 里躺着的事实和最终交上去的周报之间隔着一道纯手工的搬运工序。用 OpenCode Agent 的 skill 机制可以把这个工序自动化skill 负责定义「怎么读 git 记录、怎么组织周报结构、输出成什么格式」Agent 负责调用模型把原始提交信息改写成人类可读的周报语言而 TaoToken 的统一 Key 负责把模型通道这件事收敛成一个配置项。三者拼起来你只需要在项目里敲一句「生成周报」剩下的交给流程。这篇面向的是已经会用 git、装过 Node.js、想把手头重复劳动压缩掉的开发者。不需要你懂 Agent 框架原理配置骨架直接抄跑通一次之后你就能按自己的项目改 skill 的提示词。核心检索词就三个skill、git、自动生成周报全文围绕 OpenCode 这个开源 coding agent 展开。我试过把周报生成拆成「取数」和「改写」两段取数用 git 命令拿结构化数据改写交给模型。这样即使模型输出跑偏原始数据还在你可以随时回退到手动整理。下面从环境准备开始一步步把这条链路搭起来。2. TaoToken 统一 Key把模型通道收敛成一个配置OpenCode 支持多种模型接入方式但如果你同时用几个模型供应商每个项目配一遍 Key、改一次 base_url很快就会乱。TaoToken 在这里的角色是统一入口你拿到一个 Key通过同一个 API 地址访问不同模型OpenCode 的配置文件里只需要维护一份凭证。具体来说TaoToken 提供的是 OpenAI 兼容的 API 通道OpenCode 的 provider 配置里把 baseURL 指向https://taotoken.net/apiapiKey 填你在控制台生成的 Key模型名按需选择即可。这样做的直接好处是周报 skill 里不需要关心底层是哪个模型换模型只改一个字符串。你需要先做两件事。第一到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并进入控制台。第二在控制台的 API Keys 页面创建一个 Key复制保存。这个 Key 就是后面 settings.json 和 config.toml 里要填的值。注意Key 只显示一次创建后立刻复制到安全的地方。不要把它提交到 git 仓库建议放在项目根目录之外或用环境变量注入。如果你还没决定用哪个模型可以先到模型对话页面试几句确认通道通畅再写进配置。对于周报这种「读一段文本、输出一段文本」的任务中等规模的模型就够用不需要上最贵的。长期跑 coding agent 的话可以了解下 Coding Plan 的额度方案避免按次计费跑超。3. 可复制配置settings.json 与 config.toml 骨架OpenCode 的配置分两层全局配置放在用户目录下的~/.config/opencode/项目级配置放在项目根目录的.opencode/下。周报 skill 属于项目级能力所以我们在项目里建目录。先看目录结构your-project/ ├── .opencode/ │ ├── config.toml │ └── skill/ │ └── weekly-report/ │ └── SKILL.md ├── src/ └── .git/3.1 settings.json凭证与 provider 声明OpenCode 读取模型凭证的方式之一是settings.json放在~/.config/opencode/settings.json。如果你更习惯用环境变量也可以跳过这步直接在 config.toml 里引用{env:TAOTOKEN_API_KEY}。下面是 settings.json 的骨架{ providers: { taotoken: { type: openai-compatible, options: { baseURL: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } } } }这里type填openai-compatible因为 TaoToken 的通道兼容 OpenAI 的请求格式。baseURL结尾不要多加/v1OpenCode 会自己拼接路径。apiKey就是你在控制台创建的那串。3.2 config.toml模型选择与 skill 挂载项目级的.opencode/config.toml决定这个项目用哪个模型、加载哪些 skillmodel taotoken/gpt-4o-mini [provider.taotoken] baseURL https://taotoken.net/api apiKey {env:TAOTOKEN_API_KEY} [skill] paths [.opencode/skill]model字段的格式是provider名/模型名provider 名要和 settings.json 里的键一致。如果你把 Key 放在环境变量里用{env:TAOTOKEN_API_KEY}引用然后在 shell 里export TAOTOKEN_API_KEYsk-xxx。[skill]段告诉 OpenCode 去哪个目录找 skill 定义。3.3 SKILL.md周报 skill 的核心提示词skill 的本质是一份 Markdown 说明告诉 Agent 这个技能叫什么、什么时候触发、执行什么步骤。在.opencode/skill/weekly-report/SKILL.md里写入--- name: weekly-report description: 读取当前 git 仓库本周的提交记录生成结构化工作周报 --- # 周报生成技能 当用户要求生成周报时执行以下步骤 1. 运行 git log --since7 days ago --prettyformat:%h|%an|%ad|%s --dateshort 获取最近 7 天的提交。 2. 运行 git diff --stat HEAD~20 HEAD 获取改动文件统计若提交不足 20 条则用全部。 3. 将提交信息按类型归类feat / fix / docs / refactor / chore。 4. 输出周报包含四个部分本周完成、修复问题、文档与重构、下周计划。 5. 语言简洁每条不超过两行不要编造 git 记录里没有的内容。frontmatter 里的name和description是触发依据Agent 会根据 description 判断用户意图是否匹配。正文里的步骤就是执行清单写得越具体输出越稳定。4. 验证请求触发一次 skill 并检查周报输出配置写完后进入项目目录确认 git 仓库有本周的提交。如果是个新项目没提交先随便改个文件提交一次否则 git log 返回空skill 没数据可读。启动 OpenCodecd your-project opencode进入交互界面后输入触发语句生成周报Agent 会匹配到 weekly-report skill依次执行 git 命令然后把结果交给模型改写。正常情况下你会看到类似输出## 本周完成 - 实现用户登录接口的参数校验a1b2c3d - 新增订单导出 CSV 功能e4f5g6h ## 修复问题 - 修复分页参数越界导致的 500 错误i7j8k9l ## 文档与重构 - 更新 README 的部署说明m0n1o2p - 抽取公共请求方法减少重复代码q3r4s5t ## 下周计划 - 补充登录接口的单元测试 - 调研导出功能的性能优化如果输出里出现了 git 记录中不存在的条目说明模型在「发挥」这时候要回到 SKILL.md 里加强约束比如加一句「所有条目必须能在 git log 中找到对应 commit hash」。验证通过的标准很简单周报里的每一条都能在git log里找到出处。想确认模型通道本身没问题可以单独到模型对话页面发一句测试排除是 Key 或 baseURL 配错导致的失败。5. 本篇常见错排查跑不通的情况基本集中在这几类按顺序排查效率最高。报错provider not found或model not foundconfig.toml 里的model字段格式是provider名/模型名provider 名必须和 settings.json 里的键完全一致。如果你在 settings.json 里写的是taotokenconfig.toml 里就不能写成tao-token。模型名也要和 TaoToken 支持的名称对齐写错会直接报找不到。报错401 UnauthorizedKey 无效或没被读到。先确认环境变量是否在当前 shell 生效echo $TAOTOKEN_API_KEY看有没有值。如果用的是 settings.json 里的明文 Key检查有没有多余空格。Key 失效的话到 API Keys 页面重新生成一个。skill 不触发Agent 直接回答description 写得太泛或者用户输入和 description 匹配度低。把 description 改得更具体比如加上「当用户说生成周报、写周报、本周总结时触发」。另外确认.opencode/skill路径在 config.toml 的[skill]段里声明了。git log 返回空当前目录不是 git 仓库或者本周确实没有提交。用git log --oneline -5确认仓库状态。如果是浅克隆shallow clone历史提交可能不全git fetch --unshallow补全。输出内容包含敏感信息git commit message 里如果有内部系统地址、账号等会被模型读到并可能写进周报。建议在 SKILL.md 里加一条过滤规则或者在提交规范里约定 message 不写敏感内容。中文乱码git log 的编码和终端不一致。在 git 命令前加LANGen_US.UTF-8或者在 SKILL.md 里指定输出编码。排查时建议先手动跑一遍 SKILL.md 里的 git 命令确认数据源正常再让 Agent 执行。这样能把「取数问题」和「模型问题」分开定位。6. 把周报流程固定下来的几个建议跑通一次之后你可以把触发语句做成 shell 别名比如alias wropencode run 生成周报省去进交互界面的步骤。skill 的提示词也可以按团队规范调整比如加上「按项目模块分组」或「输出 Markdown 表格」。如果周报要发给非技术同事可以在 SKILL.md 里加一步「把 commit message 里的技术术语翻译成业务语言」让模型做二次改写。但记住保留原始 commit hash 作为脚注方便追溯。长期用下来模型通道的稳定性比模型能力更重要。TaoToken 的统一 Key 让你在换模型时不用改 skill 逻辑这是把配置和业务解耦的价值。接入文档里有更完整的 provider 参数说明遇到配置项不确定时可以去查。需要管理多个项目的 Key 时控制台可以按项目创建不同的 Key方便区分用量。最后提醒一句skill 生成的是草稿交之前花两分钟扫一遍把模型可能误判的条目删掉。自动化省的是搬运时间判断哪些工作值得写进周报还是你自己的事。