跨设备工具开发法

技能简介

一套构建跨设备工具的工程方法论，解决硬编码路径、账户名等导致的移植性问题。源于 OAuth 刷新令牌调试实践，强调”永远不要假设你的设备是唯一设备”。

业务背景

开发团队常因个人电脑与服务器环境差异导致脚本崩溃，本方法论通过识别路径、账户名等变量差异，建立显式配置和自动降级机制，确保工具在任何设备上开箱即用，大幅降低部署调试成本。

落地案例：某工程师编写OAuth令牌刷新脚本时，将本地Mac路径硬编码其中。换到Linux服务器后脚本失效，排查耗时半天。采用本方法后，团队改用显式参数传入、添加Windows/Mac/Linux三端路径检测，并设计

能做什么

• 识别设备间差异变量（路径、账户名、服务名、数据结构）
• 建立验证机制：要求具体的 BEFORE/AFTER 状态对比
• 设计故障模式测试（错误配置、缺失数据、多入口歧义）
• 实现显式优先于隐式、验证先于使用、自动降级链、友好错误提示四大强制模式

使用说明

1. 安装：本技能为方法论文档，无需安装。建议将核心原则纳入团队代码审查清单。
2. 应用三问：写代码前回答——什么在设备间变化？如何证明有效？坏了怎么办？
3. 采用强制模式：
   • 显式指定参数，避免模糊匹配
   • 校验数据结构后再使用
   • 构建配置→常见值→报错的降级链
   • 错误信息包含诊断步骤和修复命令
4. 调试三步法：获取精确数据 → 用具体例子证明 → 立即考虑跨设备场景

输入与输出

见下方输入与输出表格。

风险提示

• 未覆盖所有操作系统差异（Windows 路径分隔符等）
• 降级链可能掩盖真实配置问题
• 详细错误信息可能泄露敏感路径或账户名
• 需要团队纪律保证执行，无自动化强制手段

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tunaissacoding/portable-tools/SKILL.md
来源类型：GitHub 仓库文档