技能介绍

它解决什么问题

当你要把技术文章发布到 Dev.to 时，常见流程是打开网页、切编辑器、粘贴 Markdown、填标签、再反复核对草稿。oo-devto 把这类操作收进命令行工作流：在一个已经接入 OOMOL 的环境里，你可以直接通过 oo CLI 读取文章、写入新稿、更新已发布内容，而不用在浏览器和本地工具之间来回切换。

技能如何工作

这个技能的核心是调用 Dev.to connector，并通过 OOMOL 在服务端注入凭据，因此本地不需要保存或传递原始 API token。使用前先确认 oo CLI 已安装、已登录，并且 Dev.to 已经连接完成。之后不需要主动执行登录流程，只要直接运行动作即可。

推荐的顺序是先读契约，再构造请求体：

先执行 oo connector schema 获取某个动作的权威输入输出 schema。
根据 schema 准备 --data，可以传 JSON 字符串，也可以传 @path/to/file.json。
执行动作后，从 meta.executionId 中读取执行 id，方便追踪这次调用。

可用动作覆盖 Dev.to 的常见读写场景：

读取类：get_article、get_article_by_path、get_current_user、get_organization、list_articles、list_latest_articles、list_my_articles、list_organization_articles、list_tags、list_videos。
写入类：create_article 和 update_article。

如果你准备发布一篇新稿，可以先用 list_my_articles 查看已有文章的状态，再用 create_article 写入；如果只是修订标题或正文，update_article 更合适。需要确认某个文章是否已经存在时，get_article_by_path 可以按 username 和 slug 定位，避免重复创建。

适用边界与注意点

读取和列表类动作可以直接运行；create_article 和 update_article 会改变 Dev.to 上的真实内容，执行前需要和用户确认目标对象、最终字段以及预期效果。凭据由 OOMOL 托管，适合自动化场景，但并不改变 Dev.to 平台自身的权限边界，账号能看到和能写的内容仍然取决于连接账号的权限。

如果命令因为未登录、连接过期、scope 缺失或凭据失效而失败，再进入一次性的初始化流程；这些步骤只应在对应错误出现时执行，而不是每次调用前都重复。