用途：在开发阶段结束、分支完成，或任何改动契约、API、领域结构的工作之后，检查并更新项目上下文文件（CLAUDE.md 或 AGENTS.md），避免文档过期。
主要能力：先检测仓库格式（根目录是否存在 AGENTS.md）；AGENTS.md 规范仓库需更新 AGENTS.md 并创建配套 CLAUDE.md，CLAUDE.md 规范仓库直接更新 CLAUDE.md。通过 git diff 识别变更，映射到对应上下文文件，核对 Contracts、Dependencies、Invariants、Key Decisions 等章节，更新新鲜度日期并提交。
使用方式：先执行 ls -la AGENTS.md 2>/dev/null 与 ls -la CLAUDE.md 2>/dev/null 检测格式；用 git diff --name-only <base-sha> HEAD 和 git diff <base-sha> HEAD --stat 查看变更；更新后用 date +%Y-%m-%d 设置日期，并以 git add 与 git commit -m "docs: update project context for <branch-name>" 提交。AGENTS.md 仓库的配套 CLAUDE.md 内容为：Read @./AGENTS.md and treat its contents as if they were in CLAUDE.md。
适用场景：新增领域或模块、API/接口变更、架构决策、不变量变化、依赖变化时更新；纯重构、无契约变化的缺陷修复、测试新增、注释文档改动不更新。
限制：依赖子技能 writing-claude-md-files 完成实际创建与更新；领域文件建议控制在 100 行以内；更新前必须先读取现有文件，尤其 AGENTS.md。