用途：编写或修复 Coral source spec，使其可通过 coral source lint <path> 校验、通过 coral source add --file <path> 加载，并能用 coral sql 查询。默认面向外部开发者生成独立 YAML 文件；仅在明确编辑 Coral 仓库时改用仓库布局，将社区 source 写到 sources/community/<name>/manifest.yaml，核心 source 仅在有意改动内置 source 时写到 sources/core/<name>/manifest.yaml，并补充代表性 test_queries。
主要能力：定义 source 元数据、backend、base URL 或文件位置、auth、变量与 secrets、凭据获取方法（含 OAuth 的设备码、授权码与客户端凭据流程）、tables、表函数、filters、响应提取、分页和类型化列；通过 coral.tables、coral.table_functions、coral.columns、coral.filters、coral.inputs 检查暴露结构。元数据查询建议加 LIMIT/OFFSET，避免无界读取。
使用方式：先写小规模表和少量列，用 coral source lint <path> 早期校验；独立 spec 用 coral source add --file <path> 加载后再用 coral sql 查询；命名 source 或仓库 source 用 coral source test <name>。coral source add 默认非交互，每个输入从同名环境变量读取，需先导出变量或加 --interactive；OAuth 凭据方式应运行 coral source add --interactive --file <path>。验证分页应实际拉取行，而不仅是 COUNT(*)。
限制：不得编造资料未提供的功能、收费或平台信息；具体 provider API、价格与完整 schema 需以官方文档和 schema 文件为准。OAuth URL 只能模板化 variable 输入，不能引用 secret、filters、函数参数、state 或内联默认值；秘密输入不支持模板。客户端凭据等细节与流程要求以资料描述为准，未提供部分暂未提供。