47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# 通用业务技能模板 CLI 模板
|
||
|
||
将 `{baseDir}` 替换为技能根目录（含 `SKILL.md`、`scripts/` 的目录）。所有命令通过 `python {baseDir}/scripts/main.py` 调用。
|
||
|
||
## 最小命令
|
||
|
||
```bash
|
||
python {baseDir}/scripts/main.py health
|
||
python {baseDir}/scripts/main.py version
|
||
```
|
||
|
||
## 通用业务命令骨架
|
||
|
||
模板默认提供以下命令（复制后按需保留或扩展）：
|
||
|
||
```bash
|
||
python {baseDir}/scripts/main.py run
|
||
python {baseDir}/scripts/main.py run -t <target> -i <input_id>
|
||
python {baseDir}/scripts/main.py logs
|
||
python {baseDir}/scripts/main.py logs --task-type disburse --status failed
|
||
python {baseDir}/scripts/main.py log-get <log_id>
|
||
```
|
||
|
||
含义：
|
||
- `run`：执行一次任务（具体语义由你的 skill 决定）
|
||
- `logs`：列出最近 N 条任务日志，可按 task_type / status / target 过滤
|
||
- `log-get`：按 log_id 查看单条任务日志（JSON）
|
||
|
||
## 若你的技能是发布类
|
||
|
||
可以把 `run` 命令对外别名为 `publish`，参数 `--target` 别名为 `--account-id`，参数 `--input-id` 保持不变。
|
||
|
||
## 若你的技能依赖兄弟技能
|
||
|
||
使用 `service.sibling_bridge.call_sibling_json(skill_slug, args)`，不要硬编码兄弟技能名到 sibling_bridge.py 自身。
|
||
|
||
```bash
|
||
# 假设 base 与兄弟技能同级
|
||
python {baseDir}/../<sibling-skill-slug>/scripts/main.py ...
|
||
```
|
||
|
||
## 模板约定
|
||
|
||
- 最小模板至少保留 `health` / `version`
|
||
- 通用业务技能建议使用 `run` / `logs` / `log-get`
|
||
- 不要再用旧模板的 `publish` / `--account-id` / `--article-id` 命名
|