用途：把仓库文档漂移（drift）转成有据可依的对齐计划，并在需要时执行文档与注释修订，使代码、工作流与文档重新一致。
主要能力：清单化仓库文档面（根目录与就近 AGENTS.md、README 与文档索引、ADR/规格/运行手册目录、需求与策略文档、近期变更文件的注释与 docstring）；对比已实现行为、当前脚本命令、架构与文件归属、验证流程，构建漂移映射；对每个发现分类为就地更新、新建权威文档、标记被取代、删除过期指引或保持不变；在确认现有权威文档不覆盖该关注点前不新建文档；为未来会话产出可勾选的执行产物。
使用方式：先归一化任务（仅计划、先计划后执行或仅审计），仓库有未提交变更时用 git status --short 与 git diff --name-only 锚定当前工作树，再盘点文档面并路由到合适的支持技能与插件。核心契约要求从仓库现实出发、一个关注点只保留一个权威文档面、就地更新而非重复新建文档。隐藏工作产物默认放在 .agents/<skill-name>/YYYY-MM/MM-DD/NN/，可用脚本脚手架： python3 scripts/new_repo_docs_align_artifact.py --dir <repo-root> --artifacts drift-map,reviewed-surfaces,exec-plan,retrospective 其中 --artifacts 只生成需要的文件，--force 仅在有意刷新已有产物时使用。完成前需逐项验证每个文档变更对应具体文件或已确认缺口，并重新通读被改动的 AGENTS.md，确认其命令与关卡仍有效。
适用场景：大型变更后、文档与实现出现漂移时、用户要求 docs-align 或 AGENTS 相关处理、需要规划或治理文档结构时。
限制：未提供的收费、价格、平台与具体效果信息暂未提供；证据缺失或结论不确定时标记为 UNVERIFIED；仓库证据无法解决的权威性、范围或产物决策才向用户提问，且一次只问一个问题。