用途：把一次会话中的工作转化为未来维护者（从未参与对话、只读仓库）能直接接手的内容，目标是让维护者冷启动即可知道改了什么、为什么改、下一步做什么、如何部署到生产。适合在结束某个功能或里程碑、长期暂停项目前、把仓库交接给他人或未来的自己、以及任何触及生产配置/基础设施/部署方式的变更之后运行。
主要能力与流程：新建文件一律放在 docs/ 下，仓库根目录只保留原有文件。步骤一，梳理会话中不在 diff 里的内容：做过的决策、被否决的备选方案及原因、过程中发现的约束，逐条列出并标注归属（架构决策、顶层文档、生产、后续）。步骤二，为影响系统构建方式或原因的候选补写或更新 docs/adr/ 下的 ADR；ADR 的具体写法可交给已安装的 domain-modeling 技能，没有则直接写。步骤三，核对 README.md 与 CONTEXT.md（多上下文仓库为 CONTEXT-MAP.md）是否仍准确描述系统，只改已过时或缺失的部分。步骤四，若本次触及生产环境相关配置、基础设施、运行时依赖或部署步骤，记录生产现状与部署该变更的确切步骤，更新已有部署文档或新建，并对照本次变更确认其为最新。步骤五，编写或更新 docs/TODO.md，说明已完成、待办及优先级顺序，指向上述 ADR 和文档而非复述。
另建议：对新写的文档做 secrets 扫描，避免部署文档中出现真实凭据；这些新文件本身仍需提交，本技能只写文档，不执行暂存或提交。
限制与边界：本技能是“维护者就绪”文档流程，不替代完成度门禁（completion-gate）判断工作是否可交付，应在门禁通过后运行；不负责提交（由 git-helper 等提交工作流处理）；不产出面向下一个 agent 的临时会话交接笔记（由对话交接技能处理）。ADR、CONTEXT.md 等具体写作机制依赖相应领域建模技能，未安装时可直接撰写。资料未提供具体安装命令与收费信息。