用途:当仓库行为发生变化、面向 Claude 的文档过时或不完整时,用此技能系统性更新仓库文档,覆盖 README.md、CLAUDE.md、AGENTS 路由、CONTRIBUTING 及 docs 目录下的专项文档。
主要能力:先审阅已实现的变更与完整 diff,将事实映射到受影响文档;按“具体到一般”的顺序更新,即 API/数据库规范 → 架构与技术栈 → CLAUDE 指令 → README → 项目概览;核对链接、路径、命令、计数与发布说明;发现机器输出与文档中的计数或命令不一致时停止并重新核对。
使用方式:输入需要已实现的变更与完整 diff,以及受影响的文档与路由;若变更或文档不可访问,则只更新已验证事实,其余标注“未评估”,不声称全仓一致。编辑仅在父任务授权文档更新时允许;发布、对外消息、删除与发布声明需明确授权与验证证据。
适用场景:新增或移除功能、架构或设计模式变化、依赖或技术栈更新、API 端点或数据库模式变化、目录结构调整、开发流程变化。不适用于纯拼写修正、代码注释、未合并的 WIP 功能,或与仓库文档无关的工作。
限制与反模式:避免只改 README 而遗漏 AGENTS 路由;避免描述未实际运行的校验器;避免把同一长流程复制到多个路由文档,应保留一处并链接;避免在文件系统变化后保留过时的技能计数;避免把破坏性变更说成无害,需明确迁移或兼容后果。文档应保持事实、最新,并与实际文件路径和工作流一致。