PSUR-DSUR 智能撰写助手

解决什么问题

在 PSUR/DSUR 撰写自动化中，真正的难点通常不是文本生成本身，而是运行环境不确定、云端受保护内容无法可靠拉取，以及鉴权失败后继续生成导致的越界输出。这个技能把这几件事固化成一条前置流水线：先确认 Python 可用，再完成授权校验，最后只有在拿到云端 protected instructions 后，才允许进入业务流程。

核心能力与关键步骤

• Python 环境检测：任何脚本执行前先静默检测 $PYTHON_CMD。如果 Python 已存在且版本满足要求，直接继续；如果命令存在但版本偏低，或检测不到可用命令，则输出错误报告并中止执行。用户明确提供全路径时，可直接使用该路径，避免因 PATH 配置问题误判。
• Windows 兼容处理：在 Windows 上，python 命令可能触发 Microsoft Store 而不是真正的解释器。技能推荐优先使用 py -3 启动器，或引导用户关闭应用执行别名后重试。
• 授权前置于工作流：本技能是受保护能力，scripts/auth.py 负责本地凭证缓存、WorkBuddy 用户绑定、平台校验与错误信号输出。SKILL.md 明确禁止手动解析 JWT、拼接 AppKey/AppSecret 或自行调用绑定接口。
• 可修复错误与真正失败的区分：AUTH_REQUIRED 与 CREDENTIALS_MISSING 属于首次使用场景，技能应自动发起 connect_cloud_service 获取 JWT，再用 --bind-jwt 写入缓存，而不是停下来打扰用户；AUTH_INVALID / CREDENTIALS_INVALID 则通过重新绑定覆盖失效凭证。
• 鉴权门禁与业务输出互斥：只有重新执行 --ensure 得到 AUTH_OK，并通过 scripts/protected.py 成功拉取 protected instructions 后，才能严格按照返回内容继续。未拿到 protected instructions 时必须停止，不能凭本地提示或历史上下文继续生成。

适用边界与注意点

鉴权失败不应被包装成“稍后再试”。如果绑定后的 --ensure 仍返回非 AUTH_OK，或 --bind-jwt / protected.py 返回业务错误，技能必须立即停止业务推理，并向用户输出中文报告。报告需要同时观察 stdout 信号与 stderr 文本：区分 HTTP 401 / authorization failed 等鉴权问题与 network error 等网络问题，并给出明确的处理步骤。

为避免重复打扰用户，重试上限为 1 次。两次失败说明服务端暂时不可用，应告知用户并停止；不得静默降级，也不得在鉴权未通过时继续产出任何业务结果。另一个实现细节是：服务端 skillCode 使用包内 _meta.json 的 slug（如 BT_247A0CAB），而不是展示名称；缺失该文件时才需要手动传 --skill-code。