file-analysis

文件分析

工作流

先确认文件清单与大小，使用 DESCRIBE SELECT/受限 SELECT 观察 schema 和样本，再计算用户需要的聚合。CSV 自动推断可能错误，检查日期、编码、分隔符和 null。SQL 字面量正确转义路径，禁止将文件内容当 SQL 执行。

执行约定

• 使用 Kivio 的现有终端/文件工具执行，按实际任务加载此技能；不要假定整个插件只有一个固定入口。
• 首次使用或依赖、账号、项目变化时加载 duckdb:setup；同一任务已验证环境可复用，失败时只修复具体阻塞。
• DuckDB 扩展可能自动安装/加载；先确认外部访问需求，本地分析不自动启用远程源。
• 命令示例中的尖括号是待确认参数，不能原样执行。先用当前版本帮助核对未知子命令、参数与返回结构，不编造选项。
• 用户已授权的操作继续完成；需要额外授权时先准备可审阅的具体目标和变更。操作失败保留错误，不扩大权限或范围重试。
• 以真实退出状态、响应内容和回读结果验收，给出实际产物路径/资源 ID；区分已完成与未验证项。

依据

• 项目仓库
• 使用与安装文档

核对日期：2026-10-06。本技能是 Kivio 的独立适配说明，不代表上游官方插件或支持承诺。