fancydirty/mediary-scout

clawd-media-track 技能

首要操作（强制）

在进行任何 clawd-media-track 推理或工具使用之前：

1. 读取 references/00-bootstrap-init.md
2. 检查 Bootstrap 是否完成
3. 如果 Bootstrap 未完成，则保持初始化模式，不要进入 Type 1 / 2 / 3
4. 如果 Bootstrap 已完成，则读取 references/01-environment-contract.md
5. 读取 references/02-global-constraints.md
6. 读取 references/03-methods-reference.md
7. 确定任务是 Type 1、Type 2 还是 Type 3
8. 读取匹配类型的检查清单
9. 输出当前检查点，格式为 [Type X - Step N]
10. 在执行任何可能产生副作用的操作前停止并等待用户确认

请勿：

• 跳过强制参考文档
• 猜测任务类型
• 在查询完成/重试之前声称“无资源”
• 在未获得用户明确确认的情况下执行转移/创建/删除/标记操作
• 跳过操作后验证

关键安全说明

如果使用不当，该系统可能会对 115 进行破坏性或速率敏感调用。

请按顺序阅读参考文档，并遵循当前任务类型的检查清单。 不要随意偏离它们。

特别是：

• 目录目标来自环境支持的 CID 配置，而非猜测。
• flatten_directory() 仅对最终着陆目录有效：
  • 电影叶目录，直接位于 MOVIES_CID 下
  • 季叶目录，以 Season <number> 结尾
• 根目录/媒体/类别目录是受保护的，绝对不能用作 flatten 目标。
• list_files() 默认是浅层扫描。出于安全原因，对受保护目录的递归扫描被阻止。
• 如果某个方法引发 SAFETY_VIOLATION，请停止并报告确切的目标/路径，而不是通过猜测重试。
• 代码级的防护措施是后备保障，不能替代阅读检查清单和选择正确目标。

此技能为渐进式加载而拆分。 只读取所需内容，但绝不要跳过当前任务类型所需的安全规则。

强制阅读顺序

对于任何 clawd-media-track 任务，请按此顺序阅读：

1. references/00-bootstrap-init.md（Bootstrap 第 1 步和第 2 步的初始化门控）
2. references/01-environment-contract.md（Bootstrap 后的必需配置契约）
3. references/02-global-constraints.md（硬性安全规则 + 执行协议）
4. references/03-methods-reference.md（仅允许的模块方法）

然后根据任务类型进行路由：

• Type 1（一次性获取：电影/完整剧集）：读取 references/05-type1-checklist.md
• Type 2（跟踪初始化：进行中/未完成）：读取 references/06-type2-checklist.md
• Type 3（定时监控 / cron）：读取 references/07-type3-checklist.md

在需要时读取附加参考文档：

• 错误处理、重试、去重、季拆分策略：references/04-error-and-dedup-rules.md
• 目录结构和常见错误：references/08-directory-and-mistakes.md

不可妥协的规则（始终强制执行）

• 必须遵循：每个关键操作前遵循证据 → 推导事实 → 决策的流程
• 必须使用 .each() 处理受保护集合；不得对它们进行切片/抽样/取前 N 个
• 不得使用胶水脚本、正则辅助工具或临时字符串解析来构建决策逻辑
• 必须执行 Type 3 第 3b 步（缺失 vs 已有覆盖分支），不得跳过
• 必须绑定传输 URL 一次，并通过绑定变量执行；不得在决策和传输之间重新提取
• 必须通过重新读取检查来验证副作用（传输/删除/标记/创建）
• 必须将任何跳过规则视为任务失败并如实报告

如果违反任何硬性规则，停止并报告失败，而不是随机应变。

执行上下文

• 项目目录：技能仓库根目录
• Python 运行时：./.venv/bin/python
• 认证/配置：构造函数读取环境支持的配置；不要在技能中硬编码 cookie、token、base URL 或 CID

文件映射

• references/00-bootstrap-init.md
• references/01-environment-contract.md
• references/02-global-constraints.md
• references/03-methods-reference.md
• references/04-error-and-dedup-rules.md
• references/05-type1-checklist.md
• references/06-type2-checklist.md
• references/07-type3-checklist.md
• references/08-directory-and-mistakes.md

迁移说明

本次重构保留了原始的过程性内容，但为了可靠性和上下文效率，将详细材料路由到参考文档中。