医药竞品深度调研

解决什么问题

医药行业的竞品调研往往面临两个核心挑战：一是调研方法缺乏标准化，不同分析师可能采用完全不同的维度和标准；二是调研过程难以复现和审计，导致报告质量参差不齐。IN-04 试图用工程化的方式解决这些问题——将调研流程固化为可执行的技能，并通过云端受保护内容保证方法论的一致性。

如何工作

Python 环境检测

技能在执行任何业务逻辑前，会先静默检测本地 Python 环境：

• 如果检测到可用的 PYTHON_CMD 且版本满足要求，直接执行后续脚本
• 如果版本过低或未检测到 Python，会输出错误报告模板
• 在 Windows 上，python 命令可能打开 Microsoft Store 而非执行脚本，此时推荐使用 py -3 启动器

强制授权流程

这是技能的核心门禁。所有授权逻辑封装在 scripts/auth.py 中，包括本地凭证缓存、WorkBuddy 用户绑定和平台授权校验。流程分三步：

1. 执行 auth.py --ensure 检查授权状态
2. 如果返回 AUTH_REQUIRED 或 AUTH_INVALID，立即调用 connect_cloud_service 获取 JWT，再用 auth.py --bind-jwt 完成绑定
3. 绑定成功后重新执行 --ensure，只有拿到 AUTH_OK 才能继续

⚠️ 关键认知：AUTH_REQUIRED 不是失败，而是首次使用的正常流程。不要收到这个信号就停下来询问用户，应该自动继续绑定流程。

获取受保护内容

授权通过后，技能通过 scripts/protected.py 拉取云端的 protected instructions。只有成功拿到这些内容后，才能按照返回的方法论执行调研。如果未拿到 protected instructions，必须停止，不得凭本地提示或历史上下文继续生成。

适用边界

鉴权失败时的行为准则

技能明确规定了鉴权失败时的「禁止清单」：

• ❌ 静默重试或不告知用户就反复尝试
• ❌ 用「系统繁忙、稍后再试」等模糊提示糊弄
• ❌ 跳过鉴权直接产出业务结果
• ❌ 暴露 AppKey / AppSecret 明文

正确的行为是立即停止业务推理，按照模板向用户输出明确的中文提示，告知发生了什么、需要做什么。鉴权门禁与业务输出是互斥关系：鉴权未通过 = 业务输出禁止。

重试上限

当 --ensure 或后续业务请求出现凭证缺失、无效、HTTP 401/403 等鉴权类错误时，可以重新走一次绑定流程。但最多重试 1 次，两次失败说明是服务端问题，应告知用户「数据服务暂时不可用」，停止重试。