翔哥方法论 STPES 框架

要解决的问题

在实际工程协作里，方法论类技能最容易踩的坑不是“没有方案”，而是脚本在没有可用 Python、没有授权凭证、或云端受保护指令没拿到的情况下继续推理。F-02 这类受保护 Skill 一旦跳过环境检测或授权门禁，后续业务输出会建立在猜测上。

核心能力与关键步骤

• 静默环境检测：任何 Python 脚本执行前，先检测 PYTHON_CMD。成功且版本可用，直接执行 scripts/auth.py；失败才报告。
• Windows 排障：python 可能打开 Microsoft Store，优先使用 py -3，或关闭应用执行别名。
• 授权检查：由 scripts/auth.py 处理本地凭证缓存、WorkBuddy 用户绑定、平台校验与错误信号；不要手动解析 JWT、拼接 AppKey/AppSecret 或调绑定接口。
• 错误分级：AUTH_REQUIRED、CREDENTIALS_MISSING 是首次绑定，可自动继续；AUTH_INVALID、CREDENTIALS_INVALID 先尝试用新 JWT 覆盖缓存；绑定后再失败才是真正失败。
• 绑定流程：主动调用 WorkBuddy connect_cloud_service 获取 JWT，不得等待、跳过或交给用户；绑定成功后重新 --ensure，拿到 AUTH_OK 才拉取云端 protected 内容。
• 受保护内容门禁：只有 scripts/protected.py 返回 protected instructions，才能严格按返回内容继续；否则停止，不凭本地提示或历史上下文生成。

适用边界与注意点

• 鉴权未通过时禁止产出业务结果，二者互斥。
• 报告失败时同时观察 stdout 信号与 stderr 文本；重试上限 1 次，再次失败即告知数据服务暂时不可用并停止。
• 不得向用户展示或提及 AppKey/AppSecret 明文，也不得把密钥拼进命令、环境变量或回复。