@wwkit/harness 1.0.8 → 1.0.10

package/skills/read-docs/references/opencode/tools/mcp.md

@@ -0,0 +1,132 @@
+# MCP 服务器
+
+通过 Model Context Protocol（MCP）向 OpenCode 添加外部工具。
+
+## 启用 MCP
+
+在 OpenCode 配置的 `mcp` 部分定义 MCP 服务器：
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "name-of-mcp-server": {
+      // ...
+      "enabled": true,
+    },
+    "name-of-other-mcp-server": {
+      // ...
+    },
+  },
+}
+```
+
+设置 `enabled: false` 可禁用服务器。
+
+## 本地 MCP 服务器
+
+设置 `type` 为 `"local"`：
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "my-local-mcp-server": {
+      "type": "local",
+      "command": ["npx", "-y", "my-mcp-command"],
+      "enabled": true,
+      "environment": {
+        "MY_ENV_VAR": "my_env_var_value",
+      },
+    },
+  },
+}
+```
+
+`command` 也可以使用 `["bun", "x", "my-mcp-command"]`。
+
+## 远程 MCP 服务器
+
+设置 `type` 为 `"remote"`：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "my-remote-mcp": {
+      "type": "remote",
+      "url": "https://my-mcp-server.com",
+      "enabled": true,
+      "headers": {
+        "Authorization": "Bearer MY_API_KEY"
+      }
+    }
+  }
+}
+```
+
+### OAuth
+
+大多数启用 OAuth 的 MCP 服务器无需特殊配置：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "my-oauth-server": {
+      "type": "remote",
+      "url": "https://mcp.example.com/mcp"
+    }
+  }
+}
+```
+
+如果有客户端凭证：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "my-oauth-server": {
+      "type": "remote",
+      "url": "https://mcp.example.com/mcp",
+      "oauth": {
+        "clientId": "{env:MY_MCP_CLIENT_ID}",
+        "clientSecret": "{env:MY_MCP_CLIENT_SECRET}",
+        "scope": "tools:read tools:execute"
+      }
+    }
+  }
+}
+```
+
+### 认证管理
+
+```bash
+opencode mcp auth my-oauth-server
+opencode mcp list
+opencode mcp logout my-oauth-server
+```
+
+## 管理工具
+
+MCP 提供的工具与内置工具一起在 OpenCode 中可用。可以通过 `tools` 配置禁用特定 MCP 工具：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "my-mcp-foo": {
+      "type": "local",
+      "command": ["bun", "x", "my-mcp-command-foo"]
+    },
+    "my-mcp-bar": {
+      "type": "local",
+      "command": ["bun", "x", "my-mcp-command-bar"]
+    }
+  },
+  "tools": {
+    "my-mcp-foo": false
+  }
+}
+```

package/skills/read-docs/references/opencode/train/README.md

