4 Commits

Author SHA1 Message Date
2b3fdda61e chore: auto release commit (2026-09-10 17:49:40)
All checks were successful
技能自动化发布 / release (push) Successful in 6s
2026-09-10 17:49:40 +08:00
11289976c3 chore: auto release commit (2026-09-10 16:10:10)
All checks were successful
技能自动化发布 / release (push) Successful in 5s
2026-09-10 16:10:11 +08:00
8617bb1368 chore: auto release commit (2026-09-10 16:05:51)
All checks were successful
技能自动化发布 / release (push) Successful in 6s
2026-09-10 16:05:51 +08:00
cc7c5e3b18 chore: auto release commit (2026-09-10 15:52:23) 2026-09-10 15:52:23 +08:00
11 changed files with 80 additions and 82 deletions

View File

@@ -108,6 +108,3 @@ demo_video_url: ""
{ "total": 5, "pending": 3, "done": 2 } { "total": 5, "pending": 3, "done": 2 }
``` ```
## 没有视频时
以上图文覆盖了核心操作与返回结果样例;有视频后把 `demo_video_url` 填上真实可访问的地址即可,正文可保留为补充说明。

View File

@@ -1,45 +1,27 @@
--- ---
description: "用用户能理解的方式说明这个技能能做什么、适合什么场景,以及如何开始使用。" description: "用户可以指定待办事项,系统会自动提醒用户在指定时间完成或用户指定的时间点提醒。"
--- ---
> **模板说明(复制后删除本段)** # 待办事项
> 本文是技能市场详情与普通用户说明,**不是** Agent 参考索引、CLI 契约或开发文档。
> frontmatter 的 `description` 必须是用户能看懂的一句话能力描述;**不得**写成 CLI、schema、references、development、契约、数据结构、开发规范或 Agent 参考索引。
> 正文只回答用户关心的问题,**不要**把 Playwright、DOM、Python、RPA、references、development、schema 等作为面向用户的主说明内容;若业务上必须出现技术词,须用用户能理解的方式解释,且不能喧宾夺主。
> **复制后验收章节(标题可微调,建议保留):**「能帮你做什么」「适合什么场景」「使用前需要准备什么」「你可以这样告诉 Agent」「执行后你会得到什么」「注意事项」「常见问题」。
# 【技能名称】 > 用户可以创建待办事项,删除待办事项,修改待办事项,系统会自动提醒用户在指定时间完成或用户指定的时间点提醒。
> 用一两句话说明这个技能帮助用户完成什么工作。
> 这里不要解释技术实现,要从用户的业务目标出发描述价值。
--- ---
## 这个技能能帮你做什么 ## 这个技能能帮你做什么
- 能够帮助用户提醒待办事项,记录待办事项,避免遗漏
用 3 到 6 条业务能力说明技能价值,例如:
- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
- 帮你减少重复操作,降低人工录入或核对成本
- 在任务完成后给出清晰的处理结果、失败原因或后续建议
--- ---
## 适合什么场景 ## 使用场景
- 个人事务、生活安排
- 日常工作任务
列出典型使用场景。请使用用户熟悉的业务语言,例如:
- 每天需要重复处理同一类订单、单据、报表或客户资料
- 需要从多个系统中查询信息并汇总结果
- 需要按固定规则检查数据是否完整、是否异常
- 需要把处理结果保存为文件、记录或任务报告
--- ---
## 使用前需要准备什么 ## 使用前需要准备什么
说明用户在使用前要准备的东西,例如:
- **网页自动化类:** 首次运行可由技能自动登记平台账号(浏览器会话由系统隔离管理)。也可在「账号管理」里指定登录标识。登记账号 ≠ 已登录目标站 - **网页自动化类:** 首次运行可由技能自动登记平台账号(浏览器会话由系统隔离管理)。也可在「账号管理」里指定登录标识。登记账号 ≠ 已登录目标站
- **账号在哪里看:** 已登记账号可在「数据管理 / 账号管理」中查看;每个账号使用独立浏览器会话,批量或多账号任务不会共用登录状态 - **账号在哪里看:** 已登记账号可在「数据管理 / 账号管理」中查看;每个账号使用独立浏览器会话,批量或多账号任务不会共用登录状态
- **是否要登录目标站:** 按本技能说明(有的平台必须登录,有的公开页可不登录);与「是否有账号记录」不是一回事 - **是否要登录目标站:** 按本技能说明(有的平台必须登录,有的公开页可不登录);与「是否有账号记录」不是一回事
@@ -51,57 +33,20 @@ description: "用用户能理解的方式说明这个技能能做什么、适合
## 你可以这样告诉 Agent ## 你可以这样告诉 Agent
用自然语言示例展示用户可以怎么发起任务,例如: > “帮我查询今天的【待办事项】”
> “帮我查询今天的【业务对象】,整理成表格。”
>
> “帮我核对这些【数据/单据】是否有异常,并告诉我问题在哪里。”
>
> “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
>
> “帮我根据这个文件里的内容,逐条完成【业务动作】。”
> 注意:示例应是自然语言,不要写命令行命令。
--- ---
## 执行后你会得到什么 ## 执行后你会得到什么
- 查询待办事项的结果
说明用户会看到什么结果,例如:
- 任务是否成功完成
- 处理了多少条数据
- 哪些内容成功、哪些失败
- 失败原因和建议处理方式
- 生成的文件、表格、报告或记录
--- ---
## 注意事项
用用户能理解的方式说明边界和风险,例如:
- 请确认输入范围准确,避免处理错数据
- 涉及提交、付款、删除、审批等高风险动作时,技能应在执行前请求确认
- 如果外部系统登录失效、权限不足或页面变化,任务可能需要用户介入
- 不建议在未核对数据的情况下直接执行批量操作
--- ---
## 常见问题 ## 常见问题
### 为什么任务没有查到数据?
> 可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
### 为什么任务执行到一半需要我操作?
> 可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
### 结果文件在哪里查看?
> 请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
### 已经登记的账号在哪里查看? ### 已经登记的账号在哪里查看?
> 请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。若任务仍提示账号异常,请把账号编号、任务时间和界面提示原文提供给支持人员;不要发送密码、Cookie 或验证码。 > 请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。若任务仍提示账号异常,请把账号编号、任务时间和界面提示原文提供给支持人员;不要发送密码、Cookie 或验证码。

