钉钉技能创建器(Dingtalk Skill Creator) 将一个钉钉 API 领域封装成可复用技能的标准化流程。 每一步都必须实际完成且通过验证后才能进入下一步,不得跳过。 --- 流程总览 关键原则 :测试全用 Python(无 .sh 脚本)。 阶段 2 和阶段 3 的 必须实际运行并全部绿色后,才能进入阶段 4。 新 API 优先 + token 不兼容原则 :钉钉平台存在新旧两套 API 体系,必须优先使用新版,且两种 token 不可混用 : - 新版(推荐) : → 返回 + ,配套 接口,放 Header - 旧版(避免) : → 返回 ,配套 接口,放 URL 参数 - 互不兼容 :新版 token 用于旧版接口、或旧版 token 用于新版接口,均会报 401/403,且错误信息不会说明是 token 类型错误,难以排查 - 唯一例外 :userId → unionId 转换( )目前无 v1.0 等效接口,仍需旧版 token;此为已知例外,OLD TOKEN 仅在转换这一步使用,不得传递给其他 API 调用 dt helper.sh :每个 skill 的 封装了 token 获取与缓存、userId↔unionId 转换、配置读写等基础能力。在 bash 脚本 (如执行脚本)中直接调用即可; Python 测试(阶段二/三) 仍用内联 request…