Files
vibe-coding-cn/skills/ddd-doc-steward/references/troubleshooting.md
T
tukuaiai 5f8b0776e0 refactor: skills 目录扁平化,移除分类子目录
- 将 00-元技能、01-AI工具、02-数据库、03-加密货币、04-开发工具、05-生产力 下的技能移至 skills/ 根目录
- 更新 skills/README.md 使用表格进行说明性分类
- 更新 AGENTS.md 目录结构说明
2026-02-12 01:57:48 +08:00

1.4 KiB

故障与降级处理

无法访问仓库或文件

  • 症状:无法读取目录/文件;无 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;必要时缩小范围或增加重试间隔。