View File

@@ -1,5 +1,5 @@
--- ---
name: 技能开发模板(通用业务版) name: 待办事项
description: "OpenClaw 通用业务技能开发模板,供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。" description: "OpenClaw 通用业务技能开发模板,供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。"
version: 1.0.98 version: 1.0.98
author: 深圳匠厂科技有限公司 author: 深圳匠厂科技有限公司

View File

@@ -37,6 +37,54 @@
"command": "config-path", "command": "config-path",
"args": [] "args": []
} }
},
{
"id": "add-todo",
"label": "添加待办",
"description": "添加待办事项。",
"placements": ["skill-detail","toolbar"],
"executionProfile": "sync",
"entrypoint": {
"type": "cli",
"command": "todo",
"args": [
"add","",
"--title", "{{title}}",
"--priority", "{{priority}}",
"--due-at", "{{due_at}}"
]
},
"interaction": "form",
"bind": {
"tables": ["todos"]
},
"inputSchema": {
"type": "object",
"properties": {
"title": {
"type": "string",
"title": "待办标题",
"description": "待办事项的标题,必填。"
},
"priority": {
"type": "string",
"title": "优先级",
"description": "待办事项的优先级,可选。",
"default": "medium",
"enum": ["high", "medium", "low"]
},
"due_at": {
"type": "string",
"title": "提醒时间",
"description": "格式 YYYY-MM-DD,如 2026-08-01。",
"display_type": "datetime_unix_seconds"
}
},
"required": ["title", "priority"]
},
"hostEffects": {
"onSuccess": ["reloadTable"]
}
} }
] ]
} }

View File

@@ -312,11 +312,11 @@ git remote -v
复制后,至少要全局检查并替换下面这些内容: 复制后,至少要全局检查并替换下面这些内容:
- `add-todo-all` - `your-skill-slug`
- `your-platform-key`(若 skill 涉及外部平台对接,可能会用到这类占位) - `your-platform-key`(若 skill 涉及外部平台对接,可能会用到这类占位)
- `技能开发模板(通用业务版)` - `技能开发模板(通用业务版)`
- `你的平台名` - `你的平台名`
- `openclaw.skill.add_todo_all` - `openclaw.skill.your_skill_slug`
如果你的 skill 对外 CLI 需要自定义文案或别名(例如发布类对外仍叫 `publish`),通常还要替换: 如果你的 skill 对外 CLI 需要自定义文案或别名(例如发布类对外仍叫 `publish`),通常还要替换:

