SuperAPI AI 工具集

linear-migration-deep-dive

通用与其它

查看项目

更新于 10-15 23:27

技能介绍

用途:规划并执行受控的 Linear 工作区数据迁移,适用于从 Jira、GitHub、Asana 等来源迁移 issue。核心原则是选择能保留所需数据的受支持导入器,先在小范围团队试点,验证映射与回滚后再切换。

主要能力与要点:导入需要工作区管理员权限;优先使用专用导入助手,因为它保留更多源数据并可在限定时间内支持批量删除;CLI 导入器用于没有专用助手的来源,且不会保留评论、项目等全部数据。将同一来源重复导入同一团队时,已导入的 issue 会被跳过,除非先删除此前的导入。

认证:个人 API key 仅用于所有者控制的脚本,格式为 Authorization: <API_KEY>;用户委托应用使用带 PKCE 的 OAuth,令牌格式为 Authorization: Bearer <ACCESS_TOKEN>;已批准的自动化可使用已启用的 client-credentials 授权。凭据应存放在服务端经批准的密钥管理器中。

使用方式:先盘点源实体、数量、用户、团队、状态、标签、项目、评论、附件、时间戳与合规约束;有专用助手时优先选用,仅在记录 CLI 无法保留的数据后才使用 CLI;定义确定的用户、团队、工作流、优先级、估算和标签映射及明确排除项;在获批的目标团队中运行小规模试点,校验数量、样本、权限、链接和时间戳;批准切换窗口、源冻结、沟通、重复策略、回滚窗口与责任人;导入后核对数量与抽样语义,保留凭证,并在批准期内保持旧来源只读。

限制与边界:未经责任人明确批准,不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、更改范围或团队访问、创建或修改或归档或删除工作区数据、配置或重新启用 webhook、导入或导出数据、更改角色或 SCIM 或审计流、传输诊断信息、更改付费权益或执行其他生产变更。诊断默认只读。遇到不支持的字段应记录丢失并选择归档或替代迁移路径;用户映射不明确时需责任人确认,不得自动创建或合并身份;试点错误时仅在受支持选项仍存在且获批后删除试点并修复映射;回滚窗口未知时不得切换。输出应包含工作区与团队范围、不含凭据值的认证模式、检查的文件与契约、确切操作名称、收集的证据、验证结果、已脱敏的敏感字段、剩余风险、责任人、批准状态以及回滚或下一步操作。