Add generic Claw skill-template (manifest, CLI, docs, optional snippets)

Made-with: Cursor

optional/sqlite_minimal.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+"""
+可选片段：最小 SQLite 示例（请复制后按需修改）
+==============================================
+
+【用途】
+  演示「单表 + 自增主键 + INTEGER 时间戳」的一种严谨写法；与具体业务无关。
+
+【使用步骤】
+  1. 复制到 scripts/db_example.py（或并入你的模块）。
+  2. 修改 TABLE_SQL 中的表名与字段；保持时间字段为 INTEGER Unix 秒（UTC）若需跨时区一致。
+  3. 在入口脚本中仅在需要持久化时 import。
+
+【注意】
+  - 不在模板中做迁移兼容；schema 变更请用你们组织的迁移策略。
+  - 数据库文件路径建议：get_skill_data_dir() / "skill.db"（paths_snippet 中函数）。
+"""
+
+from __future__ import annotations
+
+import sqlite3
+import time
+
+# 示例表：与任何业务无关
+TABLE_SQL = """
+CREATE TABLE IF NOT EXISTS template_audit (
+    id INTEGER PRIMARY KEY AUTOINCREMENT, -- 自增主键
+    action TEXT NOT NULL,                -- 动作标识，如 health_ok
+    created_at INTEGER NOT NULL          -- Unix 秒 UTC
+);
+"""
+
+
+def connect(db_path: str) -> sqlite3.Connection:
+    return sqlite3.connect(db_path)
+
+
+def init_db(conn: sqlite3.Connection) -> None:
+    conn.execute(TABLE_SQL)
+    conn.commit()
+
+
+def record_action(conn: sqlite3.Connection, action: str) -> None:
+    conn.execute(
+        "INSERT INTO template_audit (action, created_at) VALUES (?, ?)",
+        (action, int(time.time())),
+    )
+    conn.commit()