用途：在编码会话结束前，将本次会话产生的持久性仓库知识同步到文档。信息来源为当前对话、当前 git 变更，以及已有的 dev-docs/.md、相关 specs/.md 和 AGENTS.md。该技能面向长期知识，而非变更日志式叙述。
主要能力：按领域更新 dev-docs/ 下的 Markdown 文档（如 reliability、evaluations、annotations、scores、issues、simulations、organizations、projects、users、settings、spans、repositories 等）；将仓库级稳定规则、约定、约束与禁止项写入 AGENTS.md；在功能建设期维护 specs/ 中的临时规格与任务清单，实现稳定后再把持久知识提升到 dev-docs/。
使用方式：先阅读对话，提取持久决策而非仅代码改动；再查看 git status 与 git diff，阅读有领域或架构意义的变更文件，并与现有文档比对；然后分类知识，优先更新已有领域文档，必要时新建；文档应描述变更后应被理解的未来状态，按领域而非提交时间组织，避免“我们改了”“本 PR 中”等变更日志措辞；仓库级规则升级到 AGENTS.md；最后复查文档与代码是否一致，并告知用户改了哪些文档或无需更新。
适用场景：会话引入、删除或澄清了产品行为、领域规则、架构设计、仓库结构、schema/API/存储/查询/生命周期变更，或明确约定、约束与禁止项时；用户明确要求更新文档、同步知识到 dev-docs/、更新 AGENTS.md 或记录设计决策时。
限制：若无持久知识变更，不应仅为总结工作而编辑文档，应说明无需更新。不持久化临时调试笔记、一次性命令、被否决的想法、逐任务变更日志，以及未经用户要求的 TODO 列表。不确定某规则是否为仓库级持久规则时，应先询问用户再编辑 AGENTS.md。