患者教育文章生成

解决什么问题

医疗团队经常需要批量产出患者教育内容：疾病介绍、用药须知、术后护理、检查准备等。这类文章的难点不在于“写出来”，而在于：

• 内容需要符合平台规范，不能随意生成
• 不同渠道（公众号、小程序、App）各有模板与合规要求
• 授权与凭证管理散落各处，容易中途打断流程

这个 Skill 把 环境准备 → 云端授权 → 拉取受保护指令 → 生成文章 串成一条固定流水线，让生成环节拿到的是服务端下发的最新写作规范，而不是本地缓存的历史版本。

核心能力与关键步骤

1. Python 环境检测（最先执行）

任何脚本调用前先静默检测：PYTHON_CMD 有值且版本达标就直接执行，检测不到才报告。Windows 上 python 命令可能打开 Microsoft Store，推荐用 py -3 启动器；用户若提供全路径，直接采用。

2. 授权门禁

scripts/auth.py 统一处理凭证缓存、WorkBuddy 用户绑定与平台校验，关键信号包括：

• AUTH_REQUIRED / CREDENTIALS_MISSING：首次使用、本地无凭证，属于可自动修复，不应停下来报告
• AUTH_INVALID / CREDENTIALS_INVALID：凭证过期或失效，尝试自动修复
• 绑定后仍非 AUTH_OK：才是真正的失败

3. 绑定流程

收到可修复信号时，主动调用 WorkBuddy 的 connect_cloud_service 工具获取 JWT，再执行 --bind-jwt 完成绑定。不要手动解析 JWT、拼接 AppKey/AppSecret 或自行调用绑定接口。

4. 拉取受保护指令

只有 scripts/protected.py 成功返回 protected instructions 后，才按返回内容生成文章。未拿到指令必须停止，不得凭本地提示或历史上下文继续。

适用边界与注意点

• 鉴权与输出互斥：鉴权失败时严禁产出业务结果，更不能“先给文章、再补一句鉴权有问题”
• 错误必须可见：绑定流程执行后仍失败，按模板告知用户发生了什么、需要做什么，原样转述 stdout 信号与 stderr 关键行
• 重试上限为 1 次：CREDENTIALS_MISSING、CREDENTIALS_INVALID、HTTP 401/403 或签名类错误出现时重新走一次绑定；两次失败说明是服务端问题，告知“数据服务暂时不可用”后停止
• 密钥不外泄：AppKey / AppSecret 明文不得出现在业务命令、环境变量或回复中
• 依赖 Python 环境：没有可用解释器时 Skill 无法运行，需要用户先安装或提供全路径