skill-template/references/SCHEMA.md

数据存储模板

数据库路径

{DATA_ROOT}/{USER_ID}/your-skill-slug/your-skill-slug.db

通用任务日志表（task_logs）

模板默认建表：

字段	类型	说明
id	INTEGER PK	自增主键
task_type	TEXT NOT NULL	任务类型（disburse / reconcile / verify ...）
target_id	TEXT	任务目标（账号、平台、客户等的 ID）
input_id	TEXT	输入对象 ID
input_title	TEXT	输入对象标题快照
status	TEXT NOT NULL	success / failed / partial / require_login 等
error_msg	TEXT	错误说明
result_summary	TEXT	结果摘要（建议存 JSON 字符串）
created_at	INTEGER	Unix 时间戳
updated_at	INTEGER	Unix 时间戳

不同业务的字段映射建议

业务场景	task_type	target_id 含义	input_id 含义
发布类	publish	账号 ID	文章 ID
工资代发	disburse	付款账户	工资表批次 ID
对账	reconcile	银行 / 平台	对账批次 ID
发票验真	verify	税务地区	发票批次 ID
报关	declare	港口 / 海关	报关批次 ID

模板原则

• 模板不做历史迁移兼容设计
• 新 skill 直接从当前 schema 起步
• 业务有特殊字段时，建议放 result_summary（JSON 字符串），不要乱加列