| name | aceharness-sqlite |
| description | 使用 ACEHarness 运行时提供的 workspace SQLite 能力创建和维护 Skill 数据库。 |
| capabilities | {"sqlite":{"read":true,"write":true,"createDatabase":true,"deleteDatabase":true}} |
使用场景
当 Skill 需要维护结构化状态、缓存、索引、任务记录或跨步骤数据表时,使用本 Skill。
调用方式
只能使用本 Skill 的 Python 脚本调用 ACEHarness runtime API。不要访问 ACEHarness 内部 SQLite,不要访问 runtime prompt 未列出的数据库文件。
python .agents/skills/aceharness-sqlite/scripts/sqlite_list.py
python .agents/skills/aceharness-sqlite/scripts/sqlite_create.py --db workflow-cache
python .agents/skills/aceharness-sqlite/scripts/sqlite_query.py --db workflow-cache --sql "SELECT * FROM items WHERE id = ?" --params "[\"id-1\"]"
python .agents/skills/aceharness-sqlite/scripts/sqlite_exec.py --db workflow-cache --sql "INSERT INTO items(id, value) VALUES(?, ?)" --params "[\"id-1\", \"value\"]"
python .agents/skills/aceharness-sqlite/scripts/sqlite_transaction.py --db workflow-cache --file .aceharness/sqlite/init.json
python .agents/skills/aceharness-sqlite/scripts/sqlite_delete_db.py --db workflow-cache
约束
- 只能使用 runtime prompt 中列出的逻辑数据库名。
- 数据库文件必须位于当前 workspace 内。
- 不允许
ATTACH、DETACH、load_extension、VACUUM INTO、.read、.shell。
- 查询只允许
SELECT 或 WITH ... SELECT。
- 写操作应使用参数绑定,避免拼接用户输入。
- 写操作应尽量幂等,避免重复执行造成脏数据。