📦 deps(tsl): sync tsl-playbook from f90faa10

Source-Commit: f90faa10c3

tools/tsl-codegen/README.md

@@ -277,7 +277,19 @@ python tools/tsl-codegen/scripts/generate.py --dir tmp/api-recordings
 
 生成器读取录入文件中的 `path`，默认写入
 `skills/tsl-api-reference/references/codegen/project/<path>.md`。不指定
-`--scope` 时，scope 就是 `project`
+`--scope` 时，scope 就是 `project`。该路径默认相对于当前工作目录
+
+从其他目录运行生成器时，使用 `--root` 指定包含 `skills/` 的项目根目录。例如在
+`tools/tsl-codegen` 目录中运行：
+
+```bash
+python scripts/generate.py --file ../../tmp/my-api.json --root ../..
+```
+
+此时仍会写入仓库根目录下的
+`skills/tsl-api-reference/references/codegen/project/<path>.md`，不会在
+`tools/tsl-codegen` 下创建新的 `skills/` 目录。`--root` 接受绝对路径；相对路径按
+运行命令时的当前工作目录解析
 
 写入前会自动使用仓库的 `.prettierrc.json` 格式化 markdown，使新页面与现有
 builtin 页面保持一致。未安装 Prettier 或格式化失败时，生成器会停止且不写目标文件