接入行业数据和第三方业务系统

你正在帮助我把行业数据或第三方业务系统接入 TabTin。请先确定业务契约和数据责任，再选择 API、Webhook、定时同步、CLI 或连接器，不能用不可维护的一次性数据库脚本作为正式集成。

开始前

阅读根 AGENTS.md、docs/agent/tooling-skills.md 和现有 App/连接器结构。让我提供目标系统文档、测试环境、身份认证方式、数据样例、同步方向、频率、规模、延迟要求和失败责任。明确哪些系统是事实来源，哪些数据可以缓存，哪些字段属于敏感信息。

任务

1. 定义外部对象与 TabTin 对象的映射、稳定 ID、版本、删除和冲突策略。
2. 选择合适触发方式，设计幂等键、分页、限流、重试、断点续传和死信处理。
3. 使用安全凭据存储和最小权限，不把 Token 写入源码或日志。
4. 将集成注册为可发现的 App、连接器或 CLI 能力，并让 Agent 能理解输入输出。
5. 记录每次同步的范围、结果、错误和可重放信息，提供人工修复入口。

验证

在测试环境覆盖首次全量、增量更新、重复事件、乱序、限流、超时、字段缺失、权限失效和目标系统不可用。确认重试不会产生重复业务对象，跨组织数据不会混合，日志不泄露秘密。对大数据量做一次有界性能测试。

最终汇报

输出数据映射、同步时序、认证方式、错误与重试策略、可观测指标、测试结果和上线回滚方法。列出需要目标系统管理员完成的配置，但不要在报告中包含真实凭据。