feat: add standard init-db CLI for host install schema ensure

development/DEVELOPMENT.md

@@ -454,7 +454,7 @@ metadata:
 也就是说，`cli/app.py` 的职责是：
 
 1. 打印帮助
-2. 定义 `run / logs / log-get / health / version`（及业务子命令）
+2. 定义 `run / logs / log-get / health / version / init-db`（及业务子命令）
 3. 把参数转交给 `service.task_service`（或薄适配后再进 domain service）
 
 不要在 `cli/app.py` 里直接写：
@@ -538,7 +538,7 @@ assets/actions.json             → placements / bind / executionProfile / entry
 - **运行时金标准**见 [`SKILL_ACTION_RUNTIME.md`](SKILL_ACTION_RUNTIME.md)
 - 字段契约见 [`references/ACTIONS.md`](../references/ACTIONS.md)（`placements` / `bind.tables` / `executionProfile` 正交）
 - JSON Schema 见 [`assets/schemas/skill-actions.schema.json`](../assets/schemas/skill-actions.schema.json)
-- 模板最小示例仅暴露 `health` / `version` / `config-path`（均显式 `executionProfile: "sync"`；**不**自动加 toolbar）
+- 模板最小示例仅暴露 `health` / `version` / `config-path`（均显式 `executionProfile: "sync"`；**不**自动加 toolbar）；CLI 另含 `init-db` 供宿主静默建库（不必做成 Action）
 - 含 `toolbar` 的 Action：**必须**声明合法 `bind.tables`（`POLICY-SKILL-ACTION-003`）
 - 含浏览器 RPA / 长耗时的业务技能：**必须**增加至少一条 `"executionProfile": "async"` 且 `placements` 含 `agent` 的 action（`POLICY-SKILL-ACTION-001`）
 - 没有宿主直接操作需求时，**可以删除** `actions.json`；删除后勿保留失效引用

development/REQUIREMENTS.md

@@ -60,7 +60,7 @@
 - 输出结构化结果（stdout JSON 或固定文本 + 机读字段）
 - 写入 `task_logs`（及必要的业务表，见 `references/SCHEMA.md`）
 - 支持失败可诊断（稳定错误码、`ERROR:` 前缀、必要截图/日志）
-- 完成 CLI 入口与 `health` / `version` 最小可运行验证
+- 完成 CLI 入口与 `health` / `version` / `init-db` 最小可运行验证
 - 完成正式环境发布与安装验证（如适用）
 
 ## 4. 功能范围
@@ -81,6 +81,7 @@
 
 - 支持 `python scripts/main.py health`
 - 支持 `python scripts/main.py version`
+- 支持 `python scripts/main.py init-db`（幂等建库；宿主安装/更新后可静默调用）
 - 支持 `python scripts/main.py <your-main-command>`
 - 支持核心业务编排（HTTP / 批处理 / 可选 RPA，按四档 adapter 选型）
 - 支持写入任务日志（`task_logs`）
@@ -154,7 +155,7 @@
 什么情况下才算开发完成：
 
 - 代码结构符合模板规范；`SKILL.md` slug 与 `constants.SKILL_SLUG` 一致
-- `health`、`version` 命令执行正常
+- `health`、`version`、`init-db` 命令执行正常
 - 主命令（如 `run`）在 mock / simulator 档位可重复验证
 - `python tests/run_tests.py -v` 必跑测试全部通过
 - `task_logs` 写入和查询符合 `references/SCHEMA.md`（含 `created_at` / `updated_at` Unix 秒级规范）
@@ -211,7 +212,7 @@
 
 ## 4. 功能范围
 
-- 支持 health / version / run
+- 支持 health / version / init-db / run
 - 支持 logs / log-get
 
 ## 5. 非功能要求

development/TESTING.md

@@ -22,7 +22,7 @@
 
 必跑套件要像一个紧张的守门员：**快、确定、离线**。典型覆盖：
 
-- CLI：导入 [`cli.app`](../scripts/cli/app.py) 走解析链路、`health`（runtime diagnostics）/ `version` / `logs` / `log-get` 冒烟；
+- CLI：导入 [`cli.app`](../scripts/cli/app.py) 走解析链路、`health`（runtime diagnostics）/ `version` / `init-db` / `logs` / `log-get` 冒烟；
 - 架构守护：无 `scripts/jiangchang_skill_core/`、`platform-kit>=1.2.0` 导入来源、文档/runtime 标准（见 `test_platform_import.py` 等）；
 - **真实 subprocess**：[`tests/test_entrypoint_subprocess.py`](../tests/test_entrypoint_subprocess.py) 再调用一遍 `python scripts/main.py`，防路径漂移；
 - 运行时：`runtime_paths` 与 **`JIANGCHANG_*` 隔离**；
@@ -153,6 +153,7 @@ Golden fixture 流程同理（[`tests/samples/test_golden_cases.py.sample`](../t
 - [ ] `python tests/run_tests.py -v` 能通过。
 - [ ] `python scripts/main.py health` 能通过。
 - [ ] `python scripts/main.py version` 输出 JSON，且 `skill` 与目录名 / `SKILL.md` / `constants.SKILL_SLUG` 一致。
+- [ ] `python scripts/main.py init-db` 幂等创建本地库并输出 JSON（`ok` / `skill` / `db_path`）。
 - [ ] 所有 DB / 文件写入都在 `IsolatedDataRoot`（或等价隔离）下测试，不写真实数据目录。
 - [ ] 外部系统默认使用 mock / `FakeAdapter`，不访问真实 API，不打开真实 RPA。
 - [ ] 至少有 1 个成功路径测试。