# 运行时约定

## 目录结构

新技能建议采用以下根目录结构：

- `assets/`
- `references/`
- `scripts/`
- `tests/`
- `evals/`

## `scripts/` 分层

- `scripts/main.py`：唯一 CLI 入口
- `scripts/cli/`：参数解析与命令分发
- `scripts/db/`：SQLite 或本地持久化层
- `scripts/service/`：业务用例与外部交互
- `scripts/util/`：通用工具、常量、日志、路径
- `scripts/jiangchang_skill_core/`：运行时与统一日志副本

## 数据路径

推荐：

```text
{CLAW_DATA_ROOT}/{CLAW_USER_ID}/{skill_slug}/
```

数据库文件建议：

```text
{...}/{skill_slug}.db
```

## 编码与输出

- Windows 终端建议在 `scripts/main.py` 里做 UTF-8 stdout/stderr 包装
- 机读输出优先单行 JSON
- 错误前缀建议统一 `ERROR:`