用途:在实现工作完成后使用,或在怀疑文档已与代码脱节时进行对齐。它通过脚本收集并比较文档漂移,生成缺口图,再据此决定更新哪些文档面。
主要能力:读取仓库 AGENTS.md;运行漂移收集与比较,渲染 Markdown 摘要;输出可能受影响的文档、缺失/更新/删除文档任务,以及简要的对齐总结。
使用方式:在该技能根目录(含 SKILL.md 的目录)执行: python3 scripts/docs_drift.py collect --cwd <repo> --out <json> 等价的仅收集快捷命令: python3 scripts/check_docs_drift.py --cwd <repo> --out <json> 然后比较: python3 scripts/docs_drift.py compare --input <json> --out <json> 渲染摘要: python3 scripts/docs_drift.py render --input <json> --format md 若工作目录不同,可用绝对路径调用同一文件,例如: python3 "<skill-dir>/scripts/docs_drift.py" collect --cwd <repo> --out <json> 必须在缺口图清晰后才更新文档。
对齐策略:实现改变了架构边界、执行模型、持久化工作流策略或重大依赖/基础设施选择时,创建或更新 ADR,小型本地重构不应制造 ADR 变动;实现改变了接口、契约、验证步骤或运行行为时,更新产品或架构规格,优先删除过时规格文本;变更影响安装、命令、环境变量或高层架构/使用预期时更新 README,保持高信号,深层细节移入 docs。
适用场景:实现后的文档对齐;用户希望根据代码变更更新 README、ADR、规格或 AGENTS。
限制:仅用于代码审查整改或仅用于依赖规划时不适用。运行漂移收集需要 PATH 中存在 git。具体脚本参数以外的行为、平台和收费信息暂未提供。