Agent Skills

Markdown DB Engine 提供两个项目级 Skill，使支持 Skills 的 Coding Agent 可以执行完整工作流，而不要求用户逐条输入 CLI 命令。

mddb-vault-migration

适用于“把这个 Obsidian Vault 迁移成数据库”“分析这个 Markdown 文件夹并生成迁移配置”等请求。Skill 会：

1. 检查路径、版本和可用空间；
2. 执行只读 init scan；
3. 根据用户业务含义分析并编辑 Config，而不是直接把目录名当成 Collection；
4. 执行 init preview 并展示 eligible、pending 和资源摘要；
5. 只有用户明确确认 Plan、Database 和 Backup 路径后才执行 init apply；
6. 验证 Runtime、Based Workspace、资源引用和 Remote Merge。

未经明确确认，Skill 不会执行 Apply，也不会读取范围之外的个人文件。

mddb-app-builder

适用于“用这个 mddb Database 搭建网站/API/知识库应用”等请求。Skill 会检查 Schema 和运行方式，选择 Embedded 或 Remote，创建连接与 Repository 边界，并验证 Query、Mutation、Writer 生命周期和测试。

如果 Local Server 已经运行，Skill 使用 Remote SDK，避免第二个 Embedded Writer 触发 WRITER_LOCKED。

安装

npm 包会在 skills/ 中携带两个 Skill 源目录和可安装 .skill 产物。支持本地 Skill 目录的 Agent 可以把目标目录复制到自己的 Skills 路径；具体路径取决于 Agent 产品。安装以后，可以直接使用自然语言描述源文件夹、目标 Database 和应用需求。

安全确认点

以下操作必须停下来让用户确认：迁移 Apply、覆盖式业务选择、生产 Credential 创建、外部网络监听、正式部署和不可逆删除。Scan、Preview、Schema 检查、Query 和临时目录测试可以自动执行。

Skill 发现 pending、Schema 歧义、资源缺失、Writer Lock 或 Credential 不足时，会说明具体对象和恢复方式，不会隐藏问题后继续发布。