Skills 识别、依赖与任务失败排查
找到第一个失败阶段并保留证据,安全恢复识别、依赖、资料和计算问题,不覆盖技能、输入或旧结果。
先诊断第一个失败阶段。下载、技能发现、资料可读和计算完成是不同结果,前一步成功不能认证后一步。
失败映射
| 现象 | 先检查 | 安全下一步 |
|---|---|---|
| SHA-256 不同 | 所选宿主/版本和实际 ZIP | 停止,取得匹配发行 |
| 技能未出现 | 层级、SKILL.md、名称 | 修正所选目录,刷新会话 |
| 已有同名 | 清单版本和本地修改 | 备份到扫描目录之外 |
| 缺 Python,包括文本方法 | S01/S02/S04/S05 均需 Python 3.12 | 停止固定工具执行,另按说明建独立环境 |
| PDF 不可读 | 数字和表格列顺序 | 提供有权使用的文本 |
| 缺数据或确认 | 清单、日历、真实确认 | needs-input,列准确缺项 |
| 额度/网络失败 | 宿主错误 | 保存输入和未完成状态 |
| 数值不同 | 首个不同的每日/事件行 | 对照规则、数据、版本和时序 |
官方发现机制见 OpenAI和 Claude Code,核验日 2026-10-30;这些不能代替具体包验收。
发现样例
S01 在 Codex 的关键文件为 %USERPROFILE%\.agents\skills\cotrading-earnings-review\SKILL.md,Claude Code 为 %USERPROFILE%\.claude\skills\cotrading-earnings-review\SKILL.md。多套版本或压缩包目录时,可能复制错层级。同名目标已存在,先保留版本与本地改动,不能直接覆盖。
使用宿主对话中的选择器。把斜杠或美元技能名粘到 PowerShell 不算调用;当前刷新机制没加载更新时重开会话。
数据与依赖样例
四日合成 ETF 不能跑 63 间隔动量,后者至少需 64 个完整观测。缺一日 ETF_B 应指出具体缺口并停止;前填或删资产改变实验,不是修复。
当前 0.1.0 A 批 S01/S02/S04/S05 均需 Python 3.12,包括财报、论点和规则整理的文本任务。包内固定工具仅用标准库、不联网,但不表示远程模型处理离线。py -3.12 --version 只检查可用性。安装前记录可执行环境与错误;缺失或版本不符时停止固定工具任务,保留输入,另按说明准备独立环境。不能用模型心算冒充工具执行。教学工具不需安装第三方 Python 包,不改全局设置、不绕安全控制、不自动提权或跑无关批量安装器。OCR 等额外解析器各有要求。
保留真实运行状态
每次尝试新建目录。needs-input 表示待补资料或确认;failed 表示执行/工具失败;completed 只表示实际完成的有限范围。不能把旧报告当新运行,更不能计算失败后伪造正常输出。局部复查必须列未答问题。
反馈、更新与卸载
反馈提供方法版本、宿主/版本、系统、失败阶段和脱敏错误,默认不发密钥、持仓或研究全文。更新明确选版本并保留本地改动和旧输出;卸载只移除选中安装目录,不删独立研究目录或其他技能。
清洁首次任务返回 Codex CLI或 Claude Code。免费包不代表免费模型额度或付费来源权限。