# SGClaw Skill Converter (Go 版本)

这是一个 Go CLI + Web 的 SGClaw 技能生成器（轻量方案）：
- 命令行：读取 JS 脚本并输出标准 JSON
- Web：核心页面化，支持上传/粘贴脚本、选择模型参数、填写 API Key、设置超时、指定导出目录
- AI：默认接入 GLM-5.1（可通过 `--no-ai` 禁用）

默认输出：
- `skills/<skill_name>/SKILL.toml`
- `skills/<skill_name>/SKILL.md`
- `skills/<skill_name>/scripts/<tool>.js`
- `skills/<skill_name>/references/implementation-notes.md`
- `skills/<skill_name>/assets/notes.md`

## 命令行

```bash
go run . --js-script-path path/to/script.js --skill-name zhihu-hotlist --write
```

参数：
- `--js-script-path`: 脚本路径（与 `--js-script-code` 二选一）
- `--js-script-code`: 直接传递 JS 文本
- `--skill-name`: 技能名（建议 kebab-case）
- `--skill-domain`: 目标域名（裸域名，如 `www.zhihu.com`）
- `--skill-use-case`: 用例说明
- `--tool-name`: 工具名（snake_case）
- `--tool-description`: 工具描述
- `--arg-spec`: 参数说明，支持 `k=v,k2=v2`、JSON 字符串、`@json_file`
- `--artifact-fields`: 逗号分隔字段（可覆盖）
- `--preferred-mode`: `compact` / `full`
- `--write`: 写盘到 `skills/<skill_name>`
- `--no-ai`: 禁用 GLM-5.1

## Web 服务

```bash
go run . --serve --host 127.0.0.1 --port 8787
```

打开：`http://127.0.0.1:8787`

接口：
- `GET /api/config`
- `POST /api/convert`

### 页面可改配置

在浏览器打开页面后可直接改：
- `导出目录`（对应 `POST /api/convert` 的 `skill_root`）
- `AI Base URL`
- `模型`
- `API Key`
- `超时`
- `use_ai`（是否启用 AI）

页面会先显示服务端当前可用配置，提交时以页面填写值为准覆盖到本次转换（不落盘持久化）。

## 打包成 exe

```bash
go build -o sgclaw-skill-converter.exe .
```

Windows 下直接运行：

```bash
./sgclaw-skill-converter.exe --serve --host 127.0.0.1 --port 8787
```

## GLM-5.1 配置（兼容 claude code）

优先级：环境变量 > `~/.claude/settings.json`。

```bash
set GLM_API_KEY=<你的 token>
set GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
set GLM_MODEL=glm-5.1
```

`~/.claude/settings.json` 回退读取：
- `ANTHROPIC_BASE_URL` / `GLM_BASE_URL`
- `ANTHROPIC_AUTH_TOKEN` / `GLM_API_KEY`
- `ANTHROPIC_DEFAULT_OPUS_MODEL` / `GLM_MODEL`
- `env` / `envs` / `environment` 节点

## 输出 JSON
- `skill_name`
- `target_dir`
- `files`
- `metadata.skill_contract`
- `validation`
- `risk_check`
- `blocking_reason`（必要时）