C4 自动化脚本

💡 一句话总结：把重复流程写成"命令 + 脚本"，一键复用。

📝 课程笔记#

学完你能做什么#

你现在的困境#

什么时候用这一招#

🎒 开始前的准备#

确保你已经完成以下事项：

核心思路#

识别自动化机会#

自动化层次#

手动操作 → 一键命令 → 脚本化 →（可选）外部调度

可用工具/功能（OpenCode）#

跟我做#

第 1 步：描述你的重复任务（先要"规则"，再要"执行"）#

我每天都要做这些重复工作：
1. 把下载目录里的发票 PDF 移动到 财务/发票/ 目录
2. 按月份创建子目录（如 2025-01/）
3. 重命名为「发票_日期_金额.pdf」格式

请先做两件事：
A) 把规则写清楚（日期来源、金额来源、冲突如何处理）
B) 给一个“先预览、后执行”的方案

第 2 步：把流程固化成“自定义命令”#

方法一：用 Markdown 命令文件（推荐）#

命令文件位置（官方）：

/organize-invoices ~/Downloads ~/Documents/财务/发票

解释：

命令文件的“正文内容”就是模板（官方：opencode/packages/web/src/content/docs/commands.mdx:33～opencode/packages/web/src/content/docs/commands.mdx:34）。

!`date ...` 会把命令输出注入 prompt（官方：opencode/packages/web/src/content/docs/commands.mdx:164～opencode/packages/web/src/content/docs/commands.mdx:179）。

方法二：在 opencode.json 里用 JSONC 配置命令#

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "organize-invoices": {
      "template": "请把 $1 目录中的发票 PDF 整理到 $2：\n\n要求：\n1. 先输出操作清单（移动/重命名），不要直接执行\n2. 我确认后再执行\n",
      "description": "整理发票（归档 + 重命名）",
      "agent": "build",
      "model": "anthropic/claude-opus-4-5-thinking",
      "subtask": true
    }
  }
}

说明：

command.<name>.template 是必填（官方：opencode/packages/web/src/content/docs/commands.mdx:221～opencode/packages/web/src/content/docs/commands.mdx:236）。

description/agent/model/subtask 都是可选项（源码：opencode/packages/opencode/src/config/config.ts:49～opencode/packages/opencode/src/config/config.ts:55；官方：opencode/packages/web/src/content/docs/commands.mdx:57～opencode/packages/web/src/content/docs/commands.mdx:66）。

subtask: true 可强制走 subagent（官方：opencode/packages/web/src/content/docs/commands.mdx:77～opencode/packages/web/src/content/docs/commands.mdx:93）。

第 3 步：把“脚本”交给 AI 生成，但要求可测试#

根据刚才的规则，帮我创建一个脚本 scripts/organize_invoices.py：
1. 扫描源目录找 PDF
2. 解析日期/金额（如果解析不到也要给策略）
3. 生成目标目录结构
4. 输出详细日志（每个文件怎么处理）

要求：
- 把“预览模式（dry-run）”和“执行模式”都做出来
- 给我一条最小可运行命令

第 4 步：用 CLI 把自动化接到“脚本化调用”#

进阶：扩展功能#

使用 MCP 服务器（可选）#

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp_everything": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

用 /compact 保持会话“轻量”#

/compact

配置里的 env/file 变量替换（顺带纠正 provider.apiKey 写法）#

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  },
  "model": "anthropic/claude-opus-4-5-thinking",
  "small_model": "anthropic/claude-haiku-4-5"
}

检查点 ✅#

全部通过才能继续

踩坑提醒#

证据索引（本课涉及的 OpenCode 行为）#

本课小结#

下一步建议#