View File

@@ -24,7 +24,7 @@ python {baseDir}/scripts/main.py <command> …
| 类型 | 本技能命令(自填) | Agent | | 类型 | 本技能命令(自填) | Agent |
|------|--------------------|-------| |------|--------------------|-------|
| **短 CLI 白名单** | (例)`health` / `version` / `render-html` / `<your-read-or-prep>` | 可用 bash/exec + 共享 `python` | | **短 CLI 白名单** | (例)`health` / `version` / `render-html` / `todo` / `remind` | 可用 bash/exec + 共享 `python` |
| **Action 强制黑名单** | (例)`<your-long-or-rpa-command>` | **禁止** bash + `process poll`;必须 `run_skill_action` | | **Action 强制黑名单** | (例)`<your-long-or-rpa-command>` | **禁止** bash + `process poll`;必须 `run_skill_action` |
细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。若提供 HTML 报告,「重新生成」须有 Action id **`render-html`**(可同时进短 CLI 白名单);见 ACTIONS.md「HTML 页面报告」。 细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。若提供 HTML 报告,「重新生成」须有 Action id **`render-html`**(可同时进短 CLI 白名单);见 ACTIONS.md「HTML 页面报告」。

View File

@@ -6,6 +6,14 @@
实现上的 DDL 与默认中文元数据种子见 `scripts/db/display_metadata.py`;`scripts/db/connection.py` 的 `init_db()` 会一并初始化。 实现上的 DDL 与默认中文元数据种子见 `scripts/db/display_metadata.py`;`scripts/db/connection.py` 的 `init_db()` 会一并初始化。
## 本技能业务表
| 物理表 | Data Management | 用途 |
|---|---|---|
| `todos` | 可见 | 待办列表 |
## 职责边界 ## 职责边界
### 技能负责 ### 技能负责

View File

@@ -57,7 +57,7 @@ def _add_run_subparser(sub) -> None:
todo_sub = sp.add_subparsers(dest="todo_cmd", required=True, parser_class=ZhArgumentParser) todo_sub = sp.add_subparsers(dest="todo_cmd", required=True, parser_class=ZhArgumentParser)
p = todo_sub.add_parser("add", help="新增一条待办") p = todo_sub.add_parser("add", help="新增一条待办")
p.add_argument("title", help="待办标题(必填)") p.add_argument("-t","--title", help="待办标题(必填)")
p.add_argument("-p", "--priority", default="normal", p.add_argument("-p", "--priority", default="normal",
choices=["high", "normal", "low"], help="优先级,默认 normal") choices=["high", "normal", "low"], help="优先级,默认 normal")
p.add_argument("-d", "--due-at", type=int, default=None, p.add_argument("-d", "--due-at", type=int, default=None,

View File

@@ -56,7 +56,7 @@ def _seed_todos_display_metadata(cursor) -> None:
table_name="todos", table_name="todos",
display_name="待办事项", display_name="待办事项",
description="本技能的核心业务表:每条待办事项一行。", description="本技能的核心业务表:每条待办事项一行。",
grid_help="状态变更走技能 CLI(todo done / todo delete),不要在表里直接改。", grid_help="所有的待办事项,包括待办、已办、已删除。",
visible=1, visible=1,
readonly=1, # 整表只读:增删改通过技能 Action 走,宿主不直写 readonly=1, # 整表只读:增删改通过技能 Action 走,宿主不直写
default_sort_json='[{"column":"created_at","direction":"desc"}]', default_sort_json='[{"column":"created_at","direction":"desc"}]',
@@ -79,11 +79,11 @@ def _seed_todos_display_metadata(cursor) -> None:
"visible": 1, "searchable": 1, "editable": 0, "display_type": "enum", "visible": 1, "searchable": 1, "editable": 0, "display_type": "enum",
"options_json": '[{"value":"high","label":"高"},{"value":"normal","label":"中"},{"value":"low","label":"低"}]'}, "options_json": '[{"value":"high","label":"高"},{"value":"normal","label":"中"},{"value":"low","label":"低"}]'},
{"column_name": "due_at", "display_name": "截止时间", "description": "Unix 秒;可空", {"column_name": "due_at", "display_name": "截止时间", "description": "Unix 秒;可空",
"visible": 1, "searchable": 1, "editable": 0, "display_type": "datetime_unix_seconds","default":"(unixepoch())"}, "visible": 1, "searchable": 1, "editable": 0, "display_type": "datetime_unix_seconds"},
{"column_name": "created_at", "display_name": "创建时间", "description": "Unix 秒", {"column_name": "created_at", "display_name": "创建时间", "description": "Unix 秒",
"visible": 1, "searchable": 0, "editable": 0, "display_type": "datetime_unix_seconds","default":"(unixepoch())"}, "visible": 1, "searchable": 0, "editable": 0, "display_type": "datetime_unix_seconds"},
{"column_name": "updated_at", "display_name": "更新时间", "description": "Unix 秒", {"column_name": "updated_at", "display_name": "更新时间", "description": "Unix 秒",
"visible": 0, "searchable": 0, "editable": 0, "display_type": "datetime_unix_seconds","default":"(unixepoch())"}, "visible": 0, "searchable": 0, "editable": 0, "display_type": "datetime_unix_seconds"},
], ],
) )