@@ -0,0 +1,135 @@
+# OpenCode Agent 培训课程
+
+## 课程概述
+
+面向基础开发者的 OpenCode Agent 实战培训，通过理论讲解和实例演练快速掌握核心技能。
+
+## 课程结构
+
+### 1. 课程概述 (`index.md`)
+- 学习目标和路径规划
+- 前置知识要求
+- 环境准备指南
+- 常见问题解答
+
+### 2. 基础配置培训 (`config-basic.md`)
+- **理论介绍**：配置系统原理、配置文件位置、配置格式
+- **核心配置项**：模型配置、权限配置、Agent 配置、命令配置
+- **环境变量使用**：基础用法、自定义路径
+- **实例展示**：
+  - 案例1：团队项目配置（安全优先）
+  - 案例2：个人开发配置（快速开发）
+  - 案例3：安全审查配置（严格权限）
+- **动手练习**：3个实践练习
+
+### 3. 技能创建培训 (`skill-basic.md`)
+- **理论介绍**：技能概念、文件结构、发现机制、加载流程
+- **SKILL.md 结构**：Frontmatter 规范、Description 编写原则
+- **实例展示**：
+  - 案例1：翻译技能（简单）
+  - 案例2：代码审查技能（中级，含 references）
+  - 案例3：SQL 分析技能（高级，多 references）
+  - 案例4：品牌规范技能（设计）
+- **技能权限配置**：在配置文件和 Agent 中控制
+- **动手练习**：3个实践练习
+
+### 4. Agent 配置培训 (`agent-basic.md`)
+- **理论介绍**：Agent 类型、内置 Agent、协作模式
+- **Agent 配置方式**：JSON 配置、Markdown 配置
+- **配置选项详解**：Description、Temperature、Steps、Model、Permissions、Mode、Hidden、Prompt、Disable
+- **实例展示**：
+  - 案例1：文档写作 Agent
+  - 案例2：代码审查 Agent
+  - 案例3：多模型协作系统
+  - 案例4：自动化 PR 审查机器人
+  - 案例5：探索 Agent（只读）
+- **动手练习**：3个实践练习
+
+### 5. 命令使用培训 (`command-basic.md`)
+- **理论介绍**：命令概念、文件位置、命令结构
+- **命令模板功能**：参数传递、Shell 输出注入、文件引用、组合使用
+- **实例展示**：
+  - 案例1：测试命令
+  - 案例2：组件创建命令（参数化）
+  - 案例3：代码审查命令（Shell 集成）
+  - 案例4：文档生成命令（文件引用）
+  - 案例5：Git 提交命令
+  - 案例6：依赖更新命令
+  - 案例7：项目初始化命令
+  - 案例8：性能分析命令
+- **JSON 配置方式**
+- **动手练习**：4个实践练习
+
+### 6. 实战案例培训 (`practice.md`)
+- **案例1：团队协作项目配置** - 统一配置、团队技能、团队规则
+- **案例2：自动化 CI/CD 集成** - CI Agent、CI 命令、流水线集成
+- **案例3：文档站点自动化** - 文档生成技能、文档 Agent、文档命令
+- **案例4：多语言项目配置** - 语言特定 Agent、语言检测技能
+- **案例5：安全审查系统** - 安全审查 Agent、安全审查命令
+- **常见问题解决**：权限、技能加载、参数传递、多 Agent 协作
+- **最佳实践总结**：配置管理、Agent 设计、技能设计、命令设计
+
+## 课程特点
+
+### 理论与实践结合
+每个章节包含：
+- ✅ **理论部分**：理解概念和原理
+- ✅ **实例展示**：实际配置和代码示例
+- ✅ **动手练习**：实践巩固所学知识
+
+### 循序渐进
+- 从基础配置开始
+- 逐步深入技能和 Agent
+- 最后通过实战案例综合应用
+
+### 实用性强
+- 所有案例可直接使用
+- 提供完整配置文件
+- 包含常见问题解决方案
+
+## 学习路径
+
+### 🎯 快速入门路径（推荐新手）
+```
+基础配置 → 技能创建 → 命令使用 → 实战案例
+```
+
+### 🚀 进阶开发路径（推荐有经验者）
+```
+基础配置 → Agent 配置 → 技能创建 → 实战案例
+```
+
+### 💡 完整学习路径
+```
+基础配置 → 技能创建 → Agent 配置 → 命令使用 → 实战案例
+```
+
+## 使用方式
+
+### 在线阅读
+访问 VitePress 文档站点，导航到"培训课程"章节。
+
+### 本地开发
+```bash
+cd packages/agent
+npm run docs:dev
+# 访问 http://localhost:8000/train/
+```
+
+## 文件清单
+
+```
+packages/agent/train/
+├── index.md           # 课程概述（4.4KB）
+├── config-basic.md    # 基础配置培训（9.9KB）
+├── skill-basic.md     # 技能创建培训（13.8KB）
+├── agent-basic.md     # Agent 配置培训（14.2KB）
+├── command-basic.md   # 命令使用培训（10.5KB）
+└── practice.md        # 实战案例培训（15.0KB）
+```
+
+总计：6个文件，约 68KB 内容。
+
+## 更新日志
+
+- **2024-06-08**：创建完整培训课程，包含 5 个核心章节和实战案例