Skills-SIMarket
skills-si.com
Proposer une Skill
/
L’interface est localisée ; les présentations et documents des Skills sont traduits automatiquement par IA dans votre langue. Le code, les commandes, chemins et termes techniques restent en version originale, et le document de l’auteur fait foi.
Explorer les Skills
Déploiement et opérations · SKILL.md

my-opencode-deepseek-config

my-opencode-deepseek-config

Use when deploying, tuning, or extending the OpenCode × DeepSeek V4 optimal configuration (orchestrator routing, 12 agents, thinking tiers, prompt-cache prefix discipline, DCP compaction, permissions baseline, 25 skills, slash commands) — installing to another machine, adding an agent or skill, adjusting model routing/cost, or troubleshooting why an agent r…

Independent GitHub snapshot · Automated classification · Original documentation governs

Zznlgis / opengis-skillsMIT

Documentation de la Skill

GitHub

name: my-opencode-deepseek-config description: "Use when deploying, tuning, or extending the OpenCode × DeepSeek V4 optimal configuration (orchestrator routing, 12 agents, thinking tiers, prompt-cache prefix discipline, DCP compaction, permissions baseline, 25 skills, slash commands) — installing to another machine, adding an agent or skill, adjusting model routing/cost, or troubleshooting why an agent routes/compacts/thinks a certain way."

tags:

  • opencode
  • deepseek
  • agent-config
  • prompt-cache
  • model-routing
  • agent
  • ai

项目地址： https://github.com/znlgis/my-opencode-deepseek-config

许可证： MIT License（最新 tag：v4.0.0）

文档： https://github.com/znlgis/my-opencode-deepseek-config/blob/main/README.md（中英双语）

前置条件： OpenCode ≥ v1.18.x（DeepSeek provider 内置）、DeepSeek API Key（https://platform.deepseek.com/api_keys）

概述

OpenCode 多 Agent 框架下 DeepSeek V4 模型族（Pro + Flash + Flash-Vision）的最优纯配置方案——零额外依赖，全部能力由 opencode.jsonc + agents/*.md + skills/*/SKILL.md + AGENTS.md 实现。核心理念：Token 效率优先，用最小的上下文成本达到最好的开发效果。

当前配置概览：

  • 默认主 Agent orchestrator（意图门控 + 模型感知路由 + 后备链）；第二 primary solo（单模型内联执行、零委派）
  • 3 模型矩阵：deepseek/deepseek-v4-pro（深度推理/审查/重型实现）、deepseek/deepseek-v4-flash（路由/规划/常规执行，provider 层关 thinking + temperature 0）、deepseek/deepseek-v4-flash-vision-exp（多模态）
  • 12 个 Agent、25 个技能（按需加载）、17 个 slash 命令、subagent_depth: 3、share: "disabled"
  • 上下文双引擎：内置 compaction（opencode.jsonc，自动触发 + prune 旧工具输出）+ DCP 插件（dcp.jsonc，主动去重 + 按模型成本分级压缩阈值）

环境要求： OpenCode ≥ v1.18.x；后台子智能体委派需环境变量 OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true（未设置时后台委派报错，应退回前台串行）。

安装部署

git clone https://github.com/znlgis/my-opencode-deepseek-config.git

方式一（推荐）：环境变量指向 opencode/ 子目录

# Windows 永久生效
[Environment]::SetEnvironmentVariable("OPENCODE_CONFIG_DIR", "D:\path\to\my-opencode-deepseek-config\opencode", "User")

# Linux / macOS
export OPENCODE_CONFIG_DIR="$HOME/path/to/my-opencode-deepseek-config/opencode"

方式二：符号链接到 ~/.config/opencode（Windows 需管理员 New-Item -ItemType SymbolicLink；类 Unix ln -s .../opencode ~/.config/opencode）

API Key： TUI 内 /connect → DeepSeek → 粘贴 Key（自动存 ~/.local/share/opencode/auth.json），或环境变量 DEEPSEEK_API_KEY。

验证： /models 显示 deepseek/deepseek-v4-pro；Agent 列表含 orchestrator/planner/deep-worker 等 12 个。

Agent 结构（12 个）