View File

@@ -321,13 +321,13 @@ class TestDocsStandards(unittest.TestCase):
def test_tools_readme_documents_actions_scaffold(self) -> None: def test_tools_readme_documents_actions_scaffold(self) -> None:
text = self._read("tools/README.md") text = self._read("tools/README.md")
self.assertIn("actions.json", text) self.assertIn("actions.json", text)
self.assertIn("add-todo-all", text) self.assertIn("your-skill-slug", text)
self.assertIn("add_todo_all", text) self.assertIn("your_skill_slug", text)
def test_development_md_documents_both_slug_placeholders(self) -> None: def test_development_md_documents_both_slug_placeholders(self) -> None:
text = self._read("development/DEVELOPMENT.md") text = self._read("development/DEVELOPMENT.md")
self.assertIn("add-todo-all", text) self.assertIn("your-skill-slug", text)
self.assertIn("add_todo_all", text) self.assertIn("your_skill_slug", text)
def test_schema_md_documents_data_management_contract(self) -> None: def test_schema_md_documents_data_management_contract(self) -> None:
text = self._read("references/SCHEMA.md") text = self._read("references/SCHEMA.md")

View File

@@ -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` - **排除**:`.git`、`.pytest_cache`、`__pycache__`、`.env`、`.env.local`、`*.pyc`
- 删除目标中的 `.openclaw-skill-template` 标记 - 删除目标中的 `.openclaw-skill-template` 标记
- 将文本文件中的模板占位 slug 替换为新 slug: - 将文本文件中的模板占位 slug 替换为新 slug:
- `add-todo-all` → 新技能 kebab-case slug(如 `scrape-demo-records`) - `your-skill-slug` → 新技能 kebab-case slug(如 `scrape-demo-records`)
- `add_todo_all` → 连字符替换为下划线(如 `scrape_demo_records`,用于 `LOG_LOGGER_NAME` 等) - `your_skill_slug` → 连字符替换为下划线(如 `scrape_demo_records`,用于 `LOG_LOGGER_NAME` 等)
- 覆盖 `assets/actions.json`、`SKILL.md`、`scripts/util/constants.py` 等生成文件;文档中的路径示例可保留占位,但生成后的技能文件不得残留占位符 - 覆盖 `assets/actions.json`、`SKILL.md`、`scripts/util/constants.py` 等生成文件;文档中的路径示例可保留占位,但生成后的技能文件不得残留占位符
- **不**自动修改 `actions.json` 中的 CLI 业务命令;技能作者自行增删 action - **不**自动修改 `actions.json` 中的 CLI 业务命令;技能作者自行增删 action
- **不**移除 Schema 中的 `bind.tables` 支持,**不**把 `bind` 当模板残留清理 - **不**移除 Schema 中的 `bind.tables` 支持,**不**把 `bind` 当模板残留清理