@wwkit/harness 1.0.9 → 1.0.11

package/skills/read-docs/references/opencode/commands/examples.md

@@ -0,0 +1,42 @@
+# 命令示例
+
+## review — 代码审查
+
+位置：`.opencode/command/review.md`，执行：`/review src/main.ts`
+
+```md
+---
+description: 审查指定文件的代码质量
+agent: plan
+---
+@$1
+请审查这个文件的代码质量，重点关注：
+1. 代码规范和命名
+2. 潜在 Bug
+3. 性能问题
+4. 可维护性
+```
+
+## commit — 生成提交消息
+
+```md
+---
+description: 根据变更生成 Commit 消息
+---
+根据以下变更生成 commit 消息：
+!`git diff --staged`
+要求：
+- 遵循 Conventional Commits 规范
+- 简洁明了，说明"为什么"而非"做了什么"
+```
+
+## translate — 翻译为中文
+
+```md
+---
+description: 翻译为中文
+subtask: true
+---
+请将以下内容翻译为中文：
+$ARGUMENTS
+```

package/skills/read-docs/references/opencode/commands/index.md

@@ -0,0 +1,185 @@
+# 命令（Commands）
+
+自定义命令让你在 TUI 中执行预设的提示词：
+
+```
+/my-command
+```
+
+可以通过 OpenCode 配置或在 `commands/` 目录创建 Markdown 文件添加自定义命令。
+
+## 创建命令文件
+
+在 `commands/` 目录创建 Markdown 文件：
+
+- 全局：`~/.config/opencode/commands/`
+- 项目级：`.opencode/commands/`
+
+```md
+---
+description: Run tests with coverage
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Run the full test suite with coverage report and show any failures.
+Focus on the failing tests and suggest fixes.
+```
+
+Frontmatter 定义命令属性，正文内容成为模板。
+
+使用命令：
+
+```
+/test
+```
+
+## 提示词配置
+
+### 参数传递
+
+使用 `$ARGUMENTS` 占位符传递参数：
+
+```md
+---
+description: Create a new component
+---
+
+Create a new React component named $ARGUMENTS with TypeScript support.
+Include proper typing and basic structure.
+```
+
+运行：
+
+```
+/component Button
+```
+
+使用位置参数：
+
+- `$1`：第一个参数
+- `$2`：第二个参数
+- 以此类推
+
+```md
+---
+description: Create a new file with content
+---
+
+Create a file named $1 in the directory $2
+with the following content: $3
+```
+
+运行：
+
+```
+/create-file config.json src "{ \"key\": \"value\" }"
+```
+
+### Shell 输出
+
+使用 `` !`command` `` 注入 bash 命令输出：
+
+```md
+---
+description: Analyze test coverage
+---
+
+Here are the current test results:
+!`npm test`
+
+Based on these results, suggest improvements to increase coverage.
+```
+
+### 文件引用
+
+使用 `@` 引用文件：
+
+```md
+---
+description: Review component
+---
+
+Review the component in @src/components/Button.tsx.
+Check for performance issues and suggest improvements.
+```
+
+## 配置选项
+
+### Template（必需）
+
+定义命令执行时发送给 LLM 的提示词：
+
+```json
+{
+  "command": {
+    "test": {
+      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
+    }
+  }
+}
+```
+
+### Description
+
+命令的简要描述，在 TUI 中输入命令时显示：
+
+```jsonc
+{
+  "command": {
+    "test": {
+      "description": "Run tests with coverage"
+    }
+  }
+}
+```
+
+### Agent
+
+指定执行此命令的 Agent（可选，默认为当前 Agent）：
+
+```jsonc
+{
+  "command": {
+    "review": {
+      "agent": "plan"
+    }
+  }
+}
+```
+
+### Subtask
+
+强制命令触发子代理调用：
+
+```jsonc
+{
+  "command": {
+    "analyze": {
+      "subtask": true
+    }
+  }
+}
+```
+
+### Model
+
+覆盖命令的默认模型：
+
+```jsonc
+{
+  "command": {
+    "analyze": {
+      "model": "anthropic/claude-3-5-sonnet-20241022"
+    }
+  }
+}
+```
+
+## 内置命令
+
+OpenCode 包含以下内置命令：`/init`、`/undo`、`/redo`、`/share`、`/help`。
+
+## 更多内容
+
+- [命令示例](/commands/examples) — 实用命令示例

package/skills/read-docs/references/opencode/config/provider.md

