# opencode-agent-base

**Repository Path**: hivedark/opencode-agent-base

## Basic Information

- **Project Name**: opencode-agent-base
- **Description**: opencode构建业务子agent的基础框架，基于这个框架创建各个子agent
- **Primary Language**: Unknown
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opencode-agent-base

OpenCode 业务子 agent 基础框架项目。

## 快速开始

双击运行 `start.bat` 即可启动 OpenCode 环境。

## 项目结构

```
.
├── start.bat              # 入口脚本（双击运行）
├── update_agent.bat       # 更新agent规则脚本
├── check.ps1              # 环境检查脚本
├── opencode.json          # OpenCode 配置文件
├── AGENTS.md              # Agent 配置说明
├── README.md              # 项目说明文档
├── README.en.md           # 英文项目说明文档
├── LICENSE                # 开源许可证
├── docs/                  # Agent 规则定义（xlsx格式）
│   └── demo-agent.xlsx    # 示例：demo-agent 规则
├── .opencode/             # OpenCode 配置目录
│   └── agents/            # Agent 配置文件（md格式）
│       └── demo-agent.md  # demo-agent 配置
├── demo/                  # 示例数据目录
│   ├── stock_analysis_report.xlsx  # 示例数据文件
│   └── report/            # 示例报告输出目录
│       ├── stock_analysis_report.pdf
│       └── charts.png
└── temp/                  # 临时文件目录（运行时生成）
```

## 配置说明

### opencode.json

- **模型**: deepseek/deepseek-chat
- **端口**: 4096
- **MCP 服务**: 远程调度系统 (http://127.0.0.1:8000/mcp)

详细 MCP 工具说明见 [AGENTS.md](AGENTS.md)。

## 环境要求

- Node.js 18+
- npm 或 pnpm
- OpenCode CLI

首次运行 `start.bat` 时会自动检查环境，未安装则提示安装。

## 根据xlsx优化agent规则

### 规则定义

在 `docs/` 目录下创建 xlsx 文件，定义 agent 的规则结构。文件格式如下：

| 层1 | 层2 | 层3 | 层4 |
|-----|-----|-----|-----|
| agent名称 | 分类 | 具体规则 | 详细描述 |

### 示例：docs/demo-agent.xlsx

| 层1 | 层2 | 层3 | 层4 |
|-----|-----|-----|-----|
| demo-agent | 特殊指令 | 根据xxx文件分析数据的分布状态及发展趋势 | |
| | | 生成关于xxx的随机数据示例 | |
| | 自动分析 | 用户指定分析的目录，自动识别里面的数据文件 | 分析数据的最大值、最小值 |
| | | | 分析数据的趋势图 |
| | | | 总结数据的特性及发展规律 |
| | | | 输出pdf分析报告文件，报告需包含各类分析统计图、统计表、总结报告不得少于200字，需包含具有建设性的建议 |
| | 强制要求 | 不回答无关问题 | |
| | | 严格按流程执行 | |
| | | 信息不全时主动询问 | |
| | | 生成word/pdf时注意中文乱码问题 | |

### 使用方法

1. 在 `docs/` 目录下创建或修改 xlsx 规则文件
2. 进入 OpenCode 后，通过对话方式指引 OpenCode 根据 xlsx 文件优化 agent 规则，例如：

```
根据docs/demo-agent文件优化demo-agent规则
```

或者直接CMD里执行：

```
opencode run "根据docs下的xlsx文件更新相关的sub agent规则"
```

或者直接运行脚本 `update_agent.bat`

OpenCode 会自动解析 xlsx 文件并更新 `.opencode/agents/<agent-name>.md` 文件。

或手动将 xlsx 中的规则同步到 `.opencode/agents/<agent-name>.md` 文件中。

### 规则文件位置

- **xlsx 规则定义**: `docs/<agent-name>.xlsx`
- **agent 配置文件**: `.opencode/agents/<agent-name>.md`