diff --git a/SKILL.md b/SKILL.md index 78a82a8..a2f4677 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,5 +1,5 @@ --- -name: 技能开发模板(通用业务版) +name: 待办事项 description: "OpenClaw 通用业务技能开发模板,供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。" version: 1.0.98 author: 深圳匠厂科技有限公司 diff --git a/development/DEVELOPMENT.md b/development/DEVELOPMENT.md index 183af74..04480fc 100644 --- a/development/DEVELOPMENT.md +++ b/development/DEVELOPMENT.md @@ -312,11 +312,11 @@ git remote -v 复制后,至少要全局检查并替换下面这些内容: -- `add-todo-all` +- `your-skill-slug` - `your-platform-key`(若 skill 涉及外部平台对接,可能会用到这类占位) - `技能开发模板(通用业务版)` - `你的平台名` -- `openclaw.skill.add_todo_all` +- `openclaw.skill.your_skill_slug` 如果你的 skill 对外 CLI 需要自定义文案或别名(例如发布类对外仍叫 `publish`),通常还要替换: diff --git a/references/CLI.md b/references/CLI.md index 40f5e03..68567c0 100644 --- a/references/CLI.md +++ b/references/CLI.md @@ -24,7 +24,7 @@ python {baseDir}/scripts/main.py … | 类型 | 本技能命令(自填) | Agent | |------|--------------------|-------| -| **短 CLI 白名单** | (例)`health` / `version` / `render-html` / `` | 可用 bash/exec + 共享 `python` | +| **短 CLI 白名单** | (例)`health` / `version` / `render-html` / `todo` / `remind` | 可用 bash/exec + 共享 `python` | | **Action 强制黑名单** | (例)`` | **禁止** bash + `process poll`;必须 `run_skill_action` | 细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。若提供 HTML 报告,「重新生成」须有 Action id **`render-html`**(可同时进短 CLI 白名单);见 ACTIONS.md「HTML 页面报告」。 diff --git a/references/SCHEMA.md b/references/SCHEMA.md index f0a8632..01fc130 100644 --- a/references/SCHEMA.md +++ b/references/SCHEMA.md @@ -6,6 +6,14 @@ 实现上的 DDL 与默认中文元数据种子见 `scripts/db/display_metadata.py`;`scripts/db/connection.py` 的 `init_db()` 会一并初始化。 +## 本技能业务表 + +| 物理表 | Data Management | 用途 | +|---|---|---| +| `todos` | 可见 | 待办列表 | + + + ## 职责边界 ### 技能负责 diff --git a/tests/test_docs_standards.py b/tests/test_docs_standards.py index 32a2731..01347b3 100644 --- a/tests/test_docs_standards.py +++ b/tests/test_docs_standards.py @@ -321,13 +321,13 @@ class TestDocsStandards(unittest.TestCase): def test_tools_readme_documents_actions_scaffold(self) -> None: text = self._read("tools/README.md") self.assertIn("actions.json", text) - self.assertIn("add-todo-all", text) - self.assertIn("add_todo_all", text) + self.assertIn("your-skill-slug", text) + self.assertIn("your_skill_slug", text) def test_development_md_documents_both_slug_placeholders(self) -> None: text = self._read("development/DEVELOPMENT.md") - self.assertIn("add-todo-all", text) - self.assertIn("add_todo_all", text) + self.assertIn("your-skill-slug", text) + self.assertIn("your_skill_slug", text) def test_schema_md_documents_data_management_contract(self) -> None: text = self._read("references/SCHEMA.md") diff --git a/tools/README.md b/tools/README.md index 1af09d2..1c13d05 100644 --- a/tools/README.md +++ b/tools/README.md @@ -43,8 +43,8 @@ python tools/scaffold_skill.py --slug my-new-skill --destination /path/to/my-new - **排除**:`.git`、`.pytest_cache`、`__pycache__`、`.env`、`.env.local`、`*.pyc` - 删除目标中的 `.openclaw-skill-template` 标记 - 将文本文件中的模板占位 slug 替换为新 slug: - - `add-todo-all` → 新技能 kebab-case slug(如 `scrape-demo-records`) - - `add_todo_all` → 连字符替换为下划线(如 `scrape_demo_records`,用于 `LOG_LOGGER_NAME` 等) + - `your-skill-slug` → 新技能 kebab-case slug(如 `scrape-demo-records`) + - `your_skill_slug` → 连字符替换为下划线(如 `scrape_demo_records`,用于 `LOG_LOGGER_NAME` 等) - 覆盖 `assets/actions.json`、`SKILL.md`、`scripts/util/constants.py` 等生成文件;文档中的路径示例可保留占位,但生成后的技能文件不得残留占位符 - **不**自动修改 `actions.json` 中的 CLI 业务命令;技能作者自行增删 action - **不**移除 Schema 中的 `bind.tables` 支持,**不**把 `bind` 当模板残留清理