Agent模型档权限作用
orchestratorflash · thinking 关读写默认入口：意图门控 + 路由 + 后备链
solopro · 默认 high读写单模型内联执行器，permission.task: "*": "deny" 零委派
plannerflash + reasoningEffort: low读写规划、架构、拆解任务
deep-workerpro读写重型实现、多文件改动（禁研究/禁委托，带拒绝契约）
light-orchestratorflash + low读写轻量任务、单文件编辑
oraclepro只读根因分析、深度理解代码
reviewerpro只读单遍代码审查（证据门控）
explore / librarianflash · thinking 关只读代码库搜索 / 文档检索（librarian 无任何 bash 权限）
consultant / ui-builderflash · thinking 关读写方案建议 / 前端 UI
visionflash-vision-exp读写图像/截图/图表/UI 稿理解

只读 Agent 真只读化：edit: deny + bash 白名单（默认 deny，仅放行 git status/diff/log/show/blame、rg 等只读子命令）。各 agent 带 skills 白名单（默认 deny + 按职责放行，防误加载重型 skill）。

思考分档关键点： reasoning_effort 是请求级思考强度（low/high/max），不是模型 ID——经 agent frontmatter options（camelCase reasoningEffort，深度合并到 model.options）设置，3 模型矩阵不变。

路由策略与成本

  • Trivial → flash off（搜索/查询/咨询/UI/探索）；Routine → flash low（规划/常规多文件实现）；Deep/uncertain → pro high（根因分析/审查/重型实现）
  • flash 无法胜任时自动升级 pro（带完整上下文）
  • 价格（USD / 1M tokens，off-peak，peak 翻倍）：flash 输入 0.22 / 输出 0.66；pro 输入 0.66 / 输出 1.98（pro = 3× flash）；cache_read 0.007 / 0.022（比输入价便宜约 30×）
  • 成本估算脚本：scripts/estimate-cost.js

提示缓存纪律（最大杠杆）

  • 字节稳定前缀：agent 提示词、AGENTS.md、规则顺序保持不变；时间戳/随机 ID/动态文件列表等易变内容置于 payload 尾部
  • 冻结工具集：不在会话中途重排 tool schema 或注入规则
  • 插件固定版本（superpowers #v6.3.0、DCP @3.1.15）防自动更新导致前缀漂移
  • DCP modelMaxLimits/modelMinLimits：pro 更早压缩、flash 更晚压缩

Slash 命令（17 个）

命令目标用途
/deep /quick /ui /vision /plan /oracle对应 agent直达路由：重型实现 / 轻量编辑 / 前端 / 图像 / 规划 / 溯源
/review [PR号]reviewerPR 模式回帖 GitHub（gh-cli），无参审查本地 diff；>500 有效行先报 scoped 计划
/commitlight-orchestratorConventional Commits 提交信息
/releasedeep-worker（git-release）Tag 发布准备
/reflectoracle（reflect）发现摩擦 → 配置优化建议
/handofflight-orchestrator会话压缩为交接文档
/codemap /learn /simplify /rmslopexplore / deep-worker / oracle+light-orchestrator / deep-worker结构图 / 经验沉淀 AGENTS.md / 行为保持简化 / 死代码清理
/spec-propose /spec-applyplanner / deep-worker（spec-workflow）规约驱动变更：提案 → 按 tasks 实现归档

典型工作流：新功能 /spec-propose → /spec-apply → /review；排障 /oracle → /deep → /rmslop → /commit。

技能清单（25 个，opencode/skills/）

按需加载（原生 skill 工具），代表性分组：

  • 过程纪律：grilling、wait-what、diagnosing-bugs、verification 类（superpowers 插件另提供 brainstorming/TDD/systematic-debugging）
  • 代码质量：code-review、security-review、simplify、remove-deadcode、codebase-design、domain-modeling、grill-with-docs
  • Git/GitHub：git-master、git-release、resolving-merge-conflicts、gh-cli、to-tickets、triage
  • 文档/知识：verify-with-docs、writing-for-agents、codemap、handoff、reflect、office-docs、vision-prep、opencode-config、spec-workflow

常见问题

问题处理
改动 ~/.config/opencode 后不生效它是独立副本（非符号链接）时须运行 scripts\sync-config.ps1 从仓库源同步（支持 -Src 指定源目录）
后台委派报 background: true 错误未设 OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true；设置之或退回前台串行委派
成本突然翻倍检查是否 peak 时段计价；确认 trivial 任务没有落到 pro（pro = 3×）；确认前缀未被动态内容打散（cache_read 便宜 30×）
flash agent 输出质量差需要思考的中档任务给 planner/light-orchestrator（flash + thinking 开 + reasoningEffort: low），而不是 flash 关思考档
新模型/新 provider 想加本仓库约束：仅 DeepSeek V4 三模型，不引入其他模型

参考资源

More skills to explore

Voir toutes les Skills
Skills enregistrées