48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# skill-template 工具
|
||
|
||
## 推荐：脚手架创建新技能
|
||
|
||
**不要**用资源管理器整文件夹复制 `skill-template`（会带走隐藏 `.git`，导致 push 串库）。
|
||
|
||
Windows 首选：
|
||
|
||
```powershell
|
||
cd D:\OpenClaw\client-commons\skill-template
|
||
.\tools\scaffold_skill.ps1 -Slug my-new-skill -Destination D:\OpenClaw\client-gdcm\my-new-skill
|
||
```
|
||
|
||
跨平台（Python 3.10+）：
|
||
|
||
```bash
|
||
python tools/scaffold_skill.py --slug my-new-skill --destination /path/to/my-new-skill
|
||
```
|
||
|
||
脚本行为：
|
||
|
||
- 复制模板到 `-Destination`（目录末段须与 `-Slug` 一致）
|
||
- **排除**：`.git`、`.pytest_cache`、`__pycache__`、`.env`、`.env.local`、`*.pyc`
|
||
- 删除目标中的 `.openclaw-skill-template` 标记
|
||
- **不**自动 `git init`；打印后续 Git 与测试命令
|
||
|
||
目标目录若已存在且非空，需加 `-Force` / `--force`（且目标**不得**含 `.git`）。
|
||
|
||
## 手工复制后的补救
|
||
|
||
若已整目录复制，必须先清理再初始化：
|
||
|
||
```powershell
|
||
cd <新技能目录>
|
||
Remove-Item -Recurse -Force .git
|
||
Remove-Item -Recurse -Force .pytest_cache -ErrorAction SilentlyContinue
|
||
Remove-Item -Force .openclaw-skill-template -ErrorAction SilentlyContinue
|
||
git init
|
||
git remote add origin <新技能仓库 URL>
|
||
git remote -v
|
||
```
|
||
|
||
确认 `origin` **不是** skill-template 的远端 URL。
|
||
|
||
## 模板标记
|
||
|
||
源仓库根目录有 `.openclaw-skill-template`（仅 template 保留）。业务技能不得保留该文件；`tests/test_scaffold_guard.py` 会守护。
|