CocoIndex 是一个用于声明式增量数据流的工具：应用声明源状态、转换/处理组件与目标状态，随后增量传播变更。它维护自身内部状态数据库，但所选目标（如关系数据库、向量库、文件树、图存储）仍是独立系统。
用途与主要能力：本技能用于在构建或排查增量 Python 数据流时操作 cocoindex-io/cocoindex，涵盖源、转换、目标、应用状态与 CLI 的声明和检查；提供预检脚本核对固定来源与文件哈希，帮助识别数据流各环节与副作用。
使用方式：从技能仓库根目录运行 preflight.py（可带 --repo 指向绝对、非符号链接的上游检出），不带 --repo 仅做清单。检查 cocoindex --help 与 cocoindex update --help 以确认实际 CLI 契约。典型流程为先预检、梳理数据流、申请批准，再安装与运行；示例包括 pip install -U cocoindex、cocoindex update --preview main.py 以及经批准后 cocoindex update main.py。
适用场景与限制：适用于声明式数据流的设计、变更传播验证与小规模夹具测试。执行 --full-reprocess 可能昂贵（绕过记忆化并重跑嵌入等外部调用）；--reset 先执行 drop，可能删除目标行/表并清空内部数据库，不可作为通用排障手段。预检哈希仅覆盖选定固定文件，不代表 Git HEAD、整棵树、依赖状态或运行时；辅助脚本支持 POSIX Linux/macOS/WSL2 上的 Python 3.10+，在无法安全遍历目录时失败关闭，包括不支持的 Windows。上游延迟、新鲜度、令牌与缓存宣称须绑定具体基准与环境，不应作为普遍保证。