# 故障与降级处理

## 无法访问仓库或文件
- 症状：无法读取目录/文件；无 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`；必要时缩小范围或增加重试间隔。