@@ -0,0 +1,152 @@
+# Providers
+To add a provider you need to:
+- Add the API keys for the provider using the `/connect` command.
+- Configure the provider in your OpenCode config.
+
+## Credentials
+When you add a provider’s API keys with the `/connect` command, they are stored in `~/.local/share/opencode/auth.json`.
+
+## Config
+You can customize the providers through the provider section in your OpenCode config.
+
+### Base URL
+You can customize the base URL for any provider by setting the baseURL option. 
+- This is useful when using proxy services or custom endpoints.
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "anthropic": {
+      "options": {
+        "baseURL": "https://api.anthropic.com/v1"
+      }
+    }
+  }
+}
+```
+
+### Hiding models
+Both options take an array of model IDs — the same IDs shown in the `/models` picker.
+- `blacklist` removes the listed models from the picker.
+- `whitelist` keeps only the listed models and hides the rest.
+
+You can combine them: whitelist narrows the set, then blacklist removes entries from it.
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "anthropic": {
+      "blacklist": ["claude-opus-4-20250514"],
+      "whitelist": ["claude-sonnet-4-20250514"]
+    }
+  }
+}
+```
+
+## OpenCode Zen
+OpenCode Zen is a list of models provided by the OpenCode team that have been tested and verified to work well with OpenCode.
+
+
+Run the /connect command in the TUI, select OpenCode Zen, and head to opencode.ai/auth.
+```
+/connect
+```
+
+Run /models in the TUI to see the list of models we recommend.
+```
+/models
+```
+
+## OpenCode Go
+OpenCode Go is a low cost subscription plan that provides reliable access to popular open coding models provided by the OpenCode team that have been tested and verified to work well with OpenCode.
+
+
+## Custom provider
+To add any OpenAI-compatible provider that’s not listed in the /connect command.
+
+Create or update your opencode.json file in your project directory:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "myprovider": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "My AI ProviderDisplay Name",
+      "options": {
+        "baseURL": "https://api.myprovider.com/v1"
+      },
+      "models": {
+        "my-model-name": {
+          "name": "My Model Display Name"
+        }
+      }
+    }
+  }
+}
+```
+
+Configuration options:
+- npm: AI SDK package to use:
+  - `@ai-sdk/openai-compatible` for OpenAI-compatible providers (for `/v1/chat/completions`).
+  - `@ai-sdk/openai` for `/v1/responses`
+- name: Display name in UI.
+- models: Available models.
+- options.baseURL: API endpoint URL.
+- options.apiKey: Optionally set the API key, if not using auth.
+  - support `env` variable syntax
+- options.headers: Optionally set custom headers.
+- limit.context: Maximum input tokens the model accepts.
+- limit.output: Maximum tokens the model can generate.
+
+### Demo 1:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "llmproxy": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "llmproxy",
+      "options": {
+        "baseURL": "http://127.0.0.1:31943/v1",
+        "apiKey": "sk-123",
+        "headers":{}
+      },
+      "models": {
+        "MiniMax-M2.7": {
+          "name": "MiniMax-M2.7"
+        },
+      }
+    }
+  },
+}
+```
+
+### Demo 2:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "myprovider": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "My AI ProviderDisplay Name",
+      "options": {
+        "baseURL": "https://api.myprovider.com/v1",
+        "apiKey": "{env:ANTHROPIC_API_KEY}",
+        "headers": {
+          "Authorization": "Bearer custom-token"
+        }
+      },
+      "models": {
+        "my-model-name": {
+          "name": "My Model Display Name",
+          "limit": {
+            "context": 200000,
+            "output": 65536
+          }
+        }
+      }
+    }
+  }
+}
+```

package/skills/read-docs/references/opencode/formatter/index.md

@@ -0,0 +1,71 @@
+# Formatters
+OpenCode can format files after they are written or edited using language-specific formatters.
+
+> Formatters are disabled by default; enable them in your config before OpenCode will run them.
+
+## Built-in
+OpenCode comes with several built-in formatters for popular languages and frameworks.
+- `prettier` : .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml
+- `uv` : .py, .pyi
+- `shfmt` : .sh, .bash
+- `pint` : .php
+
+## How it works
+When OpenCode writes or edits a file and formatters are enabled, it:
+
+1. Checks the file extension against all enabled formatters.
+2. Runs the appropriate formatter command on the file.
+3. Applies the formatting changes.
+
+This process happens in the background for enabled formatters.
+
+## Configure
+You can enable and customize formatters through the formatter section in your OpenCode config.
+
+To enable all built-in formatters, set formatter to true.
+```
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": true
+}
+```
+
+Each formatter configuration supports the following:
+- `disabled` : `boolean` Set this to true to disable the formatter
+- `command` : `string[]` The command to run for formatting. 
+  - Required for custom formatters; 
+  - optional for built-ins.
+- `environment` : `object` Environment variables to set when running the formatter
+- `extensions` : `string[]` File extensions this formatter should handle
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+## Custom formatters
+The `$FILE` placeholder in the command will be replaced with the path to the file being formatted.
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```