故障与降级处理

无法访问仓库或文件

症状：无法读取目录/文件；无 tree/README/依赖信息。
诊断：权限不足或未提供素材。
处理：声明 strict 降级；仅输出模板骨架，所有事实标【待确认】；列出证据采集命令（tree/README/依赖/配置/API）。

文档与代码冲突

症状：文档端口/字段/错误码与实现不一致。
诊断：历史文档未同步。
处理：以代码/配置为准更新；在 Changelog 记录冲突与修复原因；若行为变更建议补 ADR；无法确定时标【待确认】并给验证命令。

仓库过大或范围不清

症状：输出超长或扫描耗时。
诊断：目录/模块过多，未限定范围。
处理：按 prefer_priority 分批；声明本次覆盖范围；优先 guides/integrations；余量列入后续批次计划。

敏感信息暴露风险

症状：配置包含 token/password/key。
诊断：直接读取 .env / 配置文件。
处理：文档仅写变量名与获取方式，值用占位符；提示使用 vault/secret manager；必要时创建安全整改/incident 记录。

自动化采集失败

症状：使用 skill-seekers 抓取外部文档/仓库失败。
诊断：配置不当或站点屏蔽。
处理：检查 config/URL；改用本地 git clone + 手工 rg；必要时缩小范围或增加重试间隔。