feat: standardize skill data management and actions

Co-authored-by: Cursor <cursoragent@cursor.com>

tools/README.md

@@ -22,10 +22,24 @@ python tools/scaffold_skill.py --slug my-new-skill --destination /path/to/my-new
 - 复制模板到 `-Destination`（目录末段须与 `-Slug` 一致）
 - **排除**：`.git`、`.pytest_cache`、`__pycache__`、`.env`、`.env.local`、`*.pyc`
 - 删除目标中的 `.openclaw-skill-template` 标记
+- 将文本文件中的 `your-skill-slug` 替换为新 slug（含 `assets/actions.json`、`SKILL.md`、`constants.py` 等）
+- **不**自动修改 `actions.json` 中的 CLI 业务命令；技能作者自行增删 action
 - **不**自动 `git init`；打印后续 Git 与测试命令
 
 目标目录若已存在且非空，需加 `-Force` / `--force`（且目标**不得**含 `.git`）。
 
+## 脚手架复制后必须保留 / 修改 / 可删除的文件
+
+| 文件 | 说明 |
+|------|------|
+| `assets/actions.json` | 默认复制；不需要宿主 Action 入口时可删除 |
+| `references/ACTIONS.md` | 契约文档；无 `actions.json` 时可保留作参考或按需精简 |
+| `assets/schemas/skill-actions.schema.json` | manifest 规范；无 action 时可保留 |
+| `tests/test_actions_manifest.py` | 若删除 `actions.json`，应同步删除或改写此测试 |
+| `tests/test_data_management_contract.py` | 通用契约测试；建议保留，按需扩展本技能表结构测试 |
+
+`demo_items` 等示例表仅存在于模板测试中，**不会**作为 scaffold 后的默认业务表复制进新技能。
+
 ## 手工复制后的补救
 
 若已整目录复制，必须先清理再初始化：